接口地址:https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/tranx/cancel
测试地址:https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/tranx/cancel
使用场景:只能撤销当天的统一扫码交易,全额退款,实时返回退款结果。开通资金管理的机构不支持撤销交易。
请求参数
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
orgid |
机构ID |
实际交易的机构ID |
是 |
11 |
服务商appid调用时必填 |
cusid |
商户号 |
实际交易的店铺ID |
否 |
11 |
|
version |
版本号 |
接口版本号 |
是 |
2 |
默认填11 |
reqsn |
商户撤销交易单号 |
商户的撤销交易订单号 |
否 |
64 |
商户平台唯一 |
trxamt |
交易金额 |
原订单实际支付金额 |
否 |
16 |
|
oldreqsn |
原交易单号 |
原交易的商户交易单号 |
是 |
64 |
|
oldtrxid |
原交易流水 |
原交易的收银宝平台流水 |
是 |
20 |
oldreqsn和oldtrxid必填其一 |
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
signtype |
签名类型 |
|
是 |
8 |
支持MD5、RSA、SM2,不填默认MD5 |
sign |
签名 |
|
否 |
32 |
详见安全规范 |
响应参数
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
此字段是通信标识,非交易结果,交易是否成功需要查看trxstatus来判断 |
retmsg |
返回码说明 |
|
是 |
100 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
cusid |
商户号 |
实际交易的店铺ID |
否 |
15 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
orgid |
机构ID |
实际交易的机构ID |
否 |
11 |
|
trxid |
交易单号 |
收银宝平台的退款交易流水号 |
是 |
20 |
|
reqsn |
商户订单号 |
商户的退款交易订单号 |
否 |
32 |
|
trxstatus |
交易状态 |
交易的状态 |
否 |
4 |
见附录-交易返回码说明 |
fintime |
交易完成时间 |
yyyyMMddHHmmss |
是 |
14 |
|
errmsg |
错误原因 |
失败的原因说明 |
是 |
100 |
|
trxcode |
交易类型 |
|
是 |
8 |
见交易类型说明 |
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |