退款 / 取消交易
信用卡請退款功能(若不撰寫此API,須透過廠商後台功能處理)
應用場景
當收到訂單授權成功,透由11.查詢信用卡單筆明細記錄API取得[交易狀態], 再依[交易狀態]發動欲執行動作。
請款使用說明
1. 信用卡付款成功,查詢訂單會顯示[已授權] (此時僅會占用信用卡額度),
如果此筆訂單要送至銀行請款,須執行[關帳] (Action=C)。
2. 執行[關帳]後,查詢訂單會顯示[要關帳],表示FunPoint金流將要向銀行進行請款作業。
3. 當歐買尬金流已向銀行完成[請款]作業,查詢訂單會顯示[已關帳]。
退款使用方式
1. 呼叫11.查詢信用卡單筆明細記錄API取得狀態
2. 查詢後,呼叫 信用卡請退款 API:
- [已授權] 階段:執行 [放棄] (Action=N) 可釋放信用卡佔額。
- [要關帳] 階段:
- 全額退款:先執行 [取消] (Action=E),接著進行 [放棄] (Action=N)。
- 部份退款:執行 [退刷] (Action=R)。
- [已關帳] 階段:執行 [退刷] (Action=R)。
注意事項:
若「每日自動關帳」開啟時,每天20:15 ~ 20:30請勿執行此API。
「關帳」:授權請/退款。
注意事項:
(1) 若「每日自動關帳」開啟時,每日20:15系統會自行關帳,歐買尬金流依關帳後的金額向銀行請/退款。
(2) 若於廠商後台將系統「每日自動關帳」關閉以後,訂單仍須於21天內完成關帳作業, 若於21天內未完成手動關帳作業,後續將無法已API方式進行關帳。 超過90天系統會將未關帳訂單進行放棄作業,不作請款。
(3) 產生錯誤訊息「error_overDAY」須通知客服協助關帳。
「退刷」:在系統關帳或自行關帳後,可修改訂單金額。
※ 修改上限為訂單金額
注意事項:
(1) 分期的交易一定得全額退刷,一般授權才能作部份金額退刷。
(2) 如帳戶餘額低於退刷金額,將無法退刷,建議留存一定金額於歐買尬金流帳戶或至廠商後台預存歐買尬金流帳戶餘額供退刷之用。如遇無法退刷,請參考FAQ。
「取消」:可取消關帳,讓訂單回復關帳前的狀態。
「放棄」:適用在當日關帳前放棄此筆交易,不做請款。
介接路徑
- 正式環境:https://payment.funpoint.com.tw/CreditDetail/DoAction
- 測試環境:因無法提供實際授權,故無法使用此API
特店傳入參數說明 (名稱前若有紅色星號*為必填欄位):
- Content Type:application/x-www-form-urlencoded
- HTTP Method:POST
| 參數/型態 | 參數名稱 | 說明 |
|---|---|---|
| *MerchantID String(10) | 特店編號(由歐買尬金流提供) | |
| *MerchantTradeNo String(20) | 特店交易編號 | 訂單產生時傳送給歐買尬金流的特店交易編號。 |
| *TradeNo String(20) | 歐買尬金流的交易編號 | 請保存歐買尬金流的交易編號與特店交易編號[MerchantTradeNo]的關連。 |
| *Action String(1) | 執行動作 | 針對訂單做處理的動作,例如要對訂單做關帳時,請帶C。1.若要執行關帳時,參數請帶: C 2.若要執行退刷時,參數請帶: R3.若要執行取消時,參數請帶: E4.若要執行放棄時,參數請帶: N |
| *TotalAmount Int | 金額 | |
| *CheckMacValue String | 檢查碼 | 請參考附錄檢查碼機制 |
| PlatformID String(10) | 特約合作平台商代號(由歐買尬金流提供) | 為專案合作的平台商使用。 一般特店或平台商本身介接,則參數請帶放空值。 若為專案合作平台商的特店使用時, 則參數請帶平台商所綁的特店編號[MerchantID]。 |
歐買尬金流回傳參數說明
- Content Type:text/html
- HTTP Method:POST
訂單結果會直接回傳至頁面,並以「參數=值」表示,參數與參數之間以&隔開,例: MerchantID=2000132&MerchantTradeNo=funpoint 1234&TradeNo=20120315174058256412
| 參數/型態 | 參數名稱 | 說明 |
|---|---|---|
| MerchantID String(9) | 特店編號 | |
| MerchantTradeNo String(20) | 特店交易編號 | 訂單產生時傳送給歐買尬金流的特店交易編號。 |
| TradeNo String(20) | 歐買尬金流的交易編號 | |
| RtnCode Int | 交易狀態 | 回傳值: 若為1時代表成功,其餘為失敗 |
| RtnMsg String(200) | 交易訊息 |
信用卡關帳/退刷/取消/放棄作業流程

