3.2统一撤销


接口地址: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必填其一
建议:商户如果同时拥有oldtrxid和oldreqsn,优先使用oldreqsn;分账订单只能通过reqsn进行撤销。

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

详见安全规范


卜子超buzc 2025年5月14日 15:58 收藏文档