接口地址: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 | 详见安全规范 |