模擬串接服務 - 票券狀態查詢

經銷商『票券狀態查詢』請求欄位
Id Name Description Type Additional Information
1 agent_uid 經銷商商務代號
string 必填
2 service 服務名稱
string 必填
{ "service_name": "api", "cmd": "api\/voucherstatusquery" }
JSON格式,AES256加密資料
3 encry_data 『票券狀態查詢』欄位資料 string 必填
『票券狀態查詢』欄位參考
JSON格式,AES256加密資料
特約商店『票券狀態查詢』請求欄位
Id Name Description Type Additional Information
1 store_uid 特約商店商務代號
string 必填
2 service 服務名稱
string 必填
{ "service_name": "api", "cmd": "api\/voucherstatusquery" }
JSON格式,AES256加密資料
3 encry_data 『票券狀態查詢』欄位資料 string 必填
『票券狀態查詢』欄位參考
JSON格式,AES256加密資料
票券狀態查詢』欄位
Id Name Description Type Additional Information
1 items 票券狀態查詢項目 array 必填
每筆『票券狀態查詢項目』欄位參考
票券狀態查詢』回傳欄位
Id Name Description Type Additional Information
1 code 執行狀態碼 string 『票券執行狀態碼』值參考
2 msg 執行狀態訊息 string
3 content 內容 array 每筆『票券狀態資訊回傳』欄位參考
票券狀態查詢項目』欄位
Id Name Description Type Additional Information
1 issuance_uid 委託發行商商務代號 string 必填
2 no 自訂票券號碼或本號 string 必填
票券執行狀態碼』 值內容
Value Description Type Additional Information
100 資料不正確 string
400 系統錯誤 string
B200 執行成功 string
B500 執行失敗 string
票券狀態資訊回傳』欄位
Id Name Description Type Additional Information
1 issuance_uid 委託發行商 string
2 unit_type 單位類型 int 『票券實體券單位』值參考
3 no 自訂票券號碼或本號碼 string
4 ticket 若單位為券時,票券資訊 object|null 『單位為券-票券資訊回傳』欄位參考
5 book 若單位為本時,票券資訊清單 array 每筆『單位為本-每張票券資訊回傳』欄位參考
票券實體券單位』 值內容
Value Description Type Additional Information
1 int
2 int
單位為券-票券資訊回傳』欄位
Id Name Description Type Additional Information
1 status 票券狀態 int 『票券流程狀態碼』值參考
2 custom_serial_no 自訂票券號碼 string
3 serial_no 系統票券號碼 string
4 book_no 自訂票券本號 string
5 sales_from_type 銷售點類型 int 『票券銷售點類型』值參考
6 sales_store_uid 銷售特約商店商務代號 string
7 sales_dealer_no 自訂銷售點編號 string
8 reimbursement_from_type 核銷點類型 int 『票券核銷點類型』值參考
9 reimbursement_store_uid 核銷特約商店商務代號 string
10 reimbursement_dealer_no 自訂核銷點編號 string
11 invalid_from_type 作廢點類型 int 『票券作廢點類型』值參考
12 invalid_store_uid 作廢特約商店商務代號 string
13 invalid_dealer_no 自訂作廢點編號 string
14 cost 購買單價 float
15 price 購買定價 float
16 trust_start_date 票券履約保證起始日(格式:YYYYMMDD) string
17 trust_end_date 票券履約保證結束日(履約保證時間必須超過一年)(格式:YYYYMMDD) string
18 trust_guarantee_date 與消費者定型化契約結束日(格式:YYYYMMDD) string
19 is_paid 票券價值類型 int 『票券價值類型』值參考
單位為本-每張票券資訊回傳』欄位
Id Name Description Type Additional Information
1 status 票券狀態 int 『票券流程狀態碼』值參考
2 custom_serial_no 自訂票券號碼 string
3 serial_no 系統票券號碼 string
4 sales_from_type 銷售點類型 int 『票券銷售點類型』值參考
5 sales_store_uid 銷售特約商店商務代號 string
6 sales_dealer_no 自訂銷售點編號 string
7 reimbursement_from_type 核銷點類型 int 『票券核銷點類型』值參考
8 reimbursement_store_uid 核銷特約商店商務代號 string
9 reimbursement_dealer_no 自訂核銷點編號 string
10 invalid_from_type 作廢點類型 int 『票券作廢點類型』值參考
11 invalid_store_uid 作廢特約商店商務代號 string
12 invalid_dealer_no 自訂作廢點編號 string
13 cost 購買單價 float
14 price 購買定價 float
15 trust_start_date 票券履約保證起始日(格式:YYYYMMDD) string
16 trust_end_date 票券履約保證結束日(履約保證時間必須超過一年)(格式:YYYYMMDD) string
17 trust_guarantee_date 與消費者定型化契約結束日(格式:YYYYMMDD) string
18 is_paid 票券價值類型 int 『票券價值類型』值參考
票券流程狀態碼』 值內容
Value Description Type Additional Information
1 建立 int
2 綁定 int
3 轉贈 int
4 售出 int
5 作廢 int
31 票券核銷 int
32 票券移轉 int
33 票券退券 int
34 退款進行中 int
35 轉贈進行中 int
票券銷售點類型』 值內容
Value Description Type Additional Information
1 MYTIX特約商店(預設) int
2 自訂銷售點編號 int
票券核銷點類型』 值內容
Value Description Type Additional Information
1 MYTIX特約商店(預設) int
2 自訂核銷點編號 int
票券作廢點類型』 值內容
Value Description Type Additional Information
1 MYTIX特約商店(預設) int
2 自訂作廢點編號 int
票券價值類型』 值內容
Value Description Type Additional Information
1 有償 integer
0 無償 integer
AES256資料加密方式說明

1、所有的API送出HTTPs請求之欄位中,service 和 encry_data 欄位皆進行 AES256+BASE64 加密處理。
2、AES加密,格式為CBC,長度為256bits,金鑰長度32,IV長度16,傳遞內文為加密後組合IV並經過Base64轉換後傳出。

方式:
使用自訂的AES256函式將JSON資料加密後,再將IV資料和此AES256加密後的JSON資料串聯後,使用base64再進行加密成ASCII字串即可完成加密。

    PHP加密示意:
    AesEncrypt -> base64_ecode($IV . $JSON)

    C#加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> toBase64

    Java加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> toBase64

    Node.js加密示意:
    AesEncrypt -> concat([IV,JSON], [IV_SIZE,JSON_SIZE]) -> toString('base64')
    Python加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> base64.b64encode

範例程式碼