4.2.1服务单扣款


接口地址:https://vsp.allinpay.com/apiweb/payscore/pay

测试地址:https://syb-test.allinpay.com/apiweb/payscore/pay

使用场景:

服务单完成后调用此接口进行扣款

若发起“服务单扣款”后,查询交易结果时,交易状态非成功时,根据微信官方指引,至少需保证每4小时需要调用”服务单扣款”,确保该订单能不断发起催收,直至扣款成功为止。

请求参数:

参数 参数名称 取值 可空 最大长度 备注
orgid 机构号 平台分配的机构号 15  
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
version 版本号 接口版本号 2 默认填12
out_order_no 商户订单号

商户系统内部服务订单号(不是交易单号)

要求32个字符内

只能是数字、大小写字母

且在同一个商户号下唯一

32 即支付分服务单号
serviceid 服务id 微信分配的服务id 32  
reqsn 商户交易单号 商户的扣款交易订单号 32 保证商户平台唯一
trxamt 交易金额

单位为分

和支付单完成金额一致

15  
scene 交易场景

交 易 场 景 的 取 值 包 括 :

PARKING—车场停车场场景

PARKING_SPACE—车位停车

场GAS—加油场景

HIGHWAY—高速场景

BRIDGE—路桥场景

LIFE_PAY—生活缴费行业

SHARABLE_BIKE—共享单车

SHARABLE_CHARGERS—共享充电宝

E-COMMERCE—电商

OTHERS—其他

32  
body 订单标题 与创建服务单的description一致 100 最大100个字节(50个中文字符)
remark 备注 备注信息 160 最大160个字节(80个中文字符)
acct 支付平台用户标识

服务单中

用户的微信sub_openid

32  
notify_url 交易结果通知地址

接收异步通知回调地址

通知url必须为直接可访问的url

不能携带参数

256  
terminfo 终端信息 终端信息的json字符串 200 详见附录
randomstr 随机字符串 商户自行生成的随机字符串 32  
signtype 签名方式   8

RSA

RSA2

SM2

sign 签名 详见安全规范 32  

响应参数:

字段ID 字段名称 取值 可空 最大长度 备注
retcode 返回码 SUCCESS/FAIL 8

此字段是通信标识

非交易结果

交易是否成功需要查看trxstatus来判断

retmsg 返回码说明   100  
以下信息只有当retcode为SUCCESS时有返回
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
trxid 交易单号 收银宝平台的交易流水号 20  
chnltrxid 渠道平台交易单号 例如微信平台的交易单号 50  
reqsn 商户交易单号 商户的交易订单号 32  
randomstr 随机字符串 随机生成的字符串 32  
trxstatus 交易状态 交易的状态 4 详见附录
fintime 交易完成时间 yyyyMMddHHmmss 14 对于微信刷卡支付有效
errmsg 错误原因 失败的原因说明 100  
sign 签名   32 详见安全规范

yinjr 2024年7月30日 11:10 收藏文档