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

    使用限制

    无

    接口说明

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

    基本信息

    基本信息
    HTTP URL
    HTTP Method
    POST
    Scope
    trade_basic.developer.merchant_saas
    权限要求
    不需要用户授权

    请求头

    名称
    类型
    必填
    描述
    Content-Type
    string
    是
    固定值 "application/json"
    access-token
    string
    是
    ​
    请求token,根据是否为服务商调用不同接口

    请求参数

    名称
    类型
    是否必填
    最大长度
    描述
    示例值
    component_access_token
    string
    是
    64
    授权码兑换接口调用凭证,链接
    8011210351
    thirdparty_component_id
    string
    是
    64
    小程序第三方平台应用 id
    ttc4a8b2155b82682f
    url_type
    number
    是
    -
    链接类型枚举值:
    2: 账户余额页(可以发起提现)
    3: 提现记录页
    2
    prod_id
    number
    否
    -
    商户号对应的支付解决方案
    不传默认为1
    2
    ​

    请求示例

    { "component_access_token": "08011210351", "thirdparty_component_id": "ttc4a8b2155b82682f", "url_type": 2, "prod_id": 2 }
    ​

    响应参数

    公共响应参数

    名称
    类型
    是否必填
    描述
    示例值
    err_no
    int64
    是
    状态码 0 代表业务处理成功,具体错误码参见后文错误码章节
    0
    err_msg
    string
    是
    错误提示信息
    success
    log_id
    string
    是
    抖音开平统一日志id
    data
    object
    否
    返回数据信息

    业务响应参数 data

    名称
    类型
    是否必填
    最大长度
    描述
    示例值
    url
    string
    是
    1024
    请求页面链接,24小时过期,注意定时更新,请勿长期保存。
    merchant_id
    string
    是
    50
    小程序平台分配商户号,用于支付、分账等环节标识商户
    69929319333434329240

    响应示例

    业务响应示例

    { "err_no": 0, "err_msg": "", "log_id": "202310061616226C30B180133AE61392D7", "data": { "merchant_id": "69929319333434329240", "url": "https://tp-pay.snssdk.com/embed-merchant/status?app_id=xxx&merchant_id=xxx&sign=3JAOS-KXjFwYybEIYXvdC52DBxESU2ru_d0Cb0wzt7beJdqxj9c3Ig903xfJ4te5o3SGoe2Z_ED7lXrcY3SjIJHdCch7vNaSWLYIG_L7tzEDydESvyV2IcK7IOs6tKlPqzZvaTr1McI_OAZKrhorcrHMspQgcyIEVR6aNW0Cn81N82CS6Nd3hM0QV05tBCkVwimaWOuG7_4PaTzaulgyWw&uid=xxx&uid_type=xxx" } }
    ​

    异常响应示例

    { "err_no": 28001008, "err_msg": "access_token过期,请刷新或重新授权", "log_id": "202310061616226C30B180133AE61392D7" }
    ​

    错误码

    错误码err_no
    描述err_msg
    排查建议
    0
    ""
    成功
    1005
    参数解析异常,请检查参数格式
    请查看参数的格式
    1006
    post 请求使用 json 传参
    请将参数改为Json传参,进行重试
    1007
    参数不合法,请检查参数
    检查请求参数,修改后重试
    2008
    ​
    token校验异常,请校验请求头中生成token的小程序appid/服务商id和请求参数是否一致
    请校验请求头中生成token的小程序appid/服务商id和请求参数是否一致
    2042
    小程序appid无效,请检查app_id字段
    检查appid字段信息是否有误
    2047
    服务商id无效,请检查thirdparty_id字段
    检查thirdparty_id字段信息是否有误
    2048
    未查询到服务商与小程序的授权关系
    检查服务商和小程序是否有授权关系
    4000
    商户号和小程序/应用ID不对应
    检查app_id和merchant_id是否对应
    4002
    有效信息不足,请再次输入
    请查看自己满足的条件的查询参数是否正确
    28001008
    access_token过期,请刷新或重新授权
    access_token过期,请根据请求头中token获取方式调用接口重新获取