每一次信用卡定期定額執行授權後,歐付寶都會將付款的結果,以背景 POST 的方式,回傳至商店傳來的 PeriodReturnURL。
小提醒 :若是初次串接歐付寶,可先參考「快速串接教學」。
本頁內容
流程簡圖
每一次歐付寶回傳授權付款結果[收合]
回傳網址:
商店傳來的 PeriodReturnURL
每一次信用卡定期定額執行授權後,歐付寶都會將付款的結果,以背景 POST 的方式,回傳至商店傳來的 PeriodReturnURL:
回傳參數
參數 | 說明 |
MerchantID string (10) |
商店代號 註冊歐付寶會員時,歐付寶會提供一組商店代號。 |
MerchantTradeNo string (20) |
商店交易編號 訂單產生時傳送給O'Pay的廠商交易編號。英數字大小寫混合。 |
StoreID string (20) |
會員商店代碼 會員商店代碼使用。 |
RtnCode int |
交易狀態 1:交易成功,其餘代碼為交易失敗。 |
RtnMsg string (200) |
交易訊息 告知付款結果。Ex.交易成功、付款失敗。 |
PeriodType string (1) |
週期種類 訂單建立時的所設定的週期種類 |
Frequency int |
執行頻率 訂單建立時的所設定的執行頻率 |
ExecTimes int |
執行次數 訂單建立時的所設定的執行頻率 |
Amount int |
本次授權金額 此次所授權的金額 |
Gwsr int |
授權交易單號 此為信用卡額外回傳的參數 |
ProcessDate string (20) |
處理時間 處理時間( yyyy/MM/ddHH:mm:ss ) |
AuthCode string (6) |
授權碼 授權碼 |
FirstAuthAmount int |
初次授權金額 第一次授權的金額。因為要是以交易金額(TotalAmount)來做定期定額,分期後差額部分於第一期收取。 |
TotalSuccessTimes int |
已執行成功次數 目前已成功授權的次數 |
SimulatePaid int |
是否為模擬付款 1-模擬付款/0-非模擬付款 ※(1)賣家會員可透過廠商後台網站來針對單筆訂單模擬由歐付寶發動付款通知,以方便介接 API 的測試。 ※(2)當 SimulatePaid 的值為 1 時,RtnCode 也會是 1,表示此筆訂單是模擬付款, 並非是由消費者實際真的付款,所以歐付寶也不會撥款給廠商, 請勿對該筆交易做出貨等動作,以避免損失。 |
CheckMacValue string (max) |
檢查碼 ※如果您使用 php、Java、C#、Ruby on Rails 或 Node.js 的金流整合 SDK 工具包,可略過此參數。 ※請參考 CheckMacValue 產生步驟。 |