ATM、CVS、BarcodeATM 的取號結果通知
應用場景:
- Server 端方式(Server POST)(PaymentInfoURL)
當消費使用 ATM/CVS/BarcodeATM 付款方式取號完成後,特店接受歐買尬金流的取號結果訊息,並回應接收訊息
Step1. 歐買尬金流:以 ServerPost 方式傳送取號結果訊息至特店的 Server 網址[PaymentInfoURL]
Step2. 特店:收到歐買尬金流的取號結果訊息,並判斷檢查碼是否相符
Step3. 特店:檢查碼相符後,於網頁端回應 1|OK
- Client 端方式(Client POST)(ClientRedirectURL)
當消費者取號完成後,歐買尬金流一次性反饋取號結果通知,並將頁面導至特店自製頁面
Step1. 歐買尬金流:傳送取號結果並將頁面導至特店的自製頁面網址(ClientRedirectURL)
Step2. 特店:收到歐買尬金流的取號結果訊息,並判斷檢查碼是否相符
歐買尬金流回傳參數說明:
介接路徑
- Content Type:text/html
- HTTP Method:POST
| 參數/型態 | 參數名稱 | 說明 |
|---|---|---|
| MerchantID String(10) | 特店編號 | |
| MerchantTradeNo String (20) | 特店交易編號 | 訂單產生時傳送給歐買尬金流的特店交易編號。 |
| StoreID String(20) | 特店旗下店舖代號 | 提供特店填入分店代號使用,僅可用英數字大小寫混合。 |
| RtnCode Int | 交易狀態 | 1. ATM 回傳值時為 2 時,交易狀態為取號成功,其餘為失敗。 2. CVS、BarcodeATM 回傳值時為 10100073 時,交易狀態為取號成功。其餘為失敗。 |
| RtnMsg String(200) | 交易訊息 | |
| TradeNo String(20) | 歐買尬金流的交易編號 | 請保存歐買尬金流的交易編號與特店交易編號 [MerchantTradeNo] 的關連。 |
| TradeAmt Int | 交易金額 | |
| PaymentType String(20) | 特店選擇的付款方式 | 請參考回覆付款方式一覽表 |
| TradeDate String(20) | 訂單成立時間 | 格式為 yyyy/MM/dd HH:mm:ss |
| CustomField1 String(50) | 自訂名稱欄位 1 | 提供合作廠商使用記錄用客製化使用欄位 |
| CustomField2 String(50) | 自訂名稱欄位 2 | 提供合作廠商使用記錄用客製化使用欄位 |
| CustomField3 String(50) | 自訂名稱欄位 3 | 提供合作廠商使用記錄用客製化使用欄位 |
| CustomField4 String(50) | 自訂名稱欄位 4 | 提供合作廠商使用記錄用客製化使用欄位 |
| CheckMacValue String | 檢查碼 | 特店必須檢查檢查碼 [CheckMacValue] 來驗證,請參考附錄檢查碼機制 |
當ChoosePayment參數為使用ATM付款方式時:
| 參數/型態 | 參數名稱 | 說明 |
|---|---|---|
| BankCode String(3) | 繳費銀行代碼 | |
| vAccount String(16) | 繳費虛擬帳號 | |
| ExpireDate String(10) | 繳費期限 | 格式為yyyy/MM/dd HH:mm:ss |
注意事項:
各銀行ATM繳款帳號,若金額錯誤、逾期繳費、重覆繳款,是經由銀行端機制進行檢核ATM繳款帳號資訊,歐買尬金流無法進行金額錯誤、逾期繳費、重覆繳款的訂單阻擋。
當ChoosePayment參數為使用CVS付款方式時:
| 參數/型態 | 參數名稱 | 說明 |
|---|---|---|
| PaymentNo String(14) | 繳費代碼 | |
| ExpireDate String(20) | 繳費期限 | 格式為yyyy/MM/dd HH:mm:ss |
當ChoosePayment參數為使用BarcodeATM付款方式時:
| 參數/型態 | 參數名稱 | 說明 |
|---|---|---|
| ExpireDate String(20) | 繳費期限 | 格式為yyyy/MM/dd HH:mm:ss |
特店傳出參數說明:
| 參數 | 參數名稱 | 型態 | 說明 |
|---|---|---|---|
| String | 回傳值為純字串並無參數名稱 若回傳值第一碼值為 1時為成功,例: 1|OK。 若回傳值第一碼值為 0時為失敗,例: 0|ErrorMessage,ErrorMessage為 [錯誤代碼 - 錯誤訊息]。 此訊息僅代表特店回應是否已收到歐買尬金流回傳通知及所接收的資料是否正確,並不會影響訂單的狀態。 |
注意事項:
接收取號結果通知時,請系統開發人員確認下面事項,以利收到歐買尬金流發送的取號完成通知:
(1) 請確認訂單產生的回傳付款網址[PaymentInfoURL]參數中的程式是否已開發完成。
(2) 請確認回傳付款網址[PaymentInfoURL]中的網址,已經開放對外,從貴公司的網域之外也可以通知得到。
取號結果通知會以下表form-data格式參數直接回傳至頁面,並以「參數=值」表示
參數與參數之間以&隔開, 例:
Barcode1=&Barcode2=&Barcode3=&ExpireDate=2017/12/28 00:39:03&MerchantID=2000132&MerchantTradeNo=Test1513787899&PaymentNo=LLL17355880822&PaymentType=CVS_CVS&RtnCode=10100073&RtnMsg=Get CVS Code Succeeded.&TradeAmt=2000&TradeDate=2017/12/21 00:39:03&TradeNo=17122100383415923452&StoreID=&CustomField1=&CustomField2=&CustomField3=&CustomField4=&CheckMacValue=EA85AEB76DD14ED00016C41934471D877B53F5B292611AB29CA6FCBCE33205D0
