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

    使用限制

    无

    接口说明

    资金到账时间取决于银行或渠道的系统处理时效,一般情况下从发起提现到实际到账时间约 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

    请求示例

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

    响应参数

    公共响应参数

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

    错误码

    错误码
    描述
    排查建议
    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
    有效信息不足,请再次输入
    请查看自己满足的条件的查询参数是否正确
    ​