4.2.2查询API


接口地址: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":"返回优惠信息券"}]"}


yinjr 2025年1月8日 18:20 收藏文档