接口说明

在核销的异常场景情况下，对抖音码团购、次卡券进行状态查询。

使用限制

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

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

content-type必填String

固定值"application/json"

Rpc-Transit-Life-AccountString

来客商户根账户ID

Query

encrypted_code必填String

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

(传参前需要先进行URL编码，注意不要有空格)

account_idString

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

请求示例
curl --location --request GET 'https://open.douyin.com/goodlife/v1/fulfilment/certificate/get/?encrypted_code=yTz0kJksBv&account_id=NVqz8lF2Sy' \
--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": "202601081756454ACD5C4AB932C3AB8837",
    "now": 1767866207
  },
  "data": {
    "certificate_v2": {
      "buyer_reserve_info": {
        "credential_numb": "A7Qyvq17NQ",
        "credential_type": 1008087473129982500,
        "name": "aEsIproaGE"
      },
      "benefit_card_info": {
        "left_amount": {
          "provider_discount_amount": 5525237841577544000,
          "pay_amount": 7113986083545100000,
          "principal_amount": 3518130808828717600,
          "platform_discount_amount": 4068416722736051000,
          "payment_discount_amount": 4763360534263560000,
          "brand_discount_amount": 2760439003535240000,
          "benefit_amount": 5461377859908732000,
          "merchant_discount_amount": 5937711517194973000,
          "total_amount": 3375642189569424400
        },
        "total_amount": {
          "benefit_amount": 7087382242675350000,
          "pay_amount": 4062733738618098000,
          "principal_amount": 1536122644871179300,
          "provider_discount_amount": 6181452661846771000,
          "total_amount": 812033585421637200,
          "brand_discount_amount": 8401008633871796000,
          "merchant_discount_amount": 4403819329003618300,
          "platform_discount_amount": 7443139514334762000,
          "payment_discount_amount": 5142379676604464000
        }
      },
      "not_available_time_info": {
        "can_no_use_week_day": [
          7701785549981323000
        ],
        "can_no_use_date": [
          {
            "start_time": 4178646300406487600,
            "end_time": 3629013584983472600
          }
        ],
        "fulfil_enable": false
      },
      "book_info": {
        "book_product_number": 8633968819140743000,
        "verify_amount": 6900206285924296000,
        "book_poi_id": "z8b4HfcbK8"
      },
      "sku": {
        "sku_out_id": "WQKX817uWF",
        "sold_start_time": 6179427994871579000,
        "account_id": "fJY1XEr3jN",
        "product_out_id": "xeREAeXzJK",
        "suplier_product_out_id": "N2LGqbGKPO",
        "third_sku_id": "PT1DVKcFTN",
        "market_price": 2728847733879411700,
        "sku_id": "m1UKJuM0O5",
        "product_attr": {
          "GQm9Sqw68U": "BQI6s4lTHz"
        },
        "voucher_type": 1,
        "product_id": "JOWhlaNJnt",
        "title": "dUTCvJY4q2",
        "groupon_type": 1
      },
      "deduction_info_list": [
        {
          "source_item_order_id": "7NTSGqVNQh",
          "source_user_pay_amount": 7345360655508045000,
          "is_one_time_buy": false,
          "source_order_id": "PBn2UBYcvG",
          "source_amount": 7890384064082498000,
          "groupon_type": 1,
          "source_merchant_discount_amount": 1239098970901299500,
          "source_platform_discount_amount": 6320454524538201000,
          "source_payment_discount_amount": 3689818725862814700,
          "source_brand_discount_amount": 5482478625687786000,
          "source_selling_price": 4581031418317257000,
          "source_provider_discount_amount": 4648000285121364000,
          "source_certificate_code": "r5UriItqhK",
          "source_sku_name": "UJUBey41Gn",
          "source_sku_id": 7695339290446794000,
          "voucher_type": 1,
          "source_certificate_id": "UhnZeJA4X9"
        }
      ],
      "can_verify_status": 1,
      "not_available_poi_list": [
        "dgurleRUra"
      ],
      "reserve_info": {
        "order_reserve_user_info_list": [
          {
            "phone": "H3NjOXdh7a",
            "credential_numb": "uXOBjGSJE8",
            "credential_type": 1,
            "name": "6ybblUhVkY"
          }
        ]
      },
      "pay_bill_info": {
        "bill_total_amount": 2336295146131245600,
        "bill_amount": 1902456680513829400
      },
      "period_card": {
        "period_type": 1
      },
      "expire_time": 1204606366615374800,
      "code": "diA0pfIx0i",
      "verify_records": [
        {
          "can_cancel": false,
          "verify_id": "QsbL7Q6Rs0",
          "verify_time": 5232131694148132000,
          "verifier_unique_id": "JbjVm9M222",
          "poi_id": 8418038267068893000,
          "verify_type": 1,
          "certificate_id": "XYaCsLuJ95",
          "times_card_serial_num": 349723283668125440
        }
      ],
      "encrypted_code": "agcXOWeaIU",
      "dynamic_code_info": {
        "code_expire_time": "bTA0yh3jmr"
      },
      "time_card": {
        "times_count": 2691997112886334500,
        "times_used": 3137011567939370500,
        "serial_amount_list": [
          {
            "serial_numb": 1753607107685118200,
            "amount": {
              "original_amount": 3967757840634534000,
              "list_market_amount": 674413860973323400,
              "original_currency": "AcfpU2AduY",
              "brand_ticket_amount": 3352538635180223500,
              "pay_amount": 870316948049241300,
              "platform_discount_amount": 6124476706798438000,
              "merchant_ticket_amount": 821790960762267000,
              "payment_discount_amount": 2147147586514290400,
              "coupon_pay_amount": 3141470736536412000,
              "origin_list_market_amount": 2249718016464377000
            }
          }
        ],
        "time_card_type": 1
      },
      "start_time": 2015484722853685800,
      "off_peak_discount_info": {
        "idle_time_limit_type": 1,
        "has_off_peak_discount": false,
        "off_peak_time_range": [
          {
            "end_time": 6254094787187836000,
            "daily_time_range_list": [
              {
                "start_time": "Q6rD5j41IT",
                "end_time": "JR2VAO3KFl",
                "end_time_is_next_day": false
              }
            ],
            "week_day_list": [
              1
            ],
            "start_time": 278269724405519460
          }
        ]
      },
      "advance_purchase_struct": {
        "purchase_type": 1,
        "time_detail": [
          {
            "time": 4686691271985843000,
            "time_type": 1
          }
        ]
      },
      "status": 1,
      "verify": {
        "certificate_id": "Ek3HiertNE",
        "poi_id": 8890892795270650000,
        "verify_time": 4502463940967507000,
        "verifier_unique_id": "opv1Qf3bOh",
        "can_cancel": false,
        "times_card_serial_num": 5176474287699095000,
        "verify_id": "TNLLYclBpg",
        "verify_type": 1
      },
      "amount": {
        "pay_amount": 5819200765842546000,
        "payment_discount_amount": 3173754837145210000,
        "brand_ticket_amount": 3185282596494503,
        "original_amount": 5372070802237714000,
        "coupon_pay_amount": 4720266711961738000,
        "list_market_amount": 6539746948945490000,
        "origin_list_market_amount": 898706075026319000,
        "original_currency": "NuERp2P6t6",
        "platform_discount_amount": 3355450571339621000,
        "merchant_ticket_amount": 5483457266868106000
      },
      "certificate_id": 1079127662463617000,
      "additional_map": {
        "1": "l85jOlHeMZ"
      },
      "used_status_type": 1,
      "use_time_info": {
        "use_time_type": 1,
        "time_period_list": [
          {
            "end_time_is_next_day": false,
            "start_time": "8EJVtme38m",
            "end_time": "5H97GJ6duQ"
          }
        ]
      }
    },
    "certificate": {
      "code": "8fUKLEJb77",
      "encrypted_code": "VZrj0FKI2E",
      "additional_map": {
        "1": "56uCTrPbTK"
      },
      "amount": {
        "list_market_amount": 9137874299348267000,
        "origin_list_market_amount": 434392213157824830,
        "platform_discount_amount": 3415479615769187000,
        "coupon_pay_amount": 1204876626808905700,
        "pay_amount": 3892553051458740700,
        "original_currency": "LwjHD07ALY",
        "merchant_ticket_amount": 1325550566403812400,
        "original_amount": 3556588686931403300,
        "brand_ticket_amount": 5656494616682277000,
        "payment_discount_amount": 5905823872037497000
      },
      "not_available_poi_list": [
        "BheO9ecluL"
      ],
      "book_info": {
        "book_product_number": 55202354783803960,
        "verify_amount": 3530374824548671000,
        "book_poi_id": "iFeinLzkVc"
      },
      "start_time": 9130877708971801000,
      "status": 1,
      "buyer_reserve_info": {
        "name": "RQtak4W3jq",
        "credential_numb": "0a8GJO54Dk",
        "credential_type": 7654567168644447000
      },
      "off_peak_discount_info": {
        "off_peak_time_range": [
          {
            "daily_time_range_list": [
              {
                "start_time": "IxoWRyw7E4",
                "end_time": "QSZwEUHvgY",
                "end_time_is_next_day": false
              }
            ],
            "week_day_list": [
              1
            ],
            "start_time": 6826079249878995000,
            "end_time": 2876868955327143400
          }
        ],
        "idle_time_limit_type": 1,
        "has_off_peak_discount": false
      },
      "deduction_info_list": [
        {
          "source_sku_name": "lhf2PgmEtJ",
          "groupon_type": 1,
          "source_sku_id": 817268684071861200,
          "source_merchant_discount_amount": 4155273680148268500,
          "source_certificate_code": "q1ir1fyKc9",
          "source_certificate_id": "j0QUEbsd29",
          "source_provider_discount_amount": 1240650931099578600,
          "source_user_pay_amount": 173812604841798430,
          "voucher_type": 1,
          "source_order_id": "eNMlsKGY4D",
          "source_selling_price": 1627735945549707300,
          "is_one_time_buy": false,
          "source_amount": 8668012744913692000,
          "source_platform_discount_amount": 4644847201868858000,
          "source_item_order_id": "gI6U2is39D",
          "source_payment_discount_amount": 3977139388172702000,
          "source_brand_discount_amount": 230601950413662880
        }
      ],
      "advance_purchase_struct": {
        "purchase_type": 1,
        "time_detail": [
          {
            "time": 751656155957128200,
            "time_type": 1
          }
        ]
      },
      "reserve_info": {
        "order_reserve_user_info_list": [
          {
            "credential_type": 1,
            "name": "VW62scIdt1",
            "phone": "bI0mQTTdzp",
            "credential_numb": "1iY9096KHn"
          }
        ]
      },
      "can_verify_status": 1,
      "used_status_type": 1,
      "not_available_time_info": {
        "fulfil_enable": false,
        "can_no_use_week_day": [
          3506545585604221400
        ],
        "can_no_use_date": [
          {
            "end_time": 2440006012179403000,
            "start_time": 2816329583467265000
          }
        ]
      },
      "sku": {
        "product_id": "Z5ECX5hYM1",
        "voucher_type": 1,
        "suplier_product_out_id": "SbduZVYVLI",
        "sku_id": "cyPfrj9isi",
        "groupon_type": 1,
        "account_id": "uDslzBNnp5",
        "product_out_id": "kFlOVUklaH",
        "third_sku_id": "CyG7dS0n6V",
        "sku_out_id": "tZUGVR3rzD",
        "product_attr": {
          "xh1GzFitBv": "Z0gjvqVvQV"
        },
        "title": "WrgmqX2Wpz",
        "market_price": 6149318787087261000,
        "sold_start_time": 2119427168362772200
      },
      "dynamic_code_info": {
        "code_expire_time": "RB8hdTY4K0"
      },
      "use_time_info": {
        "time_period_list": [
          {
            "start_time": "q6OWz4Jk9S",
            "end_time": "HkF7yEHjFz",
            "end_time_is_next_day": false
          }
        ],
        "use_time_type": 1
      },
      "certificate_id": 507735747403757950,
      "expire_time": 1336351390125063700,
      "pay_bill_info": {
        "bill_amount": 6900535437790129000,
        "bill_total_amount": 6190019160235102000
      },
      "period_card": {
        "period_type": 1
      },
      "time_card": {
        "serial_amount_list": [
          {
            "amount": {
              "platform_discount_amount": 84360848467823040,
              "original_amount": 6088581073217060000,
              "merchant_ticket_amount": 846692637742083600,
              "original_currency": "s8Xvbgo7PM",
              "pay_amount": 7567906633450941000,
              "payment_discount_amount": 5710437345708780000,
              "list_market_amount": 5888306669625667000,
              "origin_list_market_amount": 1700230365666545200,
              "coupon_pay_amount": 4618282887345357000,
              "brand_ticket_amount": 5999036752932968000
            },
            "serial_numb": 4669227049766157000
          }
        ],
        "time_card_type": 1,
        "times_count": 7736844627220056000,
        "times_used": 3990314983453807600
      },
      "benefit_card_info": {
        "total_amount": {
          "merchant_discount_amount": 673540572056918700,
          "platform_discount_amount": 275667893661901800,
          "payment_discount_amount": 7969549748269311000,
          "provider_discount_amount": 2601240043922431000,
          "total_amount": 2704226778955943000,
          "pay_amount": 6431279297089133000,
          "principal_amount": 3582224776429652000,
          "benefit_amount": 7592117656182412000,
          "brand_discount_amount": 4938727760585577000
        },
        "left_amount": {
          "benefit_amount": 896761074185960100,
          "platform_discount_amount": 2307341993773657600,
          "pay_amount": 8557766402732293000,
          "brand_discount_amount": 7168124556311110000,
          "payment_discount_amount": 6978066633169602000,
          "total_amount": 2478872026569552400,
          "merchant_discount_amount": 2848222181495701000,
          "provider_discount_amount": 8613715573348685000,
          "principal_amount": 324168635536595460
        }
      },
      "verify_records": [
        {
          "verify_type": 1,
          "poi_id": 5265317206488515000,
          "times_card_serial_num": 4945891322820698000,
          "certificate_id": "hzQnSHIXi9",
          "verifier_unique_id": "tsi633LH55",
          "verify_time": 1192382763486810400,
          "can_cancel": false,
          "verify_id": "LIsscLXdy9"
        }
      ],
      "verify": {
        "can_cancel": false,
        "verifier_unique_id": "IGRhr5y8z5",
        "verify_type": 1,
        "verify_id": "z58AyKf3MJ",
        "verify_time": 2326796978320251000,
        "poi_id": 8768636017150181000,
        "times_card_serial_num": 1407164401360853500,
        "certificate_id": "EVZUIfL3Ef"
      }
    },
    "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	以实际错误信息为准

开发者文档

券状态查询

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

券状态查询在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

券状态查询