4.18【批量签订分账协议】


测试地址: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-申请成功,返回说明:仅需要签订分账协议,才返回(能否同步)


maxy2 2025年2月24日 16:26 收藏文档