4.3订单关闭API


接口地址:https://vsp.allinpay.com/apiweb/tranx/close

使用场景:
对于处理中的交易,可调用该接口直接将未付款的交易进行关闭。
注意:
订单生成后不能马上调用关单接口,建议最短调用时间间隔为5分钟,时间间隔过短容易导致错账。

请求参数:

参数 参数名称 取值 可空 最大长度 备注
orgid 机构号 平台分配的机构号 15 共享集团号/代理商参数时必填
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
version 版本号 接口版本号 2 默认填12
oldreqsn 原商户订单号 原商户的下单的交易订单号 32  
oldtrxid 原通联平台交易流水 原通联收银宝平台流水 20

oldreqsn和oldtrxid必填其一

建议:商户如果同时拥有oldtrxid和oldreqsn,优先使用oldtrxid

isiot 是否音箱播报 1-播报
0-不播报
2

 

randomstr 随机字符串 随机生成的字符串 32  
signtype 签名方式   8

RSA

SM2

sign 签名   32 详见安全规范

响应参数:

字段ID 字段名称 取值 可空 最大长度 备注
retcode 返回码 SUCCESS/FAIL 8 此字段是通信标识,非交易结果,交易是否成功需要查看trxstatus来判断
retmsg 返回码说明   100  
以下信息只有当retcode为SUCCESS时有返回
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
trxstatus 交易状态 交易的状态 4

见附录-交易返回码说明

如果trxstatus为空,则交易正在处理中,尚未完成

randomstr 随机字符串 随机生成的字符串 32  
errmsg 错误原因 失败的原因说明 100  
sign 签名   32 详见安全规范

yinjr 2024年12月3日 17:21 收藏文档