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

 

 


卜子超buzc 2025年10月10日 10:41 收藏文档