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

    使用限制

    无

    接口说明

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