4.2扫码预消费完成


接口地址:https://vsp.allinpay.com/apiweb/prescanpay/finish

测试地址:https://syb-test.allinpay.com/apiweb/prescanpay/finish

使用场景:针对扫码预消费交易(接口4.1预消费)进行预消费完成,剩余金额会自动发起回退

请求参数:

参数 参数名称 取值 可空 最大长度 备注
orgid 集团号/机构号 平台分配的集团商户号/机构号 15 共享集团号/机构号参数时必填
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
version 版本号 接口版本号 2 默认填12
autoback 是否回退标志

0-不自动发起回退,1-自动发起回退

不填默认为1

     
reqsn 商户完成交易单号 商户的完成交易订单号 32 商户平台唯一
trxamt 交易金额 完成金额 16  
oldtrxid 预消费交易流水 预消费交易的收银宝平台流水 20  
asinfo 分账信息

格式:

cusid:type:amount;cusid:type:amount

其中

cusid:接收分账的通联商户号

type分账类型(01:按金额  02:按比率)

如果分账类型为02

则分账比率为0.5表示50%

如果分账类型为01

则分账金额以元为单位表示

1024 开通此业务需开通分账配置
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  
randomstr 随机字符串 随机生成的字符串 32  
sign 签名   32 详见安全规范

yinjr 2025年4月24日 15:25 收藏文档