3.1账单同步


接口地址:

生产环境: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


yinjr 2025年3月19日 09:21 收藏文档