4.6交易查询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 所属银行      
logonid 买家账号   32 支付宝交易响应
fqnum 分期数   15  
trxreserve 交易备注   160 订单支付的业务关联内容
sign 签名   32 详见安全规范

 

备注:chnldata字段内容

序号 数据元中文名 标识 类型 取值说明
1 总营销优惠金额 discountAmt String(1..12) 仅支持数字,返回营销活动的总优惠金额,原交易参与营销时返回
2 商户出资优惠金额 merDiscountAmt String(1..16) 仅支持数字,代表商户出资优惠金额,在商户出资场景下返回,与本金一起轧查清算
3 营销活动ID discountId String(1..40) 票券编号、活动编号等,格式自定义
4 营销活动名称 activityNm String(1..60) 优惠活动简称,可用于消费展示,订单打印等

yinjr 2025年4月24日 13:53 收藏文档