服务商获取合作方进件页面
接口功能描述：获取进件页面链接，通过页面提交商户资料，开通商户号以收款或接收分账。
注意事项
- 使用前要求服务商首先完成自身账户进件。
基本信息
请求URL | https://developer.toutiao.com/api/apps/ecpay/saas/add_sub_merchant |
|---|---|
请求方式 | POST |
接口频次 | 20QPS(thirdparty_id维度) |
请求参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
sub_merchant_id | string | 是 | 128 | 商户 id，用于接入方自行标识并管理进件方。由开发者自行分配管理 | 69560322266147130860 |
thirdparty_id | string | 是 | 64 | 小程序第三方平台应用 id | ttc4a3b2154b83622f |
url_type | number | 是 | - | 链接类型枚举值： 1: 进件页面 2: 账户余额页 | 1 |
sign | string | 是 | 344 | 签名，详见Demo | e42310f3f23c1d52624f24ad3cdea7c4 |
请求示例
{
"sign": "e42310f3f23c1d52624f24ad3cdea7c4",
"sub_merchant_id": "69560322266147130860",
"thirdparty_id": "ttc4a3b2154b83622f",
"url_type": 1
}响应参数
公共响应参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
err_no | number | 是 | - | 返回码，详见错误码 | 2008 |
err_tips | string | 是 | - | 返回码描述，详见错误描述 | 签名校验异常，请使用正确的签名和 json 传参 |
业务响应参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
url | string | 是 | 1024 | 请求页面链接，两小时过期，注意定时更新，请勿长期保存。 | "https://tp-pay.snssdk.com/embed-merchant/status?app_id=ttdb96ad2b44aeff3301" |
merchant_id | string | 是 | 50 | 小程序平台分配商户号，用于后续分账标识分账方。进件完成后，才会有非空返回 | 69929319273134349240 |
响应示例
正常响应示例
{
"err_no": 0,
"err_tips": "",
"url": "https://pay-merchant.bytedance.com/embed-merchant/v2/status?app_id=800078773621&mainbody_customize=&merchant_id=1200007877&sign=3JAOS-KXjFwYybEIYXvdC53bHjix9O_LDCuTGsIdlYCJ7KiD1wo73tQO6787CTQIO3B8fkrvo-Lhcew3wbBAvgljWC1UreIYyRSqJ5KdYisjAS6_UYK8PK695lBrZ4usaKi1FsCOXv-sB2t-Y8JP1kHpoPXuP1BKH6QhawQYmI8k67kpBWUsPYbpwM0d8XaQDMT7oqKw9pg5LqkmRc_jBA&uid=70832947030972357482&uid_type=1002",
"merchant_id": "70832947030972357482"
}异常示例
{
"err_no": 2008,
"err_tips": "签名校验异常，请使用正确的签名和 json 传参",
"merchant_id": "",
"url": ""
}错误码
err_no | err_tips | 解决方案 |
|---|---|---|
0 | "" | 成功 |
1 | 服务商无对应小程序分账授权 | 检查当前app_id是否有权限管理 |
2 | 网络异常，请稍后重试 | 稍等原参数重试 |
1005 | 参数解析异常，请检查参数格式 | 请查看参数的格式 |
1006 | post 请求使用 json 传参 | 请将参数改为Json传参，进行重试 |
1007 | 参数不合法，请检查参数 | 检查请求参数，修改后重试 |
2008 | 签名校验异常，请使用正确的签名和 json 传参 | 请参考加签Demo |
4000 | 商户号和小程序/应用ID不对应 | 检查app_id和merchant_id是否对应 |
4002 | 有效信息不足，请再次输入 | 请查看自己满足的条件的查询参数是否正确 |
