接口地址: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 |
|