如何發動發票折讓？
發動發票折讓的方式本質上類似，都是透過「交易退款（api/refund）」API發起折讓請求，但特約商店、經銷商兩模式在使用身分、API介接端點、必要參數等細節上有差異：
發票折讓發動方法（共通點）
- 折讓由「交易退款 API」發起，帶入折讓相關參數（invoice_state 指定為折讓狀態，退款商品明細 items 須與原發票相符）
- 送出資料前需以 AES 256 加密，並以 HTTPS POST 送出
- 發票折讓資料由系統送至財政部電子發票平台完成折讓作業
- 折讓金額與商品明細需與交易、發票一致，支持部分折讓
特約商店 vs 經銷商差異點
| 項目 | 特約商店串接 | 經銷商串接 |
|---|---|---|
| API介接網址 | https://ka.mypay.tw/api/init | https://ka.mypay.tw/api/agent |
| 證書授權及金鑰 | 特約商店專屬 | 經銷商專屬，可代特約商店作業 |
| 交易欄位中 | store_uid 等特約商店資訊 | 需有 agent_uid（經銷商商務代號）及 store_uid |
| API請求格式 | POST x-www-form-urlencoded 加密資料 | POST x-www-form-urlencoded 加密資料 |
| 系統身份與權限 | 以特約商店直接發動 | 以經銷商身分代發特約商店訂單交易 |
| 發票折讓細節帶入 | invoice_state、items 等折讓欄位 | 同上，必須指定正確身分參數 |
| 回報與監控 | 交易回報及發票狀態連動通知 | 同上，並可透過經銷商後台管理 |
結論
- 兩者發動折讓流程原理一致，均透過「交易退款 API」帶入折讓資料發起請求，且均需要加密與 HTTPS 連線安全保護
- 經銷商串接多了 agent_uid 欄位，需要使用經銷商身份金鑰與介接端點，且可代替特約商店執行折讓
- 特約商店則直接使用 store_uid 及其金鑰介接官方 API 端點
- 開發時需根據串接身分取用正確API端點與認證資訊，折讓參數與資料格式本質無異
總之，特約商店與經銷商在技術發動發票折讓的方式上是同源的流程，差別在於 API 介接身分與端點配置，發票折讓參數使用方式是一致的。
已發佈 6 月 之前
#80 795 瀏覽次數 已編輯 1 日 之前
高鉅是台灣領先的金融科技公司，專注於提供客製化的金融服務，我們以創新的思維和專業的技術，打造一個安全、便利、高效的支付生態系，搭建起企業、銀行與消費者之間的橋樑，扮演微型商家到大型電商企業最堅實的後盾協助共創三贏。