抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 评价
  • 交易工具
  • 信用免押
  • 通用参数
  • 信用授权
  • 信用准入查询
  • 信用下单
  • 信用订单撤销
  • 信用订单完结
  • 信用下单结果通知
  • 信用订单查询
  • 扣款
  • 退款
  • 结算
  • 周期代扣
  • 交易系统
  • 担保支付(即将下线)
  • 抖店绑定
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 信用准入查询

    收藏
    我的收藏

    接口说明

    该接口用于判断用户是否满足信用免押条件,满足条件方可使用信用免押能力。

    1. 接口返回的 admissible_token 不可重复使用,一个 admissible_token 仅支持下一笔信用单。

    使用限制

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/api/trade_auth/v1/developer/query_admissible_auth/
    HTTP Method
    POST
    Scope
    trade_auth.developer.trade_auth
    权限要求

    请求参数

    请求头
    access-token必填String
    示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
    content-type必填String
    示例:application/json
    固定值"application/json"
    Body
    open_id必填String
    示例:"ffwqeqgyqwe312"

    用户open id

    scene必填Int64
    示例:1

    免押场景

    1-租车

    2-租物

    service_id必填String
    示例:"64"

    信用模板ID,请参考接入指南,首先完成进件,之后通过页面助手联系平台客服,相关信用免押客服会为您进行模板配置,模版配置完成后,会告知信用模板ID,此处的service_id即是该信用模板ID

    total_amount必填Int64
    示例:100

    需要交付的押金金额,单位分

    merchant_uidString
    示例:"71243123123"

    参考接入指南,完成进件之后可获取商户号信息,此处merchant_uid即是该卖家商户号

    请求示例
    curl --location --request POST 'https://open.douyin.com/api/trade_auth/v1/developer/query_admissible_auth' \ --header 'Content-Type: application/json' \ --header 'access-token: clt.xxx' \ --data-raw='{ "open_id" : "ffwqeqgyqwe312", "total_amount" : 100, "merchant_uid" : "71243123123", "service_id": "64", "scene": 1 }'

    响应参数

    Body展开全部子属性
    err_msg必填String
    示例:success

    错误提示

    err_no必填Int32
    示例:0

    错误码

    log_id必填String
    示例:2023010128382726

    抖音开平统一日志id

    dataStruct

    返回的数据信息,err_no为0 必填

    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "data": { "admissibility": 1, "admissible_token": "gwqegqwey13123", "expire_seconds": 1200 }, "err_no": 0, "err_msg": "success", "log_id": "2022092115392201020812109511046" }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20010000

    参数错误

    对照错误提示和接口字段定义,检查对应的参数

    20013000

    系统错误

    请重试,若多次重试仍然报错,请联系oncall

    20026006

    商户号与小程序的支付产品不一致

    检查是否开通了支付能力,未开通小程序支付能力,请先到小程序控制台开通支付能力

    20026008

    不支持使用老商户号,请使用新商户号

    使用商户号是老平台商户号,请切换使用新商户号

    20032007

    无该场景准入权限

    请检查对应小程序的服务类目

    1. 租车场景,需要小程序类目是交通出行-交通出行-租车
    2. 租物场景,需要小程序类目是生活服务-生活服务-租赁