2.1.4交易查询


生产地址: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

SM2

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

 

 


yinjr 2025年5月28日 14:10 收藏文档