接口地址:https://vsp.allinpay.com/apiweb/tranx/query
测试地址:https://syb-test.allinpay.com/apiweb/tranx/query
使用场景:该接口提供交易查询,商户可以通过查询接口主动查询订单状态,完成下一步的业务逻辑。
需要调用查询接口的情况:
◆ 当商户后台、网络、服务器等出现异常,商户系统最终未接收到支付通知;
◆ 调用支付接口后,返回系统错误或未知交易状态情况;
◆ 调用统一被扫接口后,返回交易状态码trxstatus为2000时;
◆ 调用关单或撤销接口API之前,需确认支付状态;
备注:如果撤销交易异常,请查询原支付订单状态
请求参数:
参数 | 参数名称 | 取值 | 可空 | 长度 | 备注 |
---|---|---|---|---|---|
orgid | 集团/代理商商户号 | 是 | 15 | 共享集团号/代理商参数时必填 | |
cusid | 商户号 | 实际交易商户号 | 否 | 15 | |
appid | 应用ID | 平台分配的APPID | 否 | 8 | |
version | 版本号 | 接口版本号 | 是 | 2 | 默认填11 |
reqsn | 商户订单号 | 商户的交易订单号 | 否 | 32 | |
trxid | 平台交易流水 | 支付的收银宝平台流水 | 是 | 20 |
reqsn和trxid必填其一 建议:商户如果同时拥有trxid和reqsn 优先使用trxid |
randomstr | 随机字符串 | 随机生成的字符串 | 否 | 32 | |
signtype | 签名类型 | 否 | 8 |
RSA SM2 |
|
sign | 签名 | 否 | 32 | 详见安全规范 |
响应参数:
字段ID | 字段名称 | 取值 | 可空 | 长度 | 备注 |
---|---|---|---|---|---|
retcode | 返回码 | SUCCESS/FAIL | 否 | 8 |
此字段是通信标识,非交易结果 交易是否成功需要查看trxstatus来判断 |
retmsg | 返回码说明 | 是 | 100 | ||
以下信息只有当retcode为SUCCESS时有返回 | |||||
cusid | 商户号 | 平台分配的商户号 | 否 | 15 | |
appid | 应用ID | 平台分配的APPID | 否 | 8 | |
trxid | 交易单号 | 平台的交易流水号 | 否 | 20 | |
chnltrxid | 支付渠道交易单号 | 如支付宝,微信平台的交易单号 | 是 | 50 | |
reqsn | 商户订单号 | 商户的交易订单号 | 否 | 32 | |
trxcode | 交易类型 | 交易类型 | 否 | 8 | 见附录-交易类型 |
trxamt | 交易金额 | 单位为分 | 否 | 16 | |
trxstatus | 交易状态 | 交易的状态 | 是 | 4 |
见附录-交易返回码说明 如果trxstatus为空,则交易正在处理中 尚未完成 |
acct | 支付平台用户标识 |
JS支付时使用 微信支付-用户的微信openid 支付宝支付-用户user_id |
是 | 32 | 如果为空,则默认填000000 |
fintime | 交易完成时间 | yyyyMMddHHmmss | 是 | 14 | |
randomstr | 随机字符串 | 随机生成的字符串 | 否 | 32 | |
errmsg | 错误原因 | 失败的原因说明 | 是 | 100 | |
cmid | 渠道子商户号 | 是 | 32 | 限微信/支付宝交易响应 | |
chnlid | 渠道号 | 是 | 32 | 限微信交易响应 | |
initamt | 原交易金额 | 否 | 15 | 与请求字段trxamt值一致 | |
fee | 手续费 | 是 | 15 | 单位:分 | |
chnldata | 渠道信息 | 目前返回云闪付/微信/支付宝的活动参数 | 否 | - | 限交易参与活动 |
accttype | 借贷标识 | 是 | 2 |
00-借记卡 02-信用卡 99-其他(花呗/余额等) |
|
bankcode | 所属银行 | 是 | |||
trxreserve | 交易备注 | 可 | 160 | 订单支付的业务关联内容 | |
logonid | 买家账号 | 是 | 32 | 支付宝交易响应 | |
sign | 签名 | 否 | 32 | 详见安全规范 |
备注:chnldata
云闪付示例:{"couponInfo":"[{"id":"2112020052715193","desc":"2020年银联62节-永旺超市蒙牛百利包单品营","type":"CP01","spnsrId":"00010000","offstAmt":"1100"},{"id":"2112020052715193","desc":"2020年银联62节-永旺超市蒙牛百利包单品营","type":"CP01","spnsrId":"82119105411XXXX","offstAmt":"900"}]"}
支付宝示例:{"voucher_detail_list":"[{"amount":"0.20","merchantContribute":"0.20","name":"0.20元代金券","otherContribute":"0.00","type":"ALIPAY_BIZ_VOUCHER","voucherId":"2020060400073002293805XTTADO"}]","fund_bill_list":"[{"amount":"0.80","fundChannel":"ALIPAYACCOUNT"},{"amount":"0.20","fundChannel":"MDISCOUNT"}]"}
微信示例: {"promotion_detail":"[{"amount":100,"merchant_contribute":"100","other_contribute":"0","promotion_id":"11605335223","type":"DISCOUNT","wxpay_contribute":"0","scope":"GLOBAL","activity_id":"10722272","name":"返回优惠信息券"}]"}