4.17交易结果确认查询接口


接口地址:https://vsp.allinpay.com/apiweb/tranx/queryconfirm

测试地址:https://syb-test.allinpay.com/apiweb/tranx/queryconfirm

使用场景:

本接口主要用于查询并明确交易结果,具备查询性能高、延迟低的特点,仅支持查询2 个自然日内的交易。建议在以下场景中调用本接口确认交易结果:

(1)异步类交易查询:如 native 交易、公众号 JS 支付、小程序支付等场景。

(2)异常交易查询:交易过程中返回 “系统繁忙” 或交易异常(SYSTEMERR)时,可调用此接口明确最终交易结果。

请求参数:

 

参数

参数名称

取值

可空

最大长度

备注

cusid

商户号

平台分配的商户号

15

 

appid

应用ID

平台分配的APPID

8

 

version

版本号

接口版本号

2

默认填12

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

 

cmid

渠道子商户号

 

32

微信

支付宝有效

chnlid

渠道商号

 

32

微信有效

randomstr

随机字符串

随机生成的字符串

32

 

errmsg

错误原因

失败的原因说明

100

 

sign

签名

 

32

详见安全规范


2026年7月22日 09:25 收藏文档