Skip to content

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