3.35交易列表查询


接口地址:https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/tranx/list

测试地址:https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/tranx/list

使用场景:该接口提供交易列表查询,获取交易明细。支持近1年内交易成功的明细查询。

请求参数

字段ID

字段名称

取值

可空

最大长度

备注

appid

应用ID

平台分配的APPID

否

20

 

orgid

机构ID

实际交易的机构ID

是

11

服务商appid调用时必填

cusid

商户号

店铺ID

否

11

 

randomstr

随机字符串

随机生成的字符串

否

32

 

version

版本号

接口版本号

可

2

默认填11

signtype

签名类型

 

否

8

RSA、SM2

sign

签名

 

否

32

详见安全规范

date

日期

yyyyMMdd

选填

8

不能与begintime、endtime同时为空

termno

终端号

 

是

8

 

pagesize

每页包含数据

最大50

否

4

 

pageindex

页码

 

否

4

 

begintime

交易开始时间

yyyy-MM-dd HH:mm:ss

选填

19

不能与date同时为空

endtime

交易截止时间

yyyy-MM-dd HH:mm:ss

选填

19

不能与date同时为空

 

响应参数

字段ID

字段名称

取值

可空

最大长度

备注

retcode

返回码

SUCCESS/FAIL

 

否

8

此字段是通信标识,非交易结果

retmsg

返回码说明

 

是

100

 

以下信息只有当retcode为SUCCESS时有返回

appid

应用ID

平台分配的APPID

否

20

 

orgid

机构ID

实际交易的机构ID

否

11

 

cusid

商户号

请求的cusid

否

11

 

randomstr

随机字符串

随机生成的字符串

否

32

 

trxlist

交易列表

List<Trxinfo>的json字符串

是

-

 

pagesize

每页包含数据

 

否

 

原样返回

pageindex

页码

 

否

 

原样返回

signtype

签名类型

 

否

8

RSA、SM2

sign

sign校验码

 

否

32

 

 

Trxinfo字段

字段ID

字段名称

取值

可空

最大长度

备注

paymethod

支付方式

 

否

4

微信支付、支付宝支付、手机QQ支付、云闪付支付、快捷支付、现金支付

现金(数字人民币)、全抵扣

reqsn

商户订单号

 

否

40

 

tradeno

订单号

 

是

 

营销系统订单号

srctradeno

原订单号

 

是

50

营销系统原订单号

amount

订单金额

 

否

20

单位分

paytime

支付时间

yyyy-MM-dd HH:mm:ss

否

19

 

trxtype

交易类型

 

否

1

消费、撤销、退款

balanceamount

余额抵扣

 

否

20

单位分

score

抵扣积分数量

 

否

11

 

scoreamount

抵扣积分金额

积分数量换算成的金额

否

20

单位分

discountamount

商户活动/卡券优惠抵扣金额

 

否

20

单位分

subsidyamount

银行活动优惠金额

 

否

20

单位分

paymentamount

实付金额

 

否

20

单位分

fee

手续费

 

否

20

单位分

trxid

支付流水号

 

是

50

收银宝平台的支付流水号

shopcode

店铺编码

 

是

20

 

shopname

店铺名称

 

是

50

 

termno

终端号

终端代码

是

64

 

remark

备注

 

是

200

 

 


2025年11月19日 15:19 收藏文档