發票作廢的串接主要是透過「交易退款」API,並以特定欄位 invoice_state 設值為 4 來表示發票作廢(註銷)。特約商店、經銷商兩種模式發票作廢串接的差異主要在 API 位址及驗證身份欄位,整體流程與欄位結構相似:
- API 介接網址:
- 測試區:https://ka.usecase.cc/api/init
- 正式區:https://ka.mypay.tw/api/init
- 服務命令:api/refund
- 主要欄位:
- store_uid:特約商店代號
- uid:原交易的交易流水號
- key:原交易驗證碼
- cost:退款金額(作廢通常為全額)
- invoice_state:4 (表發票作廢)
- items:退款商品明細
- 以AES256加密欄位資料後,採POST送出
- 發票作廢透過該退款接口系統自動處理
- API 介接網址:
- 測試區:https://ka.usecase.cc/api/agent
- 正式區:https://ka.mypay.tw/api/agent
- 服務命令:api/refund
- 主要欄位:
- agent_uid:經銷商代號
- store_uid:特約商店代號
- uid:原交易流水號
- key:原交易驗證碼
- cost:退款金額
- invoice_state:4
- items:商品明細
- 發送時需使用經銷商身份 (agent_uid) 搭配 AES256 加密
- 相關加密解密、POST 格式與特約商店模式相似
兩模式主要差異在參數中是否帶入 agent_uid,以及 API 基本路徑不同,但使用的命令與參數結構一致,均以 api/refund 串接,invoice_state=4 指示發票作廢。