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

详见安全规范


2025年11月19日 15:18 收藏文档