查询订单可用门店
接口说明
查询该 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
抖音内部交易订单号,长度<64byte
poi_idString
示例:xxx
适用门店poi_id
请求示例
curl --location --request POST 'https://open.douyin.com/api/trade/v2/fulfillment/order_can_use/' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \ --data '{"poi_id":"xxx","biz_type":3782183390959241744,"voucher_can_use_info":{"par_certificate_ids":["vAq6OScysO"],"user_pay_amount":8644422371066586385,"offline_create_order_time":3764688935112155412},"order_id":"xxx"}'
响应参数
Body展开全部子属性
data必填Struct
返回数据信息
展开子属性
extra必填Struct
扩展信息
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20251217105337F5599157A216749D7DE7", "now": 1765940019 }, "data": { "certificates": [ { "times_card_info": { "total_times_serial_nums": [ 8943559627924485000 ], "total_times": 9218434630305035000, "usable_times": 3627048824680730000, "use_amount": 6205004031638470000, "times_card_type": 1, "used_times_serial_nums": [ 8930305439175011000 ], "locked_times_serial_nums": [ 8139068208769238000 ], "ladder_times_card_info": [ { "pay_amount": 7281141236651340000, "seq": 4526730720445789000, "status": 1, "crossed_amount": 7029957299229300000, "original_amount": 6571086799396262000, "ticket": 4759179716248417000, "merchant_ticket": 5100874257945896000 } ] }, "start_time": 6740194945612793000, "benefit_card_info": { "total_amount": { "benefit_amount": 8367592877520392000, "total_amount": 5559030848342669000, "principal_amount": 5000690139526869000 }, "left_amount": { "benefit_amount": 5498513065151887000, "total_amount": 7218909943264887000, "principal_amount": 3443718394800685000 } }, "lock_info_extra": { "lock_scene": 7276739300709270000, "lock_status": 8195756868796170000 }, "sku_info": { "sku_id": "11232", "title": "苹果15", "market_price": 8534327165345631000, "account_id": "1223232", "voucher_info": { "dynamic_par_rule_struct": { "dynamic_par_rule_desc": "1223232", "dynamic_par_min_amount": 8557187255710746000, "dynamic_par_max_amount": 4598485271904617000, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_start_time": "00:00", "use_end_time": "12:00", "end_time_is_next_day": false }, "deductible_amount": 5482214061411616000 } ] }, "voucher_type": 1 }, "spu_id": "11232", "out_id": "11232", "groupon_type": 1, "third_sku_id": "xxx", "sold_start_time": 3839053433813487000 }, "use_rule_info": { "available_date_info": { "days_of_week": [ 1 ], "available_date_type": 1, "day_duration": 1852203143928451000, "available_start_date": "xx", "available_end_date": "xx" }, "unavailable_date_info": { "enable": false, "days_of_week": [ 1 ], "holidays": [ 1 ], "date_list": [ "NmfxSfbdII" ], "holiday_dates": { "1": "HCYO3dI8Ke" } }, "available_time_info": { "available_time_type": 1, "time_period_list": [ { "use_end_time": "12:00", "end_time_is_next_day": false, "use_start_time": "00:00" } ] } }, "certificate_id": "11233", "is_transfer_asset": false, "amount": { "platform_ticket_amount": 6121736542926438000, "original_amount": 4354553640763461600, "pay_amount": 1754640600214487800, "merchant_ticket_amount": 7760880620908268000, "payment_discount_amount": 5833169293937310000, "coupon_pay_amount": 3730924134953697000 }, "code": "XX", "off_peak_discount_detail": { "off_peak_time_limit_type": 1, "off_peak_time": { "daily_time_range_list": [ { "end_time": "xx", "start_time": "xx" } ], "start_time": 7018551896604899000, "end_time": 2040983229100768000, "week_day_list": [ 7269620755124591000 ] }, "has_off_peak_discount": false }, "expire_time": 1167529205157585700 } ], "each_voucher_deduct_amount": 4793853545653070000, "order_id": "8763998", "can_use": false, "error_code": 0, "description": "" } }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100001 | 未知错误 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 更换参数 |
| 200 | 2119001 | 参数不合法 | 更换参数 |
| 200 | 2119002 | 系统繁忙,请稍候再试 | 重试 |
| 200 | 2119003 | 请求太过频繁,请稍后再试 | 重试 |
| 200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权,并在服务商后台同意授权 |
| 200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
| 200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
| 200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制,检查是否有测试环境在同步刷新token |
| 200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
| 200 | 28001005 | 系统内部错误,请重试 | 请求重试,若依然无解请向平台提交反馈 |
| 200 | 28001003 | access_token无效 | 重新请求生成access_token |
| 200 | 28001008 | access_token过期,请刷新或重新授权 | 重新请求生成access_token |
| 200 | 28001016 | 当前应用已被封禁或下线 | clientKey被封禁或者下线 |
| 200 | 28001006 | 网络调用错误,请重试 | 重试即可 |
| 200 | 28001014 | 应用未授权任何能力 | 确认应用是否授权能力 |
| 200 | 28001018 | 应用未获得该能力 | 开通相关能力 |
| 200 | 28003017 | quota已用完 | 联系平台处理 |
| 200 | 28001019 | 应用该能力已被封禁 | 该能力被封禁,联系平台处理 |
| 200 | 28001007 | 参数不合法 | 根据错误信息检查请求参数是否填写正常 |
| 200 | 4000001 | 根据实际 业务错误返回 | 补充参数 |
| 200 | 4000002 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 10000 | 参数错误 | 参数不符合规范。请根据提示检查参数。 |
| 200 | 13000 | 系统错误,请重试 | 内部错误,重试可解决。 |
| 200 | 11001 | 应用未获商家授权 | 请联系合作商家发起授权 |
| 200 | 3000001 | 以实际错误信息为准 | |
| 200 | 5000001 | 服务器打瞌睡了,请稍后再试。 |
