开发者获取小程序收款商户/合作方进件页面
收藏我的收藏
收藏获取进件页面链接，通过页面提交商户资料，开通商户号以收款或接收分账。
使用限制
无
接口说明
- 1.这里的 sub_merchant_id 只是为了便于小程序开发者区分管理，但在分账时用于标识接受方的商户号为接口返回参数中的 merchant_id 字段。
- 2.请求返回的业务响应参数url存在转义字符，直接在浏览器打开会有问题，需要转义处理下
基本信息
基本信息 | |
HTTP URL | |
HTTP Method | POST |
接口频次 | 20QPS(小程序app_id维度) |
请求参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
sub_merchant_id | string | 是 | 128 | 商户 id，用于接入方自行标识并管理进 件方。由开发者自行分配管理 | 71013634663445509434 |
app_id | string | 是 | 64 | 小程序的 app_id | tt226854d5bd56e9ec01 |
url_type | number | 是 | - | 链接类型枚举值： 1: 进件页 面 | 1 |
sign | string | 是 | 344 | 1aa1a8100523b3872351956594176a0a0 | |
role | number | 否 | - | 1：收款商户（可以收款也可以接收分账） 2：商户的合作方（只可以接收分账） 不传默认为2 不参与验签 | 1 |
请求示例
{ "sign": "1aa1a8100523b3872351956594176a0a0", "sub_merchant_id": "71013634663445509434", "app_id": "tt226854d5bd56e9ec01", "url_type": 1, "role": 1 }
响应参数
公共响应参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
err_no | number | 是 | - | 返回码，详见错误码 | 2008 |
err_tips | string | 是 | - | 返回描述，详见错误描述 | 签名校验异常，请使用正确的签名和 json 传参 |
业务响应参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
url | string | 是 | 1024 | 请求页面链接，24小时过期，注意定时更新，请勿长期保存。 | |
merchant_id | string | 是 | 50 | 小程序平台分配商户号，用于支付、分账等环节标识商户 | 71034289132712668623 |
响应示例
正常响应示例
{ "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_LDCuTGsIdlYBXrjP7SYh6kGi6LoaTRieLBFhykj2lqfAl2QYfe30HWqPoHFas2SEn6YTS-jEEDVrXaW8N2pp2HKr41zIglNYw5tot2r6BN7zDQhkt2vL7AUewZG0JYOIKMd-tVeY1zvgYuoLpECyPmB3JrMqMru__mlZ24J2l9rp81tLPw97YZQ&uid=71034289144707668623&uid_type=1002", "merchant_id": "71034289132712668623" }
异常响应示例
{ "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 传参 | |
2042 | 小程序appid无效，请检查app_id字段 | 检查appid字段信息是否有误 |
2047 | 服务商id无效，请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
2048 | 未查询到服务商与小程序的授权关系 | 检查服务商和小程序是否有授权关系 |
4000 | 商户号和小程序/应用ID不对应 | 检查app_id和merchant_id是否对应 |
4002 | 有效信息不足，请再次输入 | 请查看自己满足的条件的查询参数是否正确 |
7025 | 当前小程序所归属的服务类目，暂不支持开通支付功能 |
