4.16统一主扫关闭接口


接口地址:https://vsp.allinpay.com/apiweb/unitorder/closenative

使用场景:
可对4.15统一主扫接口产生的“处理中”交易发起关闭,或使已生成的二维码即时失效。

请求参数:

参数 参数名称 取值 可空 最大长度 备注
orgid 机构号   15 共享集团号/代理商参数时必填
cusid 商户号   15  
appid 应用ID   8  
version 版本号 12 2  
oldreqsn 原商户订单号   32 置二维码失效必填
oldtrxid 原通联平台交易流水   20

oldreqsn和oldtrxid必填其一

建议:商户如果同时拥有oldtrxid和oldreqsn

优先使用oldtrxid

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 2025年10月23日 10:12 收藏文档