抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 评价
  • 交易工具
  • 交易系统
  • 担保支付(仅限生活服务小程序接入)
  • 进件
  • 支付
  • 退款
  • 结算及分账
  • 退分账
  • 提现
  • 获取对账单
  • 进件
  • 提现
  • 开发者获取小程序收款商户/合作方提现页面
  • 服务商获取小程序收款商户提现页面
  • 服务商获取服务商提现页面
  • 服务商获取合作方提现页面
  • 订单推送
  • 抖店绑定
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 获取账户余额页面链接,通过页面可查询余额及发起提现。

    使用限制

    无

    接口说明

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

    基本信息

    基本信息

    HTTP URL

    https://developer.toutiao.com/api/apps/ecpay/saas/add_sub_merchant

    HTTP Method

    POST

    接口频次

    20QPS(thirdparty_id维度)

    请求头

    名称

    类型

    必填

    描述

    Content-Type

    string

    是

    固定值 "application/json"

    请求参数

    名称

    类型

    是否必填

    最大长度

    描述

    示例值

    sub_merchant_id

    string

    是

    128

    商户 id,用于接入方自行标识并管理进件方。由开发者自行分配管理

    69560322266147130860

    thirdparty_id

    string

    是

    64

    小程序第三方平台应用 id

    ttc4a3b2154b83622f

    url_type

    number

    是

    -

    链接类型枚举值:

    2: 账户余额页(可以发起提现)

    3: 提现记录页

    2

    sign

    string

    是

    344

    签名,详见签名DEMO

    e42310f3f23c1d52624f24ad3cdea7c4

    prod_id

    number

    否

    -

    商户号对应的支付解决方案

    1:担保支付|普通版

    2:担保支付|企业版

    不传默认为1

    2

    role

    number

    否


    prod_id=2的情况下使用,商户号对应的角色

    1:收款商户(可以收款也可以接收分账)

    2:商户的合作方(只可以接收分账)

    不传默认为2

    2

    请求示例

    { "sign": "e42310f3f23c1d52624f24ad3cdea7c4", "sub_merchant_id": "69560322266147130860", "thirdparty_id": "ttc4a3b2154b83622f", "url_type": 2, "prod_id": 2, "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

    小程序平台分配商户号,用于支付、分账等环节标识商户

    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

    2042

    小程序appid无效,请检查app_id字段

    检查appid字段信息是否有误

    2047

    服务商id无效,请检查thirdparty_id字段

    检查thirdparty_id字段信息是否有误

    2048

    未查询到服务商与小程序的授权关系

    检查服务商和小程序是否有授权关系

    4000

    商户号和小程序/应用ID不对应

    检查app_id和merchant_id是否对应

    4002

    有效信息不足,请再次输入

    请查看自己满足的条件的查询参数是否正确