API串接使用情境說明 / 特店

票券發行：電子票券/超商票券

應用場景：
特店官網可自行串接，不透過平台販售票券，票券訂單的發行交易，以特約賣家角度而言，主要會由「建立金流訂單」(請參考全方位金流API、站內付2.0)及「票券發行(Issue)」組成。
可應用API：
(1) 查詢商品資訊：/api/Ticket/QueryItemInfo
(2) 票券發行：/api/issuance/issue

票券發行：紙本票券

應用場景：
票券訂單的發行交易，以特店賣家會員角度而言，主要會由「建立金流訂單」(請參考全方位金流API、站內付2.0)及「票券發行(Issue)」組成。
紙本票券若列印方式(PrintType)選擇廠商列印，特店於票券發行完成後，需至廠商後台列印紙本票券再交付或郵寄給消費者；若選擇綠界列印，則會由綠界列印後由專人另行交付。
可應用API：
(1) 查詢商品資訊：/api/Ticket/QueryItemInfo
(2) 票券發行：/api/issuance/issue

票券核銷

情境一
特店或門市人員可使用行動裝置掃描票券QRCode執行核銷，不需串接API。

情境二
特店若有自己的官網欲串接API來執行票券核銷，可參考以下流程圖。
- 可應用API：
  (1) 查詢票券明細：/api/Ticket/QueryTicketStatus
  (2) 票券核銷：/api/Ticket/WriteOff

票券退貨

情境一：
由於純發行的票券，金流退款與票券退貨為各自獨立的作業，當特店接收到消費者的退貨申請時，可登入廠商後台進行票券退貨，完成票券退貨後，提醒您亦需處理金流訂單的退款。

情境二
特店若有自己的官網欲串接API來執行票券退貨，可參考以下流程圖。
- 可應用API：
  (1) 查詢票券明細：/api/Ticket/QueryTicketStatus
  (2) 票券退貨：/api/issuance/Refund

Copyright © Green World FinTech Service Co., Ltd. All rights reserved.

綠界官方網站