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

详见安全规范


yinjr 2025年12月18日 21:07 收藏文档