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

接口功能描述：获取账户余额页面链接，通过页面可查询余额及发起提现。

使用限制

无

接口说明

资金到账时间取决于银行或渠道的系统处理时效，一般情况下从发起提现到实际到账时间约 1-3 天，请您耐心等待。

基本信息

基本信息
HTTP URL	https://developer.toutiao.com/api/apps/ecpay/saas/app_add_sub_merchant
HTTP Method	POST
接口频次	20QPS(小程序app_id维度)

请求头

名称	类型	必填	描述
Content-Type	string	是	固定值 "application/json"

请求参数

名称	类型	是否必填	最大长度	描述	示例值
sub_merchant_id	string	是	128	商户 id，用于接入方自行标识并管理进件方。由开发者自行分配管理	71013634663445509434
app_id	string	是	64	小程序的 app_id	tt226854d5bd56e9ec01
url_type	number	是	-	链接类型枚举值： 2: 账户余额页（可以发起提现） 3: 提现记录页	2
sign	string	是	344	签名，详见签名DEMO	1aa1a8100523b3872351956594176a0a0
role	number	否	-	1：收款商户 2：商户的合作方不传默认为2 不参与验签	1

请求示例

json复制
{
  "sign": "1aa1a8100523b3872351956594176a0a0",
  "sub_merchant_id": "71013634663445509434",
  "app_id": "tt226854d5bd56e9ec01",
  "url_type": 2
}

响应参数

公共响应参数

名称	类型	是否必填	最大长度	描述	示例值
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": ""
}

错误码

错误码	描述	排查建议
0	""	成功
1	服务商无对应小程序分账授权	检查当前app_id是否有权限管理
2	网络异常，请稍后重试	稍等原参数重试
1005	参数解析异常，请检查参数格式	请查看参数的格式
1006	post 请求使用 json 传参	请将参数改为Json传参，进行重试
1007	参数不合法，请检查参数	检查请求参数，修改后重试
2008	签名校验异常，请使用正确的签名和 json 传参	1.请检查签名参数，详见签名DEMO 2.请检查sub_merchant_id和app_id的对应关系
2042	小程序appid无效，请检查app_id字段	检查appid字段信息是否有误
2047	服务商id无效，请检查thirdparty_id字段	检查thirdparty_id字段信息是否有误
2048	未查询到服务商与小程序的授权关系	检查服务商和小程序是否有授权关系
4000	商户号和小程序/应用ID不对应	检查app_id和merchant_id是否对应
4002	有效信息不足，请再次输入	请查看自己满足的条件的查询参数是否正确