4.5交易查询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	支付APP登录用户		是	32
trxreserve	交易备注		可	160	订单支付的业务关联内容
sign	签名		否	32	详见安全规范

备注：chnldata
云闪付示例：{discountAmt=20&mchtDiscountAmt=20}

字段名称	说明	备注
discountAmt	总的立减金额	消费、账单支付的商户通知和交易状态查询返回退货的时候返回，表示总的优惠回退金额
mchtDiscountAmt	商户优惠金额	商户出资金额消费、账单支付的商户通知和交易状态查询返回退货的时候返回，表示商户出资的回退金额
activityId	活动编号	单品营销时返回，票券编号、活动编号等，格式自定义
activityNm	活动简称	单品营销时返回，优惠活动简称，可用于展示、打单等
addnPrintInfo	活动打印信息	单品营销时返回，内容自定义打印信息（营销活动需要将营销信息打印到商户的购物小票中，这个字段通过营销活动的配置进行模板的编辑，通过交易信息的回传传给商户的终端收银台进行打印
partnerId	小程序APPID	云闪付小程序支付时返回，表示小程序的唯一标志号