验券准备
收藏接口说明
抖音团购券码的核销, 需要先调用本接口, 查询订单的券列表，选择要验的券，再调用验券接口，核销券码。
- 抖音团购券码的核销，每次都需要先调用本接口，优先查询订单的券列表，选择要验的券，拿到加密券码encrypted_code，再调用验券接口，核销券码，验券准备和验券接口的调用次数需要一一对应，如已经调用验券接口验券成功，则当前二维码会失效，无法继续使用验券准备接口，需要使用刷新的二维码再进行调用。
- 二维码扫出来是一个短链，示例：https://v.douyin.com/eHHc1ft/ （注：短链的长度不固定，不要对长度做限制或截断，结尾不一定是/），扫码后并调用本接口可返回当前订单下可用的全部券码信息，如未返回券码信息，则说明该订单此刻无可用券码。
- 对短链做 HTTP 请求。得到对应的长链接是https://www.iesdouyin.com/share/commerce/coupon/I0ZwZEZpb2U1N0pjQVZxS2NJRTFSQW5WK1c4bmxvbnNWdUQ2Wk85Y1N0eHpRUFpMMmZwNTdFM2NKeWlFNDM2QT0/?schema_type=13&object_id=I0ZwZEZpb2U1N0pjQVZxS2NJRTFSQW5WK1c4bmxvbnNWdUQ2Wk85Y1N0eHpRUFpMMmZwNTdFM2NKeWlFNDM2QT0&utm_campaign=client_scan_share&app=aweme&utm_medium=ios&tt_from=scan_share&iid=&utm_source=scan_share。
- 链接中object_id参数的值即为本接口传入的 encrypted_data 参数 I0ZwZEZpb2U1N0pjQVZxS2NJRTFSQW5WK1c4bmxvbnNWdUQ2Wk85Y1N0eHpRUFpMMmZwNTdFM2NKeWlFNDM2QT0
请仅感知链接中的 object_id 参数。其他的参数、域名、路径等信息请不要感知。以后都有优化和调整的可能。
- 定期清理过期券，在清理前可以获取到已经过期的券，用此券核销会报错。
- 该接口只返回未使用状态的券信息。
- 该接口不返回明文券码，只返回加密券码
使用限制
SLA：支持的最大QPS:200;
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/fulfilment/certificate/prepare/ |
| HTTP Method | GET |
| Scope | life.capacity.fulfilment |
| 权限要求 |
路径：抖音开放平台 > 控制台 > 应用详情 > 解决方案
|
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Query展开全部子属性
account_idString
核销商户根账户ID（云连锁/共管场景下，挂靠商户必传，其余场景可不传）
can_verifyEnum
服务商收银版本号
展开子属性
codeString
券码明文
常见于使用用户提供的券码手动输入商家后台进行验券的场景
encrypted_data和code二选一必传，两个都不传会报错
encrypted_dataString
从二维码解析出来的标识
(传参前需要先进行URL编码，注意不要有空格)
encrypted_data和code二选一必传，两个都不传会报错
poi_idString
操作核销的抖音门店id（必传）
请求示例
curl --location --request GET 'https://open.douyin.com/goodlife/v1/fulfilment/certificate/prepare/?encrypted_data=pUZ76FALUu&code=bCjSu1Bndh&poi_id=V3UHCOYYVX&account_id=MWy8iu9jbK&can_verify=1' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'Rpc-Transit-Life-Account: OjW8c9F9FB' \
响应参数
Body展开全部子属性
data必填Struct
展开子属性
extra必填Struct
扩展信息
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "certificates": [ { "additional_map": { "1": "xu9p8gpwuk" }, "advance_purchase_struct": { "purchase_type": 1, "time_detail": [ { "time": 5223876507354159000, "time_type": 1 } ] }, "amount": { "brand_ticket_amount": 1208979147635155200, "coupon_pay_amount": 4067297288887143400, "list_market_amount": 5008630156274101000, "merchant_ticket_amount": 5405289060427306000, "origin_list_market_amount": 7451312873564242000, "original_amount": 1361409443160466400, "original_currency": "4lPy0j0c89", "pay_amount": 3055094501798941000, "payment_discount_amount": 3808379513409056000, "platform_discount_amount": 272143791925191140 }, "benefit_card_info": { "left_amount": { "benefit_amount": 1216418050886278000, "brand_discount_amount": 2799326506426539500, "merchant_discount_amount": 6818310823599994000, "pay_amount": 4259409702065950700, "payment_discount_amount": 5564697510781019000, "platform_discount_amount": 8334057692316615000, "principal_amount": 2290779546441120000, "provider_discount_amount": 5860476985664928000, "total_amount": 4300564497245835300 }, "total_amount": { "benefit_amount": 1757679787151587800, "brand_discount_amount": 1071892546013344800, "merchant_discount_amount": 250584335438876260, "pay_amount": 2007294318298097700, "payment_discount_amount": 7886459405429276000, "platform_discount_amount": 7112850625257526000, "principal_amount": 4115519042303600000, "provider_discount_amount": 2150663934699055400, "total_amount": 5383306993930165000 } }, "book_info": { "book_poi_id": "ptODLYJFjn", "book_product_number": 3627946885715138600, "verify_amount": 5399816130224446000 }, "buyer_reserve_info": { "credential_numb": "Na4lNoaIHP", "credential_type": 2411130096016508400, "name": "ENRyeWMddQ" }, "can_verify_status": 1, "certificate_id": 7790298007080665000, "code": "uT58UcQF3f", "deduction_info_list": [ { "groupon_type": 1, "source_amount": 105913502180523330, "source_brand_discount_amount": 8442121083121187000, "source_certificate_code": "vGbObkHDMk", "source_certificate_id": "3osiuTiYWk", "source_item_order_id": "slPUQPTPFN", "source_merchant_discount_amount": 8841686612563762000, "source_order_id": "nteCvNsVdB", "source_payment_discount_amount": 1576423829937779500, "source_platform_discount_amount": 1724970684771069200, "source_provider_discount_amount": 9184598030763474000, "source_selling_price": 2854158502673264600, "source_sku_id": 8963245496972176000, "source_sku_name": "IrIniBUduJ", "source_user_pay_amount": 1077189217862942100, "voucher_type": 1 } ], "dynamic_code_info": { "code_expire_time": "1GA6atxRyP" }, "encrypted_code": "wR82gawJ2B", "expire_time": 8270110189199443000, "not_available_poi_list": [ "cTzt0aS2jn" ], "not_available_time_info": { "can_no_use_date": [ { "end_time": 1420780711331897900, "start_time": 7195422388857350000 } ], "can_no_use_week_day": [ 2603294423027264500 ], "fulfil_enable": false }, "off_peak_discount_info": { "has_off_peak_discount": false, "idle_time_limit_type": 1, "off_peak_time_range": [ { "daily_time_range_list": [ { "end_time": "a8QoEuaZM3", "end_time_is_next_day": false, "start_time": "JSH3fH68pL" } ], "end_time": 4105847007352299000, "start_time": 253639777172103460, "week_day_list": [ 1 ] } ] }, "pay_bill_info": { "bill_amount": 3383657243616606700, "bill_total_amount": 2217155501640591400 }, "period_card": { "period_type": 1 }, "reserve_info": { "order_reserve_user_info_list": [ { "credential_numb": "qMfRQGd9R3", "credential_type": 1, "name": "8Ijjht7lVX", "phone": "wWUOS8zpjd" } ] }, "sku": { "account_id": "GxN06pEYp3", "groupon_type": 1, "market_price": 288497479176494600, "product_attr": { "bAAZ07xTZJ": "ynfIFyc2Pw" }, "product_id": "Hh34IDTlGG", "product_out_id": "zRSZOlwU6M", "sku_id": "FdwaG4wWkV", "sku_out_id": "TjlAJ8PScL", "sold_start_time": 4220399355328407000, "suplier_product_out_id": "b2m8tXIlb9", "third_sku_id": "XFnBRHnYIz", "title": "YmTP3BX6D0", "voucher_type": 1 }, "start_time": 8126088117050412000, "status": 1, "time_card": { "serial_amount_list": [ { "amount": { "brand_ticket_amount": 2392453591638200300, "coupon_pay_amount": 2839593806236475400, "list_market_amount": 9215961940959302000, "merchant_ticket_amount": 1960761161179715300, "origin_list_market_amount": 2231619768686089200, "original_amount": 8445509982281598000, "original_currency": "D8dV9KzUkX", "pay_amount": 2886369382241405000, "payment_discount_amount": 4609069681480502300, "platform_discount_amount": 169582081775690400 }, "serial_numb": 5284743807295489000 } ], "time_card_type": 1, "times_count": 6064828723705712000, "times_used": 8258812625871485000 }, "use_time_info": { "time_period_list": [ { "end_time": "uKA8rGKwwJ", "end_time_is_next_day": false, "start_time": "Xtbc5KCYGl" } ], "use_time_type": 1 }, "used_status_type": 1, "verify": { "can_cancel": false, "certificate_id": "cYcckZ22Ev", "poi_id": 8271962361926459000, "times_card_serial_num": 1876490384019885600, "verifier_unique_id": "qmvKdMeGSO", "verify_id": "LhHvTI7J2e", "verify_time": 982950604662289300, "verify_type": 1 }, "verify_records": [ { "can_cancel": false, "certificate_id": "xNoeyD9hwc", "poi_id": 8512701284644957000, "times_card_serial_num": 7091118004799545000, "verifier_unique_id": "4wCIqP8Fxw", "verify_id": "6Y7jG77DwZ", "verify_time": 8830654285095728000, "verify_type": 1 } ] } ], "certificates_v2": [ { "additional_map": { "1": "aoy4Yp9qbS" }, "advance_purchase_struct": { "purchase_type": 1, "time_detail": [ { "time": 3806427862829176300, "time_type": 1 } ] }, "amount": { "brand_ticket_amount": 1499548246392841000, "coupon_pay_amount": 7660242826184338000, "list_market_amount": 8401799447351121000, "merchant_ticket_amount": 8197555310932978000, "origin_list_market_amount": 5128170749841561000, "original_amount": 5165810220757059000, "original_currency": "YgSGKJCKM2", "pay_amount": 2557150002035132400, "payment_discount_amount": 8864076599927357000, "platform_discount_amount": 4038900034666746400 }, "benefit_card_info": { "left_amount": { "benefit_amount": 8427081295982012000, "brand_discount_amount": 2996004204027581400, "merchant_discount_amount": 3560841456244805000, "pay_amount": 2541794861173372400, "payment_discount_amount": 2477959348236265500, "platform_discount_amount": 1020488922041373600, "principal_amount": 3355133816099237400, "provider_discount_amount": 6540330114889517000, "total_amount": 4960659135942711000 }, "total_amount": { "benefit_amount": 6026400082617572000, "brand_discount_amount": 7680202259299522000, "merchant_discount_amount": 3442438765028036000, "pay_amount": 1300431366643788800, "payment_discount_amount": 7242928786815942000, "platform_discount_amount": 3944042843524848000, "principal_amount": 3861817211960225300, "provider_discount_amount": 4928183430814847000, "total_amount": 2815228115513127400 } }, "book_info": { "book_poi_id": "s5xW2epwUr", "book_product_number": 3647590109625902600, "verify_amount": 5993847434342876000 }, "buyer_reserve_info": { "credential_numb": "qZlmajhLMV", "credential_type": 4033982703888592000, "name": "uhalGyvuFq" }, "can_verify_status": 1, "certificate_id": 6310706485736735000, "code": "6D625TRf5l", "deduction_info_list": [ { "groupon_type": 1, "source_amount": 6827587232012981000, "source_brand_discount_amount": 5575425549104147000, "source_certificate_code": "K3jmgK7Cde", "source_certificate_id": "wDJCZZprIo", "source_item_order_id": "Y94deBB3Ra", "source_merchant_discount_amount": 2594830132433474000, "source_order_id": "75zYnEd1WW", "source_payment_discount_amount": 1322642587544296200, "source_platform_discount_amount": 3197406023232427000, "source_provider_discount_amount": 3781532254692715000, "source_selling_price": 4066358845532232700, "source_sku_id": 9206229554250727000, "source_sku_name": "0uvpxEecMR", "source_user_pay_amount": 2211924728568069400, "voucher_type": 1 } ], "dynamic_code_info": { "code_expire_time": "0ABHvjE0Ge" }, "encrypted_code": "ywSPXd4Gy7", "expire_time": 8068809513969492000, "not_available_poi_list": [ "H7Joiftsbk" ], "not_available_time_info": { "can_no_use_date": [ { "end_time": 9162570277885515000, "start_time": 6119583402901976000 } ], "can_no_use_week_day": [ 6196305452392001000 ], "fulfil_enable": false }, "off_peak_discount_info": { "has_off_peak_discount": false, "idle_time_limit_type": 1, "off_peak_time_range": [ { "daily_time_range_list": [ { "end_time": "DvjKfBHIaU", "end_time_is_next_day": false, "start_time": "Pf11Fjsn0y" } ], "end_time": 9129714840118974000, "start_time": 6140466173104121000, "week_day_list": [ 1 ] } ] }, "pay_bill_info": { "bill_amount": 2111698659549665800, "bill_total_amount": 3021647480635433500 }, "period_card": { "period_type": 1 }, "reserve_info": { "order_reserve_user_info_list": [ { "credential_numb": "3ZtRK7dB5j", "credential_type": 1, "name": "IqPQRfFLRP", "phone": "qTwLfDbhgx" } ] }, "sku": { "account_id": "ndzttLulRX", "groupon_type": 1, "market_price": 8050776722804286000, "product_attr": { "7nW4PRhcZR": "ii37ftVmTb" }, "product_id": "f4aVoKp8XL", "product_out_id": "252J1xLuqQ", "sku_id": "KfqycyTzfG", "sku_out_id": "jn7f3BLiGm", "sold_start_time": 3568215344061065000, "suplier_product_out_id": "U0gzWCvXOg", "third_sku_id": "MIkC5vTd8j", "title": "wRYiA3IejJ", "voucher_type": 1 }, "start_time": 2400888700095059000, "status": 1, "time_card": { "serial_amount_list": [ { "amount": { "brand_ticket_amount": 6199705843378755000, "coupon_pay_amount": 1165895421992537600, "list_market_amount": 1269607373859610600, "merchant_ticket_amount": 2644699295299763700, "origin_list_market_amount": 2569327571928523300, "original_amount": 4160098126425182700, "original_currency": "Z0zTuCh3Xu", "pay_amount": 6090926534895263000, "payment_discount_amount": 7133805151865342000, "platform_discount_amount": 2889018832069332000 }, "serial_numb": 2379314719490938000 } ], "time_card_type": 1, "times_count": 3972857464630579000, "times_used": 6493079592284388000 }, "use_time_info": { "time_period_list": [ { "end_time": "l2zslPa7HK", "end_time_is_next_day": false, "start_time": "GOt61QUf7W" } ], "use_time_type": 1 }, "used_status_type": 1, "verify": { "can_cancel": false, "certificate_id": "OM1qgCBGIQ", "poi_id": 1285966444998413600, "times_card_serial_num": 5772313340397038000, "verifier_unique_id": "o51VY21bjD", "verify_id": "XqDO3nkbpF", "verify_time": 6289820340110612000, "verify_type": 1 }, "verify_records": [ { "can_cancel": false, "certificate_id": "aZIGgmIKXK", "poi_id": 7672990466522647000, "times_card_serial_num": 1718751251615591700, "verifier_unique_id": "QBNbJGer6E", "verify_id": "lm7Seb22Dy", "verify_time": 5878539451694766000, "verify_type": 1 } ] } ], "order_id": "L5tx4A0moD", "verify_token": "ior2R5QUPc" }, "extra": { "description": "kwQbOLeEUI", "error_code": 1265397229082233000, "logid": "dFhf1vpJ8v", "now": 4187775487904259600, "sub_description": "sO0FOwJdaS", "sub_error_code": 4965541051308959000 } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
| 200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
| 200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制，检查是否有测试环境在同步刷新token |
| 200 | 2119001 | 参数不合法 | 更换参数 |
| 200 | 2119002 | 系统繁忙，请稍候再试 | 重试 |
| 200 | 2119003 | 请求太过频繁，请稍后再试 | 重试 |
| 200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权，并在服务商后台同意授权 |
| 200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 4000001 | 根据实际业务错误返回 | 补充参数 |
| 200 | 4000002 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
| 200 | 3000002 | 核销门店错误 | 检查核销门店重试 |
| 200 | 2100001 | 未知错误 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙，此时请开发者稍候再试 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 更换参数 |
| 200 | 5000009 | 实名信息查询失败，请重试查询 | |
| 200 | 3000002 | 以实际错误信息为准 | |
| 200 | 5000001 | 服务器打瞌睡了，请稍后再试。 | |
| 200 | 3000001 | 以实际错误信息为准 | |
| 200 | 3000001 | 请求过于频繁，请稍后再试 | 重试解决 |
