接口地址:
生产环境:https://vsp.allinpay.com/cusapi/billpay/add
测试环境:https://syb-test.allinpay.com/vsppcusapi/billpay/add
使用场景:
商户将账单信息同步给通联收银宝
请求参数:
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
appid |
通联分配appid |
平台分配的APPID |
否 |
8 |
|
digid |
应用id |
|
否 |
8 |
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
payeecusid |
收款商户号 |
暂只支持当前商户号,即必须与cusid相等 |
否 |
15 |
|
payercusid |
付款商户号 |
付款商户号 |
否 |
15 |
|
trxamt |
账单金额 |
单位:分 |
否 |
15 |
|
billid |
商户账单号 |
|
否 |
32 |
|
subject |
账单说明 |
|
否 |
100 |
|
remark |
账单备注信息 |
商户自定义备注 交易通知会带上 |
否 |
160 |
|
notifyurl |
通知地址 |
|
否 |
150 |
|
autopay |
是否自动扣款 |
0-不自动扣款 1-自动扣款 |
是 |
1 |
默认为0 |
autopaytime |
自动扣款日期 |
yyyyMMdd |
否 |
8 |
|
sign |
签名 |
详见1.4 |
否 |
32 |
|
响应参数:
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
retcode |
返回码 |
SUCCESS/FAIL
|
否 |
8 |
此字段是通信标识,非交易结果,交易是否成功需要查看trxstatus来判断 |
retmsg |
返回码说明 |
|
是 |
100 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
appid |
应用ID |
平台分配的APPID |
否 |
8 |
|
trxstatus |
同步结果 |
0000代表同步成功 其余代表同步失败,详情查看errmsg |
否 |
4 |
|
errmsg |
错误原因 |
|
是 |
100 |
|
sign |
签名 |
|
否 |
32 |
详见1.5 |