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

    使用限制

    无

    接口说明

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

    基本信息

    基本信息

    HTTP URL

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

    HTTP Method

    POST

    接口频次

    20QPS(thirdparty_component_id维度)

    请求参数

    名称

    类型

    是否必填

    最大长度

    描述

    示例值

    component_access_token

    string

    是

    64

    授权码兑换接口调用凭证,获取第三方应用接口调用凭据

    8011210351

    thirdparty_component_id

    string

    是

    64

    小程序第三方平台应用 id

    ttc4a8b2155b82682f

    url_type

    number

    是

    -

    链接类型枚举值:

    1: 进件页面

    1

    prod_id

    number

    否

    -

    需要进件的支付解决方案

    1:担保支付|普通版

    2:担保支付|企业版

    不传默认为1


    注意:在同一种支付解决方案下的商户号才可以互相分账

    2

    请求示例

    { "component_access_token": "08011210351", "thirdparty_component_id": "ttc4a8b2155b82682f", "url_type": 1, "prod_id": 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

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

    69929319333434329240

    响应示例

    业务响应示例

    { "err_no": 0, "err_tips": "", "merchant_id": "69929319333434329240", "url": "https://tp-pay.snssdk.com/embed-merchant/status?app_id=xxx\u0026merchant_id=xxx\u0026sign=3JAOS-KXjFwYybEIYXvdC52DBxESU2ru_d0Cb0wzt7beJdqxj9c3Ig903xfJ4te5o3SGoe2Z_ED7lXrcY3SjIJHdCch7vNaSWLYIG_L7tzEDydESvyV2IcK7IOs6tKlPqzZvaTr1McI_OAZKrhorcrHMspQgcyIEVR6aNW0Cn81N82CS6Nd3hM0QV05tBCkVwimaWOuG7_4PaTzaulgyWw\u0026uid=xxx\u0026uid_type=xxx" }

    异常响应示例

    { "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

    4000

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

    检查app_id和merchant_id是否对应

    4002

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

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