3.15订单关闭


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

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

使用场景:对于处理中的交易,可调用该接口直接将未付款的交易进行关闭。

注意:

暂只支持微信、支付宝的正向交易。

订单生成后不能马上调用关单接口,建议最短调用时间间隔为5分钟,时间间隔过短容易导致错账。

请求参数

字段ID

字段名称

取值

可空

最大长度

备注

appid

应用ID

平台分配的APPID

20

 

orgid

机构ID

实际交易的机构ID

11

服务商appid调用时必填

cusid

商户号

实际交易的店铺ID

11

 

version

版本号

接口版本号

2

默认填11

oldreqsn

商户订单号

商户的交易订单号

64

 

oldtrxid

平台交易流水

支付的收银宝平台流水

20

oldreqsn和oldtrxid必填其一
建议:商户如果同时拥有oldtrxid和oldreqsn,优先使用oldreqsn。oldtrxid只能关闭存在待实付的订单;分账订单只能通过oldreqsn进行关闭。

randomstr

随机字符串

随机生成的字符串

32

 

signtype

签名类型

 

8

支持MD5、RSA、SM2,不填默认MD5

sign

签名

 

32

详见安全规范

 

响应参数

字段ID

字段名称

取值

可空

最大长度

备注

retcode

返回码

SUCCESS/FAIL

8

 

retmsg

返回码说明

 

100

 

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

cusid

商户号

实际交易的店铺ID

15

 

appid

应用ID

平台分配的APPID

20

 

trxstatus

交易状态

交易的状态

4

见附录-交易返回码说明
如果trxstatus为空,则交易正在处理中,尚未完成

randomstr

随机字符串

随机生成的字符串

32

 

errmsg

错误原因

失败的原因说明

100

 

sign

签名

 

32

详见安全规范


卜子超buzc 2025年5月14日 16:06 收藏文档