券状态查询
收藏接口说明
支持对抖音码团购、代金券、次卡、储值卡、周期卡、预约品、提货券、惠享卡等全品类券码进行状态查询；常用于核销异常排查、券状态查询等场景。
使用限制
SLA：支持的最大QPS:35;
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/fulfilment/certificate/get/ |
| HTTP Method | GET |
| Scope | life.capacity.fulfilment |
| 权限要求 | 团购核销 1.需要申请权限 路径：抖音开放平台-开发者平台/服务 商平台>控制台>应用详情>解决方案 2.需要商家授权，路径：抖音来客>店铺管理>第三方应用授权 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Query
encrypted_code必填String
验券准备接口返回的加密券码
(传参前需要先进行URL编码，注意不要有空格，请求参数 encrypted_code 必须取自「验券准备」接口的实时返回值，不接受券码明文)
account_idString
核销商户根账户ID（云连锁场景接入需传入，其余场景可不传）
请求示例
curl --location --request GET 'https://open.douyin.com/goodlife/v1/fulfilment/certificate/get/?encrypted_code=4Qee4rcwTP&account_id=K14PmsbHFv' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \
响应参数
Body展开全部子属性
data必填Struct
团购券的信息
展开子属性
extra必填Struct
扩展信息
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20260630161900401A63399461491C07E8", "now": 1782807540 }, "data": { "certificate": { "not_available_time_info": { "fulfil_enable": false, "can_no_use_week_day": [ 1442887441879414000 ], "can_no_use_date": [ { "start_time": 5296476007029787000, "end_time": 9040650017580988000 } ] }, "book_info": { "book_product_number": 5065320580077281000, "verify_amount": 2279888085923126300, "book_poi_id": "pEfQp1mF8S" }, "code": "BRtslQlDaj", "additional_map": { "1": "kJLZT1A9fR" }, "cancel_verify_records": [ { "verify_time": 7424732579185846000, "verify_type": 1, "verifier_unique_id": "0ZAdMunznH", "times_card_serial_num": 7899630072643026000, "extra": { "open_order_id": "W0nMKvOIVF" }, "certificate_id": "ZeKbN3e4Ot", "can_cancel": false, "verify_id": "4bGMs19uhQ", "poi_id": 5517262999401167000, "benefit_amount": { "benefit_amount": 7872202512448733000, "platform_discount_amount": 3989239565195628500, "provider_discount_amount": 5716023319738609000, "pay_amount": 3789344497289728500, "principal_amount": 2681978209259107000, "payment_discount_amount": 941003987027988200, "brand_discount_amount": 8654557188869028000, "total_amount": 2570423710855964700, "merchant_discount_amount": 3896502571789100500 } } ], "sku": { "title": "fWmihARgzo", "suplier_product_out_id": "9FcrAdYJqz", "market_price": 355970602849912200, "sold_start_time": 6000340798158946000, "product_id": "CeAr8NL2Mr", "product_attr": { "uDsgkLf6Ff": "KJxHHkK74O" }, "sku_id": "UnIb3FQmYG", "voucher_type": 1, "sku_out_id": "bKZzUgypar", "groupon_type": 1, "account_id": "cscWI0rGNm", "third_sku_id": "XdZZPyDJoY", "product_out_id": "JNzKg5oEBS" }, "buyer_reserve_info": { "enc_name": "OYLNNQgKVY", "credential_numb": "Xh1OR7yqn1", "credential_type": 8366756574125043000, "name": "lNJXXuGTdJ", "enc_credential_numb": "D437qninnl" }, "verify_records": [ { "verify_id": "Rl6a2VwLjE", "verify_time": 7772128526893142000, "verifier_unique_id": "jhSQ6R3TRs", "can_cancel": false, "poi_id": 2817371834012518000, "benefit_amount": { "total_amount": 2495188831159122000, "pay_amount": 7256185924315753000, "brand_discount_amount": 3256986411988152000, "principal_amount": 1498480839288230400, "payment_discount_amount": 3686685239742194700, "provider_discount_amount": 6074203146124911000, "merchant_discount_amount": 4433561257550892000, "benefit_amount": 111810491263065470, "platform_discount_amount": 6257875051871100000 }, "extra": { "open_order_id": "ixR99vAlBy" }, "certificate_id": "TTOVnPmU1l", "times_card_serial_num": 5338958671796920000, "verify_type": 1 } ], "dynamic_code_info": { "code_expire_time": "jlQ7aHJEgS" }, "reserve_info": { "order_reserve_user_info_list": [ { "credential_type": 1, "name": "uae1QbFL0Q", "phone": "JVCZWvXbqR", "credential_numb": "cCLnv5itVB" } ] }, "encrypted_code": "9RjIGIDtRr", "period_card": { "period_type": 1 }, "can_verify_status": 1, "time_card": { "times_used": 6773071205457943000, "serial_amount_list": [ { "serial_numb": 1528718526573145000, "amount": { "original_currency": "NKQmEC8Xk9", "origin_list_market_amount": 1205412390686157300, "original_amount": 3424705236333622300, "pay_amount": 5277873498983855000, "platform_discount_amount": 8666553639941314000, "brand_ticket_amount": 175328975393913630, "coupon_pay_amount": 6362001398944610000, "list_market_amount": 568729364787306240, "payment_discount_amount": 4802149896665628000, "merchant_ticket_amount": 1439260272211870700 } } ], "time_card_type": 1, "times_count": 5083972677008844000 }, "verify": { "times_card_serial_num": 630526403952627100, "certificate_id": "ai2XGEeImU", "benefit_amount": { "payment_discount_amount": 6368577506504286000, "total_amount": 6671761429764056000, "brand_discount_amount": 7867127992042923000, "principal_amount": 1943393272445230600, "platform_discount_amount": 1610055487513081000, "provider_discount_amount": 6129144233385429000, "pay_amount": 6922986827848375000, "benefit_amount": 3327542847565290500, "merchant_discount_amount": 3288907209386068000 }, "can_cancel": false, "verify_id": "gcUfTpVQ63", "verify_time": 4756990185383233000, "extra": { "open_order_id": "YFpMJ06yMn" }, "verifier_unique_id": "MtwuzSKiye", "verify_type": 1, "poi_id": 8796733993236326000 }, "pay_bill_info": { "bill_total_amount": 2941330615074191000, "bill_amount": 8844253797333826000, "order_source": 1 }, "amount": { "coupon_pay_amount": 4509109465141969000, "platform_discount_amount": 2429746257006416000, "brand_ticket_amount": 3311863398247811000, "list_market_amount": 5341455932888087000, "merchant_ticket_amount": 5277386905082857000, "payment_discount_amount": 267400931414233440, "original_currency": "MGDgTh0Pce", "origin_list_market_amount": 7069417022662573000, "original_amount": 3505201270213284400, "pay_amount": 4004445756465508400 }, "start_time": 3946889814897287700, "status": 1, "deduction_info_list": [ { "source_selling_price": 5608237585781915000, "is_one_time_buy": false, "source_order_id": "OEYBVdLd5i", "order_source": 1, "groupon_type": 1, "source_user_pay_amount": 4137938938385454600, "source_payment_discount_amount": 2294740106773557000, "source_sku_name": "8ywq43wKuv", "source_merchant_discount_amount": 4679927309226487000, "source_provider_discount_amount": 6942876735749583000, "source_certificate_id": "hGCCM2BW28", "source_amount": 6439990168573143000, "voucher_type": 1, "source_brand_discount_amount": 9170866701974466000, "source_sku_id": 1688083771767986200, "source_item_order_id": "bArt388fhH", "source_platform_discount_amount": 7099745582649417000, "source_certificate_code": "nRurh25nuH" } ], "use_time_info": { "use_time_type": 1, "time_period_list": [ { "end_time_is_next_day": false, "start_time": "eJaTZQYND2", "end_time": "rGGMvk44Je" } ] }, "used_status_type": 1, "off_peak_discount_info": { "idle_time_limit_type": 1, "has_off_peak_discount": false, "off_peak_time_range": [ { "daily_time_range_list": [ { "end_time": "GN0J19eG8M", "end_time_is_next_day": false, "start_time": "5dtvVjNBfE" } ], "week_day_list": [ 1 ], "start_time": 2141829069665749500, "end_time": 459535903709402240 } ] }, "not_available_poi_list": [ "Ab6tikiOpo" ], "expire_time": 1883169683022231300, "benefit_card_info": { "left_amount": { "brand_discount_amount": 3140894997477067300, "total_amount": 3412073768152072700, "merchant_discount_amount": 4536627509936289300, "payment_discount_amount": 2343468238440768500, "pay_amount": 5877514871340186000, "platform_discount_amount": 4654655007300566000, "benefit_amount": 2780875870830163500, "provider_discount_amount": 3186588258147047000, "principal_amount": 6486751134864989000 }, "total_amount": { "payment_discount_amount": 5228355844881536000, "total_amount": 3304224294986880500, "pay_amount": 4437201016838823000, "benefit_amount": 4970781702461659000, "merchant_discount_amount": 180089087502448300, "brand_discount_amount": 6920427756708167000, "principal_amount": 6994112258939379000, "platform_discount_amount": 7558960617998516000, "provider_discount_amount": 2898771643877452300 } }, "advance_purchase_struct": { "purchase_type": 1, "time_detail": [ { "time": 3861769287939014000, "time_type": 1 } ] }, "certificate_id": 7782999128140373000 }, "certificate_v2": { "verify": { "verify_type": 1, "benefit_amount": { "payment_discount_amount": 4401649257390616600, "merchant_discount_amount": 6110387549067696000, "benefit_amount": 8213514865594896000, "total_amount": 2412154585714682400, "platform_discount_amount": 2215456667882622000, "provider_discount_amount": 7738645763458949000, "pay_amount": 5025345646353474000, "brand_discount_amount": 6678106895223082000, "principal_amount": 6238871775768723000 }, "verify_id": "sHiLjYMmU5", "verifier_unique_id": "s5D7DvMnoQ", "times_card_serial_num": 3228870003591234000, "can_cancel": false, "certificate_id": "ps0BJBNAAU", "extra": { "open_order_id": "2gW1vuwGfb" }, "poi_id": 3014374491432861000, "verify_time": 2061306058424402200 }, "deduction_info_list": [ { "source_certificate_code": "PUU2E4jEbV", "source_order_id": "ZBPmwCd6np", "groupon_type": 1, "source_merchant_discount_amount": 4980003226002300000, "source_brand_discount_amount": 395506545436779400, "order_source": 1, "source_payment_discount_amount": 351181907462867650, "source_sku_id": 3552824045030529500, "source_certificate_id": "luGOETnfjS", "source_platform_discount_amount": 5327124498057120000, "source_user_pay_amount": 2545533353371834400, "source_sku_name": "xc3BDpYUC3", "source_selling_price": 7196497981204869000, "source_amount": 2200878271934838000, "source_item_order_id": "RKstWbBeIh", "voucher_type": 1, "source_provider_discount_amount": 4291673600477812000, "is_one_time_buy": false } ], "cancel_verify_records": [ { "poi_id": 7945200247037414000, "verify_time": 2066297878662291000, "times_card_serial_num": 3086747361752857000, "can_cancel": false, "verify_id": "o1A5Gjhi1A", "extra": { "open_order_id": "B5HGiN7Q8c" }, "benefit_amount": { "payment_discount_amount": 325727928317258050, "benefit_amount": 2125507008540087600, "platform_discount_amount": 3710854703786636300, "provider_discount_amount": 5673698650930437000, "pay_amount": 3199563586953489000, "brand_discount_amount": 5595260924460417000, "merchant_discount_amount": 5746695915604323000, "principal_amount": 3193245688790225000, "total_amount": 8243249587589754000 }, "certificate_id": "lG6YvRvhhQ", "verifier_unique_id": "fMqeWc9Anv", "verify_type": 1 } ], "expire_time": 5492735216601039000, "reserve_info": { "order_reserve_user_info_list": [ { "phone": "lS0UfyMcPY", "credential_numb": "B0xZDPOOLS", "credential_type": 1, "name": "qDtB0fpXIH" } ] }, "used_status_type": 1, "advance_purchase_struct": { "purchase_type": 1, "time_detail": [ { "time": 8985713143171602000, "time_type": 1 } ] }, "book_info": { "verify_amount": 4569081834603703300, "book_poi_id": "qmQO27fruS", "book_product_number": 7205461453539860000 }, "sku": { "market_price": 6895727071840709000, "third_sku_id": "5F5Pe6hUHl", "account_id": "3CyQXgzL91", "sku_out_id": "dzgfXAXcIt", "voucher_type": 1, "product_out_id": "sndTba5Inr", "suplier_product_out_id": "WuUKAgXjp0", "product_attr": { "lQPAMeFwVB": "ijziCX7H8t" }, "sku_id": "2MRExwyFtM", "sold_start_time": 5744583976898009000, "product_id": "DBXoWjV32M", "groupon_type": 1, "title": "3kiyEtSUOm" }, "use_time_info": { "use_time_type": 1, "time_period_list": [ { "start_time": "52JV5jNwR4", "end_time": "PpSwfRmOKg", "end_time_is_next_day": false } ] }, "additional_map": { "1": "8cBzEXSQxi" }, "pay_bill_info": { "bill_amount": 8404504958148700000, "order_source": 1, "bill_total_amount": 1756092309343196000 }, "status": 1, "period_card": { "period_type": 1 }, "start_time": 2993588533259811000, "not_available_poi_list": [ "4dPRDdIu4v" ], "encrypted_code": "PiCAXAn4Ca", "certificate_id": 1635536397188263700, "verify_records": [ { "verify_id": "mDibzyncxL", "can_cancel": false, "verify_type": 1, "verify_time": 2993992143090269700, "benefit_amount": { "pay_amount": 3769071134301438500, "benefit_amount": 825280895546524300, "platform_discount_amount": 4093369035380211700, "merchant_discount_amount": 4834523740930782000, "total_amount": 1546341316623448300, "provider_discount_amount": 3047182188023153000, "principal_amount": 7161901342597910000, "brand_discount_amount": 3448654867369317000, "payment_discount_amount": 6108279086873790000 }, "certificate_id": "U2lngCuZTo", "extra": { "open_order_id": "mDnV8ocQvr" }, "verifier_unique_id": "x8Isz2t6a4", "times_card_serial_num": 7023276133661875000, "poi_id": 3964208114253232000 } ], "not_available_time_info": { "can_no_use_week_day": [ 1576647595263340500 ], "can_no_use_date": [ { "start_time": 9160315185026917000, "end_time": 4102436595220514300 } ], "fulfil_enable": false }, "code": "eeC204nXQ1", "buyer_reserve_info": { "enc_credential_numb": "SUQLSRHBxZ", "enc_name": "bdvWajpPAh", "credential_numb": "vxhvcJoKIH", "credential_type": 8622747142802312000, "name": "d8sAig1bJH" }, "time_card": { "serial_amount_list": [ { "serial_numb": 8724200393262646000, "amount": { "merchant_ticket_amount": 22100325170907964, "original_amount": 261729750899705470, "platform_discount_amount": 7647000055953168000, "coupon_pay_amount": 6960994456308261000, "list_market_amount": 3998533705041315000, "original_currency": "i84gherod2", "pay_amount": 2799738879564715000, "brand_ticket_amount": 5043328575178608000, "origin_list_market_amount": 1949526856978336500, "payment_discount_amount": 4760109963208396000 } } ], "time_card_type": 1, "times_count": 5489686780221667000, "times_used": 7598748108563329000 }, "can_verify_status": 1, "amount": { "origin_list_market_amount": 1856913066340555300, "list_market_amount": 5361010892640100000, "pay_amount": 8155773907435107000, "payment_discount_amount": 3872279052006779000, "platform_discount_amount": 8501600379305051000, "original_currency": "wHUjCqGr00", "brand_ticket_amount": 6437206420877055000, "merchant_ticket_amount": 2160781738340973300, "coupon_pay_amount": 3958524403109736400, "original_amount": 3863479041641902600 }, "benefit_card_info": { "total_amount": { "total_amount": 3227346309707070000, "pay_amount": 3961976362949356500, "principal_amount": 3742893853038417000, "merchant_discount_amount": 219107334120075420, "brand_discount_amount": 9032584899273803000, "platform_discount_amount": 9205308425624793000, "payment_discount_amount": 2757058857538856000, "benefit_amount": 4707415894272333000, "provider_discount_amount": 1150014733420787600 }, "left_amount": { "total_amount": 4890677197401967000, "merchant_discount_amount": 1137693198431166100, "benefit_amount": 7559546385014670000, "platform_discount_amount": 2310236632587759000, "payment_discount_amount": 6654444355492578000, "pay_amount": 8739952035660542000, "brand_discount_amount": 4030915406420933000, "principal_amount": 4766131679568359000, "provider_discount_amount": 8346715984234680000 } }, "dynamic_code_info": { "code_expire_time": "Px0h5EZMNK" }, "off_peak_discount_info": { "off_peak_time_range": [ { "start_time": 821742692186083000, "end_time": 2468101083400403000, "daily_time_range_list": [ { "start_time": "wuNNyZOZ4B", "end_time": "s7ldjrvnha", "end_time_is_next_day": false } ], "week_day_list": [ 1 ] } ], "idle_time_limit_type": 1, "has_off_peak_discount": false } }, "error_code": 0, "description": "" } }
切换单列布局错误码
| 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 | 2100001 | 未知错误 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙，此时请开发者稍候再试 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 更换参数 |
| 200 | 5000001 | 服务器打瞌睡了，请稍后再试。 | |
| 200 | 3000001 | 以实际错误信息为准 |
