消費者第一次繳費後,歐付寶會將授權付款的結果,以背景 POST 的方式,回傳至商店傳來的 ReturnURL。
小提醒 :若是初次串接歐付寶,可先參考「快速串接教學」。
本頁內容
流程簡圖
歐付寶回傳第一次授權付款結果[收合]
回傳網址:
商店傳來的 ReturnURL
消費者第一次繳費後,歐付寶會將以下參數,以背景 POST 的方式,回傳至商店傳來的 ReturnURL:
回傳參數
參數 | 說明 |
MerchantID string (10) |
商店代號 註冊歐付寶會員時,歐付寶會提供一組商店代號。 |
MerchantTradeNo string (20) |
商店交易編號 訂單產生時傳送給O'Pay的廠商交易編號。英數字大小寫混合。 |
StoreID string (20) |
會員商店代碼 會員商店代碼使用。 |
RtnCode int |
交易狀態 1:交易成功,其餘代碼為交易失敗。 |
RtnMsg string (200) |
交易訊息 告知付款結果。Ex.交易成功、付款失敗。 |
TradeNo string (20) |
O'Pay的交易編號 請保存O'Pay的交易編號與 MerchantTradeNo的關連。 |
TradeAmt int |
交易金額 純數字格式,無千分位。 |
PayAmt int |
實際付款金額 實際付款金額=交易金額-折抵金額 註:於V1.1.30新增此欄位。 |
RedeemAmt int |
折抵金額 使用購物金折抵的金額 註:於V1.1.30新增此欄位。 |
PaymentDate string (20) |
付款時間 日期時間格式:yyyy/MM/dd HH:mm:ss |
PaymentType string (20) |
會員選擇的付款方式 |
PaymentTypeChargeFee int |
通路費 純數字格式,無千分位。 |
TradeDate string (20) |
訂單成立時間 日期時間格式:yyyy/MM/dd HH:mm:ss |
ItemName string (200) |
商品名稱 如果商品名稱有多筆,需在金流選擇頁一行一行顯示商品名稱的話,商品名稱請以#號分隔。 |
SimulatePaid int |
是否為模擬付款 1-模擬付款/0-非模擬付款 ※(1)賣家會員可透過廠商後台網站來針對單筆訂單模擬由歐付寶發動付款通知,以方便介接 API 的測試。 ※(2)當 SimulatePaid 的值為 1 時,RtnCode 也會是 1,表示此筆訂單是模擬付款, 並非是由消費者實際真的付款,所以歐付寶也不會撥款給廠商, 請勿對該筆交易做出貨等動作,以避免損失。 |
gwsr int |
授權交易單號 此為信用卡額外回傳的參數 |
process_date string (20) |
處理時間 此為信用卡額外回傳的參數 格式為yyyy/MM/dd HH:mm:ss |
auth_code string (6) |
授權碼 此為信用卡額外回傳的參數 |
amount int |
金額 此為信用卡額外回傳的參數 |
stage int |
分期期數 此為信用卡額外回傳的參數 |
stast int |
頭期金額 此為信用卡額外回傳的參數 |
staed int |
各期金額 此為信用卡額外回傳的參數 |
eci int |
3D(VBV) 此為信用卡額外回傳的參數 回傳值(eci=5,6,2,1 代表該筆交易不可否認) |
card4no string (4) |
卡片的末4碼 此為信用卡額外回傳的參數 |
card6no string (6) |
卡片的末6碼 此為信用卡額外回傳的參數 |
red_dan int |
紅利扣點 此為信用卡額外回傳的參數 |
red_de_amt int |
紅利折抵金額 此為信用卡額外回傳的參數 |
red_ok_amt int |
實際扣款金額 此為信用卡額外回傳的參數 |
red_yet int |
紅利剩餘點數 此為信用卡額外回傳的參數 |
PeriodType string (1) |
訂單建立時的所設定的週期種類 此為信用卡額外回傳的參數 |
Frequency int |
訂單建立時的所設定的執行頻率 此為信用卡額外回傳的參數 |
ExecTimes int |
訂單建立時的所設定的執行頻率 此為信用卡額外回傳的參數 |
PeriodAmount int |
訂單建立時的每次要授權金額 此為信用卡額外回傳的參數 |
TotalSuccessTimes int |
目前已成功授權的次數 此為信用卡額外回傳的參數 |
TotalSuccessAmount int |
目前已成功授權的金額合計 此為信用卡額外回傳的參數 |
CheckMacValue string (max) |
檢查碼 ※如果您使用 php、Java、C#、Ruby on Rails 或 Node.js 的金流整合 SDK 工具包,可略過此參數。 ※請參考 CheckMacValue 產生步驟。 |
下一頁: 歐付寶回傳第二次(含)以後授權之付款結果