4.2.3撤销API


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

测试地址:https://syb-test.allinpay.com/apiweb/tranx/cancel

使用场景:只能撤销当天的交易,全额退款,实时返回退款结果

请求参数:

参数 参数名称 取值 可空 最大长度 备注
orgid 集团/代理商商户号   15 共享集团号/代理商参数时必填
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
version 版本号 接口版本号 2 默认填11
reqsn 商户撤销交易单号 商户的撤销交易订单号 32 商户平台唯一
trxamt 交易金额 原订单金额 16  
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  
trxid 交易单号 收银宝平台的退款交易流水号 20  
reqsn 商户订单号 商户的退款交易订单号 32  
trxstatus 交易状态 交易的状态 4 见附录-交易返回码说明
fintime 交易完成时间 yyyyMMddHHmmss 14  
errmsg 错误原因 失败的原因说明 100  
trxcode 交易类型   8 见交易类型说明
randomstr 随机字符串 随机生成的字符串 32  
bankcode 所属银行      
sign 签名   32 详见安全规范

yinjr 2024年7月29日 16:05 收藏文档