• OpenAPI 简介
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 通用能力
  • 生活服务交易系统(全融合版)
  • 生活服务交易系统(账号融合版)
  • 错误码和返回码
  • 通用参数
  • 预约
  • 查询接口
  • 预下单
  • 营销算价
  • 支付
  • 核销
  • 抖音码
  • 三方码
  • 核销工具
  • 查询用户券列表
  • 查询订单可用门店
  • 券核销消息通知
  • 撤销核销消息通知
  • 设置商家展示信息
  • 查询商家配置文案
  • 设置订单详情页按钮白名单接口
  • 设置小程序跳转path
  • 原生券信息查询
  • 【核销】核销原生券(简化版独有)
  • 【核销】加解锁(简化版独有)
  • 推结算状态
  • 分账
  • 退货退款
  • poi基础能力
  • CPS佣金设置与查询
  • 核销工具解决方案
  • 历史版本(不推荐使用)
  • 垂直行业
  • 其它
  • 接口说明

    查询该 order_id 在该门店下是否可用,可用则返回相应信息。​ 请求头通用参数请参考:通用参数

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/api/trade/v2/fulfillment/order_can_use/
    HTTP Method
    POST
    Scope
    industry_open.trade.certificate_query
    权限要求

    核销工具类小程序才能调用此api。 核销工具类小程序需要有对应订单的商家(account_id)的授权关系才能查询​

    请求参数

    请求头
    access-token必填String
    示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
    content-type必填String
    固定值"application/json"
    Rpc-Transit-Life-AccountString

    来客商户根账户ID

    Body
    order_id必填String
    示例:xxx
    抖音内部交易订单号,长度<64byt>
    poi_idString
    示例:xxx
    适用门店poi_id​
    请求示例
    curl --location --request POST 'https://open.douyin.com/api/trade/v2/fulfillment/order_can_use/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"voucher_can_use_info":{"par_certificate_ids":["i8DCkEpMCf"],"user_pay_amount":958900062928667861,"offline_create_order_time":2414496863862696189},"order_id":"xxx","poi_id":"xxx","biz_type":456534811703598091}'

    响应参数

    Body展开全部子属性
    data必填Struct
    返回数据信息
    展开子属性
    extra必填Struct
    额外信息​
    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20250120142328F57167E7E766C8B22958", "now": 1737354208 }, "data": { "each_voucher_deduct_amount": 3502076303307680000, "order_id": "8763998", "can_use": false, "certificates": [ { "start_time": 7364280240607613000, "certificate_id": "11233", "code": "XX", "expire_time": 6519169060968937000, "is_transfer_asset": false, "amount": { "original_amount": 8682711436252625000, "pay_amount": 283896556325878750, "merchant_ticket_amount": 7898006442609448000, "payment_discount_amount": 1675480697285602600, "coupon_pay_amount": 6043896511021113000, "platform_ticket_amount": 8070773404419971000 }, "lock_info_extra": { "lock_status": 8757934672061404000, "lock_scene": 2138117073684340700 }, "times_card_info": { "total_times_serial_nums": [ 1601672552754609700 ], "used_times_serial_nums": [ 4009549705414924000 ], "locked_times_serial_nums": [ 7037649497942428000 ], "ladder_times_card_info": [ { "pay_amount": 8138004448866328000, "seq": 1573767660962552600, "status": 1, "crossed_amount": 7323793047924460000, "original_amount": 7918147446391665000, "ticket": 6739008777190889000, "merchant_ticket": 2633027886951963000 } ], "total_times": 3812926793726191000, "usable_times": 2286203989085042700, "use_amount": 2642966784579601400 }, "off_peak_discount_detail": { "off_peak_time_limit_type": 1, "off_peak_time": { "start_time": 3602327842036652000, "end_time": 6293332346091203000, "week_day_list": [ 5512149402320162000 ], "daily_time_range_list": [ { "start_time": "xx", "end_time": "xx" } ] }, "has_off_peak_discount": false }, "sku_info": { "spu_id": "11232", "voucher_info": { "voucher_type": 1, "dynamic_par_rule_struct": { "dynamic_par_rule_desc": "1223232", "dynamic_par_min_amount": 3594534913159929000, "dynamic_par_max_amount": 6201038990313873000, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_end_time": "12:00", "end_time_is_next_day": false, "use_start_time": "00:00" }, "deductible_amount": 1953816173152767000 } ] } }, "sku_id": "11232", "groupon_type": 1, "account_id": "1223232", "sold_start_time": 4590660425796336000, "out_id": "11232", "third_sku_id": "xxx", "market_price": 7686526658307426000, "title": "苹果15" } } ], "error_code": 0, "description": "" } }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    2002100001
    未知错误
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100004
    系统繁忙,此时请开发者稍候再试
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100005
    参数不合法
    更换参数
    2002119001
    参数不合法
    更换参数
    2002119002
    系统繁忙,请稍候再试
    重试
    2002119003
    请求太过频繁,请稍后再试
    重试
    2002119005
    应用未获商家授权
    联系合作商家在商家后台发起授权,并在服务商后台同意授权
    2002190002
    access_token无效
    调用接口重新生成access_token
    2002190004
    应用未获得该能力, 请去https://open.douyin.com/申请
    应用申请接口权限
    2002190008
    access_token过期,请刷新或重新授权
    规范token刷新机制,检查是否有测试环境在同步刷新token
    2003000001
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2005000001
    根据实际业务错误返回
    联系抖音处理
    20028001005
    系统内部错误,请重试
    请求重试,若依然无解请向平台提交反馈
    20028001003
    access_token无效
    重新请求生成access_token
    20028001008
    access_token过期,请刷新或重新授权
    重新请求生成access_token
    20028001016
    当前应用已被封禁或下线
    clientKey被封禁或者下线
    20028001006
    网络调用错误,请重试
    重试即可
    20028001014
    应用未授权任何能力
    确认应用是否授权能力
    20028001018
    应用未获得该能力
    开通相关能力
    20028003017
    quota已用完
    联系平台处理
    20028001019
    应用该能力已被封禁
    该能力被封禁,联系平台处理
    20028001007
    参数不合法
    根据错误信息检查请求参数是否填写正常
    2004000001
    根据实际业务错误返回
    补充参数
    2004000002
    根据实际业务错误返回
    对照接口文档规范参数并重试
    20010000
    参数错误​
    参数不符合规范。请根据提示检查参数。​
    20013000
    系统错误,请重试​
    内部错误,重试可解决。​
    20011001
    应用未获商家授权​
    请联系合作商家发起授权​
    2005000001
    服务器打瞌睡了,请稍后再试。
    2003000001
    以实际错误信息为准