Skip to content

Get Ticket Info

Description

取得票劵資訊。

Resource

GET /v3/ticket/info

Authorization

採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。

Query Parameters

Name Type Description
id string 票券編號

Request

GET /v3/ticket/info?id=TICKET202407000001

Response Body Parameters

Name Type Description
ticket_product_id string 票劵商品編號
ticket_id string 票劵編號
ticket_name string 票券名稱
ticket_price integer 票券面額
redeem_product_id string 兌換商品編號
kind_id string 票券種類編號
kind_name string 票券種類名稱
kind_type string 票券種類屬性
ALLOWED VALUES:
  • GIFT_VOUCHER: 禮券
  • SALE_EVENT_COUPON: 抵用券
  • ENTRANCE_TICKET: 入場券
  • DISCOUNT_COUPON: 折扣券
  • CASH_COUPON: 折價券
  • PRODUCT_SPECIFIC_COUPONS: 商品券
product_ticket_type string 商品票券型態
ALLOWED VALUES:
  • PRODUCT_VOUCHER: 商品提貨券
  • PRODUCT_SPECIFIC_DISCOUNT_COUPON: 商品折扣券
  • PRODUCT_SPECIFIC_CASH_COUPON: 商品折價券
kind_type=PRODUCT_SPECIFIC_COUPONS才有值
(option)
available bool 是否可以使用票券
start_date string 有效起日
EXAMPLE "2020-01-01 12:00:00"
end_date string 有效迄日
EXAMPLE "2020-01-01 12:00:00"
discount integer 折扣率/折價金額
假設此值為 70，
若為折價券、商品折價券，代表折價 70 元；
若為折扣券、商品折扣券，代表打 7 折。
折扣券、折價券、商品折扣券、商品折價券，才有值
(optional)
message string 提示訊息
min_limit_amount float 票券使用金額低消

Response

{
  "ticket_product_id": "TICKET202407",
  "ticket_id": "TICKET202407000001",
  "ticket_name": "珍珠奶茶兌換券",
  "ticket_price": 70,
  "redeem_product_id": "PRODUCT001",
  "kind_id": "T2",
  "kind_name": "商品券",
  "kind_type": "PRODUCT_SPECIFIC_COUPONS",
  "product_ticket_type": "PRODUCT_SPECIFIC_CASH_COUPON",
  "available": true,
  "start_date": "2021-09-15 15:26:59",
  "end_date": "2022-08-17 23:59:59",
  "discount": 70,
  "message": null,
    "min_limit_amount": 0.0,
}

{
  "ticket_product_id": "TICKET_X_202407",
  "ticket_id": "TICKET_X_202407000001",
  "ticket_name": "入場券",
  "ticket_price": 350,
  "redeem_product_id": null,
  "kind_id": "X2",
  "kind_name": "入場券",
  "kind_type": "ENTRANCE_TICKET",
  "product_ticket_type": null,
  "available": true,
  "start_date": "2021-09-15 15:26:59",
  "end_date": "2022-08-17 23:59:59",
  "discount": null,
  "message": null,
    "min_limit_amount": 0.0,
}

{
    "redeem_product_id": "",
    "kind_id": "02",
    "kind_name": "折價券",
    "kind_type": "CASH_COUPON",
    "product_ticket_type": "PRODUCT_VOUCHER",
    "start_date": "2024-09-09 16:29:00",
    "end_date": "2024-10-09 16:29:00"
    "available": true,
    "message": "",
    "ticket_id": "D99991000001",
    "ticket_product_id": "99991",
    "ticket_name": "200元折價券",
    "ticket_price": 200,
    "discount": 200,
    "min_limit_amount": 300.0,
}