接口说明

用于根据账号id、订单id或加密券码批量查询抖音券码和三方券码的状态

1、支持查询抖音团购券码和三方券码的状态。

2、核销开放过程中，如存在断网情况下，商家系统没办法及时收到核销状态，增加券状态查询接口，方便商家系统查询券码状态。

3、通过验券准备接口返回的加密 code 查询抖音团购券码状态。

使用限制

SLA：支持的最大QPS:35;

基本信息

名称	描述
HTTP URL	https://open.douyin.com/goodlife/v1/fulfilment/certificate/query/
HTTP Method	GET
Scope	life.capacity.fulfilment
权限要求	团购核销需要申请权限，路径：抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/client_token/生成的token

content-type必填String

固定值"application/json"

Rpc-Transit-Life-AccountString

来客商户根账户ID

Query

account_idString

核销商户根账户ID（云连锁场景接入需传入，其余场景可不传）

encrypted_codeString

验券准备接口返回的加密券码

encrypted_code和order_id二选一必传

encrypted_code和order_id不能同时传入

order_idString

订单id，验券准备等接口获得

encrypted_code和order_id二选一必传

encrypted_code和order_id不能同时传入

请求示例
curl --location --request GET 'https://open.douyin.com/goodlife/v1/fulfilment/certificate/query/?account_id=TIWuysmxS3&encrypted_code=1qU6J65FC4&order_id=52E9JZIrQ1' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \

响应参数

Body展开全部子属性

data必填Struct

团购券的信息

展开子属性

extra必填Struct

扩展信息

展开子属性

