生产地址:https://vsp.allinpay.com/apiweb/tranx/close
使用场景:
对于处理中的交易,可调用该接口直接将未付款的交易进行关闭。
注意:
暂只支持微信、支付宝、云闪付的正向交易
订单生成后不能马上调用关单接口,建议最短调用时间间隔为5分钟,时间间隔过短容易导致错账。
请求参数:
字段ID | 字段名称 | 取值 | 可空 | 长度 | 备注 |
---|---|---|---|---|---|
orgid | 机构号 | 平台分配的机构号 | 是 | 15 | 共享集团号/代理商参数时必填 |
cusid | 商户号 | 平台分配的商户号 | 否 | 15 | |
appid | 应用ID | 平台分配的APPID | 否 | 8 | |
version | 版本号 | 接口版本号 | 可 | 2 | 默认填12 |
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 | 见附录-交易返回码说明 |
randomstr | 随机字符串 | 随机生成的字符串 | 否 | 32 | |
errmsg | 错误原因 | 失败的原因说明 | 是 | 100 | |
sign | 签名 | 否 | 32 | 详见安全规范 |