生产地址:https://vsp.allinpay.com/apiweb/posol/query
测试地址:https://syb-test.allinpay.com//apiweb/posol/query
使用场景:
通过协同收银API发起的预授权完成、交易退货及交易撤销的交易查询。原交易优先使用平台单号.如果没有平台单号,再使用商户流水(reqsn)。
若查询POS终端发起的交易.原交易必须使用平台交易单号查询(trxid)。
注意:
1.如果同一个订单号发起了多笔交易,只返回最新的一笔
2.有些商户交易会用同一订单号发起多次交易,建议商户在同时获得orderid和trxid的情况下,请只用trxid进行查询,这样能确定唯一交易
3.验签要用返回的所有非空字段进行组装验签,这样才能很好的兼容以后收银宝增加字段的情况
请求参数:
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
orgid |
集团商户号 |
平台分配的集团商户号 |
否 |
15 |
|
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
appid |
应用ID |
平台分配的集团商户APPID |
否 |
8 |
|
reqsn |
订单号 |
商户平台订单号,同接口reqsn |
可 |
32 |
|
trxid |
收银宝交易流水 |
收银宝平台交易流水 |
可 |
18 |
reqsn和trxid不能同时为空 |
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
signtype |
签名类型 |
|
否 |
8 |
RSA |
sign |
签名 |
详见安全规范 |
否 |
32 |
|
响应参数:
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
retcode |
返回码 |
SUCCESS/FAIL
|
否 |
8 |
retcode=SUCCESS情况下,表示查询成功,交易状态按照trxstatus判断; retcode=FAIL表示接口拒绝交易,如验签失败/数据格式错误/数据字段缺失。 |
以下信息只有当retcode为SUCCESS时有返回 |
|||||
retmsg |
返回码说明 |
|
是 |
100 |
|
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
appid |
应用ID |
平台分配的APPID |
否 |
8 |
|
trxcode |
交易类型 |
|
否 |
8 |
详见附录 |
trxamt |
金额 |
单位:分 |
否 |
20 |
单位分 |
fee |
手续费 |
单位:分 |
否 |
20 |
单位分 |
trxstatus |
交易结果码 |
|
否 |
4 |
详见附录 |
errmsg |
交易错误信息 |
|
可 |
100 |
交易失败不为空 |
reqsn |
商户平台订单号
|
如:微信支付的商户交易单号 支付宝支付的商户交易单号 订单支付的商户订单号 |
否 |
32 |
如订单号,保单号,缴费编号等 |
trxid |
交易流水号 |
|
否 |
18 |
通联收银宝交易流水号 |
srctrxid |
原交易流水 |
|
可 |
18 |
通联收银宝原交易流水,冲正撤销退货交易本字段不为空 |
chnltrxid |
支付渠道流水号 |
如: 支付宝平台交易单号 微信平台交易单号
|
可 |
100 |
|
fintime |
交易完成时间 |
|
否 |
14 |
yyyymmddhhmmss |
termauthno |
授权码 |
|
是 |
16 |
授权码 |
randomstr |
随机字符串 |
|
否 |
32 |
主要用于加签 |
sign |
sign校验码 |
|
否 |
32 |
|
acct |
交易账号 |
|
否 |
32 |
|