测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1055
功能说明:
(1)支持收款会员批量签署分账协议,支持收款商户一键完成签约。
(2)支持收单商户以txt文件的形式批量上送分账人信息列表,其中分账方信息条目数最多可上送250条,请求成功后,响应收款方签约地址和分账方协议签约地址列表文件。
(3)支持点击接口返回的链接进入【批量分账协议签署H5】页面。
(4)仅支持签署分账协议。
(5)列表格式
分账人列表文件格式(agreementFile)
最多支持250条。
分账会员商户会员编号|分账会员名称|分账方式|分账比例
其中:
- 分账方式,目前仅支持上送1:分账比例。
- 分账比例:精确到小数点后两位,即上送00,则分账比例为10.00%
分账方签约地址列表文件格式(sepAgreementUrlFile)
分账会员商户会员编号|分账会员名称|分账方式|分账比例|签约地址|错误原因
其中:
(1)签约地址,即该分账会员的签约地址。
(2)错误原因:该会员状态异常等原因导致无法生成签约地址的错误原因
业务请求参数:
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
signNum |
String |
60 |
是 |
签约会员编号 |
若上送收款方角色的会员,可在签约协议列表中上送分账会员信息,批量签订分账协议 |
memberName |
String |
32 |
是 |
签约会员名称 |
此字段填收款会员信息;分账会员信息在签约协议列表中明确 |
agreementType |
String |
1 |
是 |
协议类型 |
3-收单分账服务协议 |
agreementFile |
byte |
40 |
是 |
txt文件,最多支持250条分账人信息 |
|
jumpPageType |
String |
1 |
否 |
跳转页面类型 |
1-H5页面 2-小程序页面 兼容存量模式,不上送默认跳转H5页面 |
jumpUrl |
String |
256 |
前端跳转地址 |
签约成功 |
签约成功,则跳转 |
notifyUrl |
String |
256 |
签约结果通知地址 |
|
|
业务响应参数:
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
respTraceNum |
String |
40 |
否 |
响应流水号 |
业务正常处理,返回 |
respCode |
String |
5 |
是 |
业务码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
200 |
是 |
失败原因 |
|
signAgreementUrl |
String |
256 |
否 |
收款方协议签约地址 |
00000-申请成功,返回说明:72小时有效期均可打开签约 返回签约主体的签约地址 |
sepAgreementUrlFile |
String |
256 |
否 |
00000-申请成功,返回说明:仅需要签订分账协议,才返回(能否同步) |