响应示例
正常响应示例异常响应示例
{
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "2026012311002180EBD38B2C27CC1BB769",
    "now": 1769137223
  },
  "data": {
    "certificates": [
      {
        "pay_bill_info": {
          "bill_total_amount": 7723752359995155000,
          "bill_amount": 36940394672493520
        },
        "encrypted_code": "huLMQiz7zB",
        "reserve_info": {
          "order_reserve_user_info_list": [
            {
              "credential_numb": "nF62rwY0Gy",
              "credential_type": 1,
              "name": "S3oqbjuWib",
              "phone": "pKpowfRN1B"
            }
          ]
        },
        "book_info": {
          "book_poi_id": "AtN464dj5V",
          "book_product_number": 4875581290036303000,
          "verify_amount": 6000191095588323000
        },
        "advance_purchase_struct": {
          "time_detail": [
            {
              "time_type": 1,
              "time": 5114274740281181000
            }
          ],
          "purchase_type": 1
        },
        "amount": {
          "coupon_pay_amount": 6000343512907865000,
          "platform_discount_amount": 2113590633463494000,
          "payment_discount_amount": 2383080724133521000,
          "brand_ticket_amount": 6162653694497236000,
          "pay_amount": 2275098789345225200,
          "merchant_ticket_amount": 7802603605801788000,
          "original_currency": "uUQrJdM0XV",
          "list_market_amount": 8014030577374954000,
          "origin_list_market_amount": 8621638073565729000,
          "original_amount": 8879400265957566000
        },
        "used_status_type": 1,
        "time_card": {
          "serial_amount_list": [
            {
              "serial_numb": 695483292668866300,
              "amount": {
                "original_amount": 755528946573800000,
                "original_currency": "DzLjJTnOwl",
                "pay_amount": 8943755746817235000,
                "merchant_ticket_amount": 210364958436214080,
                "brand_ticket_amount": 3085898629411803600,
                "list_market_amount": 2072621681834251000,
                "origin_list_market_amount": 6856557714142005000,
                "coupon_pay_amount": 1732622216383085800,
                "platform_discount_amount": 1372715991686903600,
                "payment_discount_amount": 5120937454241615000
              }
            }
          ],
          "time_card_type": 1,
          "times_count": 4676606838601345000,
          "times_used": 2515466298170702000
        },
        "use_time_info": {
          "use_time_type": 1,
          "time_period_list": [
            {
              "end_time": "TjlwiMAh0d",
              "end_time_is_next_day": false,
              "start_time": "yRTqRNmH33"
            }
          ]
        },
        "dynamic_code_info": {
          "code_expire_time": "NEQTJ7YGee"
        },
        "cancel_verify_records": [
          {
            "times_card_serial_num": 3701646639407156000,
            "extra": {
              "open_order_id": "Blk2k6D8RR"
            },
            "benefit_amount": {
              "brand_discount_amount": 3850572677018695000,
              "provider_discount_amount": 1574442696220774700,
              "platform_discount_amount": 3210947588915095000,
              "benefit_amount": 5760772301324270000,
              "pay_amount": 265800631408867900,
              "payment_discount_amount": 6635046616111499000,
              "merchant_discount_amount": 5131060442779002000,
              "principal_amount": 2950553566106087400,
              "total_amount": 353573453988481600
            },
            "verify_id": "jWJbdE40SM",
            "can_cancel": false,
            "certificate_id": "h4aNv36eea",
            "verify_type": 1,
            "verifier_unique_id": "cMK29WU4z3",
            "poi_id": 3470601048846577000,
            "verify_time": 1406982451470646500
          }
        ],
        "verify_records": [
          {
            "benefit_amount": {
              "principal_amount": 2813981542610484000,
              "platform_discount_amount": 3466260452224812000,
              "payment_discount_amount": 7552009181838937000,
              "brand_discount_amount": 6015006973952548000,
              "total_amount": 9031736673652441000,
              "provider_discount_amount": 7037603843286847000,
              "benefit_amount": 7415578931379503000,
              "merchant_discount_amount": 729842933290020100,
              "pay_amount": 444429823041962400
            },
            "can_cancel": false,
            "verify_time": 8108792389255839000,
            "times_card_serial_num": 8666263031945255000,
            "poi_id": 6907201754722342000,
            "verifier_unique_id": "mULMjgWHvv",
            "verify_id": "kf03NH85S3",
            "certificate_id": "shLJkr1AEc",
            "verify_type": 1,
            "extra": {
              "open_order_id": "iugpQpzTOu"
            }
          }
        ],
        "verify": {
          "verify_time": 426110253888305700,
          "can_cancel": false,
          "poi_id": 150588305457847800,
          "times_card_serial_num": 2235933328898302500,
          "verifier_unique_id": "xeXFkUzUb0",
          "extra": {
            "open_order_id": "pJtdDYz3ps"
          },
          "benefit_amount": {
            "brand_discount_amount": 572280577601380000,
            "total_amount": 1076307474406178800,
            "pay_amount": 4547109283149535700,
            "payment_discount_amount": 5471022980544994000,
            "merchant_discount_amount": 3203722893476686300,
            "platform_discount_amount": 5511728945458713000,
            "provider_discount_amount": 7918585731713931000,
            "principal_amount": 6752295000606294000,
            "benefit_amount": 236121941021133470
          },
          "verify_id": "G8Plqp0zbw",
          "certificate_id": "TLTAoJWKbY",
          "verify_type": 1
        },
        "additional_map": {
          "1": "glOsfrPheM"
        },
        "sku": {
          "product_id": "Y3EYc2fSSA",
          "sold_start_time": 3710468202466033000,
          "third_sku_id": "NpW40U4224",
          "voucher_type": 1,
          "title": "6k9zWMRuqX",
          "market_price": 296324993935270900,
          "sku_out_id": "MbvJ48otS0",
          "suplier_product_out_id": "5R0nLeqxMv",
          "groupon_type": 1,
          "account_id": "Ul5BjdwInE",
          "product_out_id": "jtk0BF2ait",
          "product_attr": {
            "tJunpAeYp2": "Y01RRvUezb"
          },
          "sku_id": "YO05J23CLz"
        },
        "certificate_id": 4511946819308044000,
        "can_verify_status": 1,
        "expire_time": 9073425647693364000,
        "off_peak_discount_info": {
          "off_peak_time_range": [
            {
              "start_time": 8935988494226375000,
              "end_time": 837220799231003100,
              "daily_time_range_list": [
                {
                  "end_time": "EF9r1gXOxn",
                  "end_time_is_next_day": false,
                  "start_time": "BpWLAAkvn8"
                }
              ],
              "week_day_list": [
                1
              ]
            }
          ],
          "idle_time_limit_type": 1,
          "has_off_peak_discount": false
        },
        "benefit_card_info": {
          "total_amount": {
            "merchant_discount_amount": 4272668871784181000,
            "payment_discount_amount": 8531283583228450000,
            "benefit_amount": 1624567045075147500,
            "platform_discount_amount": 2782235798581544400,
            "pay_amount": 8148956529064241000,
            "brand_discount_amount": 3995552593237462000,
            "total_amount": 1030583239404429300,
            "provider_discount_amount": 1218365522874306300,
            "principal_amount": 2894502522365467600
          },
          "left_amount": {
            "total_amount": 1261434547112544500,
            "provider_discount_amount": 6666669244461689000,
            "principal_amount": 6940735768011255000,
            "benefit_amount": 3153250758742734300,
            "pay_amount": 5989395673715618000,
            "merchant_discount_amount": 2232326861589862000,
            "payment_discount_amount": 2779610693659471000,
            "platform_discount_amount": 85907530036975410,
            "brand_discount_amount": 7139997870327679000
          }
        },
        "period_card": {
          "period_type": 1
        },
        "start_time": 3969653282677509600,
        "buyer_reserve_info": {
          "name": "KGSjoBuHFm",
          "credential_numb": "OkhCeOZuF9",
          "credential_type": 1092007166265913700
        },
        "deduction_info_list": [
          {
            "voucher_type": 1,
            "source_sku_id": 6237879534077305000,
            "source_payment_discount_amount": 7673599327587095000,
            "source_certificate_code": "58S2yQ3puz",
            "source_item_order_id": "SZkEHkIAOG",
            "source_platform_discount_amount": 7969176112315998000,
            "source_amount": 7976157020409965000,
            "is_one_time_buy": false,
            "source_user_pay_amount": 4527512400457416700,
            "groupon_type": 1,
            "source_provider_discount_amount": 2853645486468636700,
            "source_sku_name": "LjlkicHghB",
            "source_certificate_id": "Co9GOvr9Cp",
            "source_order_id": "96EmHBT7jU",
            "source_brand_discount_amount": 1039456275974189600,
            "source_merchant_discount_amount": 1694943875040587800,
            "source_selling_price": 4878407298608408000
          }
        ],
        "not_available_time_info": {
          "fulfil_enable": false,
          "can_no_use_week_day": [
            4920226440076163000
          ],
          "can_no_use_date": [
            {
              "start_time": 4237696068799730000,
              "end_time": 5541353316672043000
            }
          ]
        },
        "code": "5D8ZdrTU0G",
        "status": 1,
        "not_available_poi_list": [
          "qQhxIWuuSY"
        ]
      }
    ],
    "certificates_v2": [
      {
        "sku": {
          "suplier_product_out_id": "nyraisctk9",
          "product_out_id": "QNaDvgrgy9",
          "groupon_type": 1,
          "product_id": "k5Zojsvo5w",
          "voucher_type": 1,
          "account_id": "kGc9EcON1c",
          "sku_id": "6o7AoCNttv",
          "title": "wF2IcPTJ0G",
          "market_price": 288721023811740860,
          "sku_out_id": "eAKUl9VuMc",
          "product_attr": {
            "jWYmaBYTmq": "FA0g3gK6R2"
          },
          "sold_start_time": 2660856815192776700,
          "third_sku_id": "ampTv6rZ9X"
        },
        "certificate_id": 3127022387469844000,
        "deduction_info_list": [
          {
            "source_brand_discount_amount": 8058724648200585000,
            "source_user_pay_amount": 4333987516136369000,
            "source_amount": 1821708919068913200,
            "source_sku_id": 9085014036683545000,
            "source_payment_discount_amount": 9021914337716900000,
            "groupon_type": 1,
            "source_platform_discount_amount": 2306771077761810400,
            "source_provider_discount_amount": 7301602133422791000,
            "source_merchant_discount_amount": 132538772516012780,
            "is_one_time_buy": false,
            "source_sku_name": "UKJH3OBHjt",
            "source_item_order_id": "gXjOkD67ge",
            "source_order_id": "JcUZfqKta4",
            "voucher_type": 1,
            "source_selling_price": 5661551664270948000,
            "source_certificate_code": "PGfbLzkhj2",
            "source_certificate_id": "s0waH9TJWQ"
          }
        ],
        "off_peak_discount_info": {
          "idle_time_limit_type": 1,
          "has_off_peak_discount": false,
          "off_peak_time_range": [
            {
              "start_time": 5894696410520816000,
              "end_time": 5785482431089669000,
              "daily_time_range_list": [
                {
                  "start_time": "qJm86NYQyx",
                  "end_time": "s8iopGcLKp",
                  "end_time_is_next_day": false
                }
              ],
              "week_day_list": [
                1
              ]
            }
          ]
        },
        "dynamic_code_info": {
          "code_expire_time": "hZd9VZ8PfB"
        },
        "status": 1,
        "use_time_info": {
          "time_period_list": [
            {
              "start_time": "VsD83hVUtJ",
              "end_time": "OQlhJRjj0Z",
              "end_time_is_next_day": false
            }
          ],
          "use_time_type": 1
        },
        "not_available_time_info": {
          "can_no_use_date": [
            {
              "start_time": 5031624922227934000,
              "end_time": 7664623523981672000
            }
          ],
          "fulfil_enable": false,
          "can_no_use_week_day": [
            8645052900021703000
          ]
        },
        "can_verify_status": 1,
        "advance_purchase_struct": {
          "time_detail": [
            {
              "time": 3413942019365603000,
              "time_type": 1
            }
          ],
          "purchase_type": 1
        },
        "additional_map": {
          "1": "c5l3y3g345"
        },
        "encrypted_code": "ekqwCnWLbM",
        "used_status_type": 1,
        "cancel_verify_records": [
          {
            "poi_id": 2672039662095785000,
            "certificate_id": "QLj09txQjB",
            "verify_id": "cPwRdljDLi",
            "extra": {
              "open_order_id": "W5DXcxiqnK"
            },
            "verifier_unique_id": "MFBfSDpWNE",
            "benefit_amount": {
              "benefit_amount": 701947069422712000,
              "platform_discount_amount": 82488676587494100,
              "merchant_discount_amount": 8886414825538741000,
              "payment_discount_amount": 6260759630062705000,
              "provider_discount_amount": 2326412152359348000,
              "total_amount": 6095947442812707000,
              "principal_amount": 1069920982502459100,
              "brand_discount_amount": 1683584113541337000,
              "pay_amount": 5671530075196747000
            },
            "can_cancel": false,
            "times_card_serial_num": 2619849757681612300,
            "verify_type": 1,
            "verify_time": 7694167366833492000
          }
        ],
        "verify": {
          "verify_type": 1,
          "poi_id": 8675618378137746000,
          "benefit_amount": {
            "provider_discount_amount": 9127125047066509000,
            "brand_discount_amount": 6507581885659784000,
            "benefit_amount": 4340282020638880300,
            "merchant_discount_amount": 4201638292198589000,
            "platform_discount_amount": 1898096449330320100,
            "pay_amount": 1598323122449884400,
            "total_amount": 7164986567004840000,
            "payment_discount_amount": 2467766987677958700,
            "principal_amount": 6994365862202896000
          },
          "verifier_unique_id": "VTZdmv4nEq",
          "certificate_id": "XulRXir42l",
          "can_cancel": false,
          "verify_time": 2044906579567634700,
          "times_card_serial_num": 1134487972788864100,
          "extra": {
            "open_order_id": "LO4tx8DIU7"
          },
          "verify_id": "aKVSafLYeb"
        },
        "pay_bill_info": {
          "bill_total_amount": 8460898060420266000,
          "bill_amount": 4966813053077988000
        },
        "period_card": {
          "period_type": 1
        },
        "not_available_poi_list": [
          "qGNzO5CkFK"
        ],
        "code": "uuw0JU2c8X",
        "reserve_info": {
          "order_reserve_user_info_list": [
            {
              "name": "VYia7PV6VT",
              "phone": "YImCwHUF7g",
              "credential_numb": "Kx7pIX8sB6",
              "credential_type": 1
            }
          ]
        },
        "benefit_card_info": {
          "total_amount": {
            "payment_discount_amount": 4749458821333991000,
            "principal_amount": 4204444930842248700,
            "pay_amount": 5831965902304686000,
            "total_amount": 1394972642512762000,
            "merchant_discount_amount": 4228021754349691000,
            "platform_discount_amount": 2609690813493625300,
            "provider_discount_amount": 1526088285619317200,
            "benefit_amount": 696726145377971000,
            "brand_discount_amount": 5851716725110663000
          },
          "left_amount": {
            "merchant_discount_amount": 8943245619718569000,
            "principal_amount": 4297590940215323600,
            "pay_amount": 2941662563826626600,
            "payment_discount_amount": 508877872845638140,
            "benefit_amount": 8535293113849500000,
            "provider_discount_amount": 4106331191426251000,
            "brand_discount_amount": 9054797838354025000,
            "platform_discount_amount": 6599594476056111000,
            "total_amount": 55499243556153770
          }
        },
        "buyer_reserve_info": {
          "credential_type": 5838878668532486000,
          "name": "oygV72kelV",
          "credential_numb": "1NBdCCwZeU"
        },
        "expire_time": 8517387310101323000,
        "verify_records": [
          {
            "times_card_serial_num": 702431283973359500,
            "verify_id": "dhzQ5yBzWW",
            "verify_type": 1,
            "verifier_unique_id": "vXeNDM3zNU",
            "extra": {
              "open_order_id": "z03SVAITEW"
            },
            "verify_time": 4188111655063870500,
            "benefit_amount": {
              "platform_discount_amount": 8475624479573777000,
              "provider_discount_amount": 9046927678240681000,
              "pay_amount": 5328034759163776000,
              "brand_discount_amount": 2014688235390639900,
              "principal_amount": 8397547127025607000,
              "total_amount": 3161367130630244400,
              "benefit_amount": 7284923763944303000,
              "merchant_discount_amount": 6554545363867046000,
              "payment_discount_amount": 2263990675064190700
            },
            "certificate_id": "MCGdlH2Gm2",
            "can_cancel": false,
            "poi_id": 104275689027573140
          }
        ],
        "book_info": {
          "book_product_number": 4292599263622281000,
          "verify_amount": 1182206536487484400,
          "book_poi_id": "sKKTDkou8Y"
        },
        "time_card": {
          "time_card_type": 1,
          "times_count": 91014219404005440,
          "times_used": 7221147537633112000,
          "serial_amount_list": [
            {
              "serial_numb": 580718639837805600,
              "amount": {
                "platform_discount_amount": 8790303437543639000,
                "list_market_amount": 9156495746742796000,
                "origin_list_market_amount": 8249051864478843000,
                "coupon_pay_amount": 4538254290509515000,
                "original_amount": 5988737071220592000,
                "merchant_ticket_amount": 7352775007875181000,
                "brand_ticket_amount": 5324838470543516000,
                "payment_discount_amount": 6020668090250671000,
                "pay_amount": 2940685780966225400,
                "original_currency": "a2h9xkedzG"
              }
            }
          ]
        },
        "start_time": 2867195222175596500,
        "amount": {
          "pay_amount": 5609417527285804000,
          "list_market_amount": 7567568610507271000,
          "payment_discount_amount": 3131322515139215000,
          "platform_discount_amount": 5463868662834791000,
          "merchant_ticket_amount": 8984272466201167000,
          "coupon_pay_amount": 2163997829774830800,
          "original_currency": "rB2zyBaa2B",
          "brand_ticket_amount": 4293324418896294400,
          "origin_list_market_amount": 6990091599442884000,
          "original_amount": 6677324020997998000
        }
      }
    ],
    "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	3000001	以实际错误信息为准
200	5000001	服务器打瞌睡了，请稍后再试。
200	4000001	以实际错误信息为准
200	1033000519	以实际错误信息为准

开发者文档

券状态批量查询

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

券状态批量查询在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

券状态批量查询