接口说明
通过该接口为服务商开通分账相关的业务信息,例如余额分账,订单分账(实时,延迟)
接口地址
http://39.106.187.68:8080/api/v2/merchant-ledger/apply
请求参数
| 参数 |
参数名称 |
类型 |
参数说明 |
必填 |
样例 |
| agent_apply_no |
服务商申请单编号 |
String(64) |
服务商申请单编号 |
M |
123456 |
| agent_no |
服务商编号 |
String(32) |
海科平台服务商编号 |
M |
57125863 |
| merch_no |
商户号 |
String(32) |
海科平台商户号 |
M |
|
| biz_type |
业务类型 |
String(10) |
分账业务类型,order,balance |
M |
57125863 |
| notify_url |
回调地址 |
String |
审核状态回调地址 |
N |
www.baidu.com |
| remark |
备注信息 |
JSON |
备注信息 |
N |
开通分账 |
| status |
分账状态 |
String |
0开启,1关闭 |
M |
0 |
| biz_setting |
分账业务设置 |
JSON |
分账业务信息设置,比例金额,不传使用服务商维度的默认信息 |
O |
|
| biz_extends |
分账补充信息 |
JSON |
业务补充信息 |
M |
|
biz_setting 与分账业务类型相关
| 参数 |
参数名称 |
类型 |
参数说明 |
必填 |
样例 |
| ledger |
实时分账 |
JSON |
订单分账相关参数 |
N |
|
| delay_ledger |
延迟分账 |
JSON |
订单分账相关参数 |
N |
|
| balance_split |
余额分账 |
JSON |
余额分账相关参数 |
N |
|
订单分账信息设置:
| 参数 |
参数名称 |
类型 |
参数说明 |
必填 |
样例 |
| ratio |
分账比例 |
String |
分账比例,不能超过服务商比例0.1 是 10% |
N |
0.1 |
| max_amount |
分账金额 |
String |
金额,0.01元。 |
N |
0.01 |
余额分账信息设置
| 参数 |
参数名称 |
类型 |
参数说明 |
必填 |
样例 |
| ratio |
分账比例 |
String |
分账比例,不能超过服务商比例0.1 是 10% |
N |
0.1 |
biz_extends分账补充信息 订单分账
| 参数 |
参数名称 |
类型 |
参数说明 |
必填 |
样例 |
| home_page |
分账方商户与服务商之间的分账协议首页 |
String |
图片上传返回的id |
M |
图片id |
| last_page |
分账方商户与服务商之间的分账协议尾页 |
String |
图片上传返回的id。 |
M |
图片id |
| business_page |
分账方商户与服务商之间的分账协议合作页 |
String |
图片上传返回的id |
M |
图片id |
| agreement |
其他辅助资料(为非必传项) |
String |
图片上传返回的id |
N |
图片id |
| corporate_agreement |
法人授权函协议 |
String |
图片上传返回的id,对公非法人需要上传 |
O |
图片id |
biz_extends分账补充信息 余额分账
| 参数 |
参数名称 |
类型 |
参数说明 |
必填 |
样例 |
| month_bill |
商户一个月的收据或交易流水 |
String |
图片上传返回的id |
M |
图片id |
| scene_video |
场景视频 |
String |
图片上传返回的id。 |
M |
图片id |
| merchant_cert_type |
特殊经营许可证 |
String |
图片上传返回的id |
M |
图片id |
返回参数
| 参数 |
参数名称 |
类型 |
参数说明 |
必填 |
样例 |
| result_code |
业务返回码 |
String(16) |
10000:成功 其他:失败 |
Y |
10000 |
| result_msg |
业务返回信息 |
String(128) |
业务返回信息 |
Y |
|
| apply_no |
申请单号 |
String |
申请单编号 |
O |
成功是返回 |
文档更新时间: 2025-10-15 14:59 作者:闵丹阳