服务商获取合作方进件页面
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/apps/ecpay/v3/saas/add_sub_merchant/
接口说明：
1、使用前要求服务商首先完成自身账户进件。
2、请求返回的业务响应参数url存在转义字符，直接在浏览器打开会有问题，需要转义处理下。
错误码
| 错误码err_no | 描述err_msg | 排查建议 |
|---|---|---|
| 0 | "" | 成功 |
| 1005 | 参数解析异常，请检查参数格式 | 请查看参数的格式 |
| 1006 | post 请求使用 json 传参 | 请将参数改为Json传参，进行重试 |
| 1007 | 参数不合法，请检查参数 | 检查请求参数，修改后重试 |
| 2008 | token校验异常，请校验请求头中生成token的小程序appid/服务商id和请求参数是否一致 | 请校验请求头中生成token的小程序appid/服务商id和请求参数是否一致 |
| 2042 | 小程序appid无效，请检查app_id字段 | 检查appid字段信息是否有误 |
| 2047 | 服务商id无效，请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
| 2048 | 未查询到服务商与小程序的授权关系 | 检查服务商和小程序是否有授权关系 |
| 4000 | 商户号和小程序/应用ID不对应 | 检查app_id和merchant_id是否对应 |
| 4002 | 有效信息不足，请再次输入 | 请查看自己满足的条件的查询参数是否正确 |
| 28001008 | access_token过期,请刷新或重新授权 | access_token过期,请根据请求头中token获取方式调用接口重新获取 |
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/ecpay/v3/saas/add_sub_merchant/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"sub_merchant_id": "69560322266147130860",
"thirdparty_id": "ttc4a3b2154b83622f",
"url_type": 1，
"prod_id": 2,
"role": 1,
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_msg": "",
"log_id": "202310061616226C30B180133AE61392D7",
"data": {
"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"
}
}修改于 2025-11-10 09:21:42