开发者获取小程序收款商户/合作方进件页面
收藏
我的收藏

获取进件页面链接，通过页面提交商户资料，开通商户号以收款或接收分账。

使用限制

无

接口说明

这里的 sub_merchant_id 只是为了便于小程序开发者区分管理，但在分账时用于标识接受方的商户号为接口返回参数中的 merchant_id 字段。

请求返回的业务响应参数url存在转义字符，直接在浏览器打开会有问题，需要转义处理下

基本信息

基本信息
HTTP URL	https://developer.toutiao.com/api/apps/ecpay/saas/app_add_sub_merchant
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	签名，详见签名DEMO	1aa1a8100523b3872351956594176a0a0
role	number	否	-	1：收款商户（可以收款也可以接收分账） 2：商户的合作方（只可以接收分账）不传默认为2 不参与验签	1

请求示例

json复制
{
  "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小时过期，注意定时更新，请勿长期保存。	"https://tp-pay.snssdk.com/embed-merchant/status?app_id=ttdb96ad2b44aeff3301"
merchant_id	string	是	50	小程序平台分配商户号，用于支付、分账等环节标识商户	71034289132712668623

响应示例

正常响应示例

json复制
{
  "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"
}

异常响应示例

json复制
{
  "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
2042	小程序appid无效，请检查app_id字段	检查appid字段信息是否有误
2047	服务商id无效，请检查thirdparty_id字段	检查thirdparty_id字段信息是否有误
2048	未查询到服务商与小程序的授权关系	检查服务商和小程序是否有授权关系
4000	商户号和小程序/应用ID不对应	检查app_id和merchant_id是否对应
4002	有效信息不足，请再次输入	请查看自己满足的条件的查询参数是否正确
7025	当前小程序所归属的服务类目，暂不支持开通支付功能	详情请查看小程序交易能力接入规范