請商店將網頁表單 POST 傳送至以下的介接網址,以建立 ATM櫃員機 訂單。訂單建立後,歐付寶會回傳一組「ATM繳費帳號」,讓您提供給消費者繳費。

立即體驗「線上模擬自訂您的參數、建立 ATM 訂單。

 小提醒 :若是初次串接歐付寶,可先參考「快速串接教學」。

本頁內容

流程簡圖

ATM建立訂單-歐付寶串接教學 金流 電子發票

傳送參數建立訂單[收合]

介接網址:

  • 正式環境: https://payment.opay.tw/Cashier/AioCheckOut/V5

  • 測試環境: https://payment-stage.opay.tw/Cashier/AioCheckOut/V5


請商店將以下參數 POST 傳送至介接網址,以建立 ATM 訂單:

必要參數

參數 說明
MerchantID
string (10)
廠商編號 (必要)
註冊歐付寶會員時,歐付寶會提供一組商店代號。
MerchantTradeNo
string (20)
商店交易編號 (必要)
1.商店交易編號不可重複
2.可英數字大小寫混合。
3.如何避免訂單編號重複請參考FAQ
MerchantTradeDate
string (20)
商店交易時間 (必要)
日期時間格式:yyyy/MM/dd HH:mm:ss
TotalAmount
int
交易金額 (必要)
純數字格式,無千分位。
TradeDesc
string (200)
交易描述 (必要)
交易的簡易描述。
ItemName
string (200)
商品名稱 (必要)
如果商品名稱有多筆,需在金流選擇頁一行一行顯示商品名稱的話,商品名稱請以#號分隔。
ReturnURL
string (200)
付款完成通知回傳網址 (必要)
接收歐付寶回傳付款完成通知的網址。
ChoosePayment
string (20)
預設付款方式 (必要)
請固定填入"ATM"。  
PaymentType
string (20)
交易類型 (必要)
請固定填入"aio"。
※如果您使用 phpJavaC#Ruby on RailsNode.js 的金流整合 SDK 工具包,可略過此參數。
CheckMacValue
string (max)
檢查碼 (必要)
※如果您使用 phpJavaC#Ruby on RailsNode.js 的金流整合 SDK 工具包,可略過此參數。
※請參考 CheckMacValue 產生步驟

如果您需要進階的功能,傳送上述必要參數時,可一同傳送以下的選填參數:

選填參數[開啟]

參數 說明
ChooseSubPayment
string (20)
預設繳費銀行 (選填)
此參數用來預設消費者繳費的銀行
若未指定此參數,則有多家銀行可供消費者自行選擇。
例:此參數設定為"TAISHIN",則此次交易預設會以台新銀行的ATM付款。
PaymentInfoURL
string (200)
訂單建立通知回傳網址 (選填)
接收歐付寶回傳訂單建立通知的網址。
ClientBackURL
string (200)
Client端返回廠商網址 (選填)
若需於歐付寶的付款完成頁面,顯示[回到廠商]的按鈕,請設定此參數,按鈕會連結至此網址。
※頁面導回的時候,不會帶付款結果到此網址,僅會將頁面導回。
ItemURL
string (200)
商品銷售網址 (選填)
OrderResultURL
string (200)
Client端回傳付款結果網址 (選填)
若不使用歐付寶的付款完成頁面,可設定此參數,指定您的付款結果頁。 ※部分銀行的網路ATM在交易成功後,並不會將頁面導回至歐付寶,所以歐付寶也不會將頁面導回此參數設定的網址。
NeedExtraPaidInfo
string (1)
是否需要額外的付款資訊 (選填)
若於付款完成通知及訂單查詢時,需接收「付款人銀行代碼」、「付款人銀行帳號後五碼」、「銀行名稱」時, 請填入"Y"。
DeviceSource
string (10)
裝置來源 (選填)
此參數用來設定付款頁面的顯示,預設為空值,由 O'Pay 自動判定。
P:電腦版, M:行動裝置版
PlatformID
string (10)
特約合作平台商代號 (選填)
平台商與歐付寶簽約時,歐付寶會提供一組平台商代號。
一般商店不用帶此參數。
InvoiceMark
string (1)
電子發票開立註記 (選填)
此參數為付款完成後開立電子發票。請參考 InvoiceMark 參數為 Y 所需參數
若要開立發票,請將該參數設定為「Y」
HoldTradeAMT
int
是否延遲撥款 (選填)
是否延遲撥款。否-請帶0(預設值),是-請帶1。
參數值如下:
0:買方付款完成後,歐付寶依合約約定之時間,撥款給廠商(此為預設值)。
1:買方付款完成後,需再呼叫「廠商申請撥款/退款」API,讓歐付寶撥款給廠商,或退款給買方。倘若廠商一直不申請撥款,此筆訂單款項會一直放在歐付寶,直到廠商申請撥款。
※延遲撥款不適用「信用卡」之付款方式。
EncryptType
int
CheckMacValue 簽章類型 (選填)
請固定帶 1,使用 SHA256 簽章。
UseRedeem
string(1)
是否可以使用購物金/紅包折抵 (選填)
用來設定此筆交易是否可以使用購物金/紅包折抵。
參數設定:
Y:可使用,
N:不可使用(預設為N)
註1:折抵方式可於「廠商後台/紅包折抵設定」功能新增您的折抵條件,若已開啟折抵設定,需再配合此參數,來決定此筆交易是否可以使用購物金/紅包折抵。
註2:折抵的購物金/紅包金額,需由廠商自行負擔。
註3:若可使用購物金/紅包折抵時,需注意接收付款結果通知時,請以TradeAmt做訂單金額的檢查。
註4:於V1.1.30新增此欄位。
ExpireDate
int
允許繳費有效天數 (選填)
最長 60 天,最短1天。不填則預設為3天。
ClientRedirectURL
string(200)
Client端回傳付款相關資訊 (選填)
此網址為訂單建立完成後(非付款完成後),歐付寶會將付款相關資訊以Client端方式回傳給特約商店,內容包含繳費銀行代碼、繳費虛擬帳號與繳費期限(yyyy/MM/dd),沒帶此參數則會顯示歐付寶的訂單成立頁。
如果要將訂單成立頁顯示在貴公司,請設定此網址。 ※有設定此參數ClientBackURL參數將會失去作用。

範例程式下載[收合]

使用 php SDK 範例程式:
https://github.com/o-pay/Payment_PHP



使用 Java SDK 範例程式:
https://github.com/o-pay/Payment_Java



使用 C# SDK 範例程式:
https://github.com/o-pay/Payment_Net



使用 Ruby on Rails SDK 範例程式:
https://github.com/o-pay/Payment_RoR/



使用 Node.js SDK 範例程式:
https://github.com/o-pay/Payment_Node.js/



其它程式語言,可 點此下載參考範例程式(php、C#),請參考前述建立訂單的參數,串接歐付寶的 API




付款圖例[收合]

付款流程示例:

ATM 櫃員機付款流程

1. 將建立 ATM 訂單的參數 POST 傳送至介接網址後,在付款選擇頁,消費者須登入歐付寶會員。
ATM付款流程(1)-歐付寶串接教學 金流 電子發票
2. 消費者選擇付款銀行,取得「ATM繳費帳號」。
ATM付款流程(2)-歐付寶串接教學 金流 電子發票
3. 訂單成立,請消費者記下「ATM繳費帳號」,並前往 ATM 櫃員機轉帳,完成付款。
ATM付款流程(3)-歐付寶串接教學 金流 電子發票

線上模擬[收合]


可於下方自訂您的訂單參數,點擊    按鈕,開始建立訂單:

自訂您的參數

參數













網頁原始碼 點此複製,以建立訂單

<form id="formATM" method="post" accept-charset="UTF-8"
 action="https://payment-stage.opay.tw/Cashier/AioCheckOut/V5">

MerchantID 商店代號: <input type="text" name="MerchantID" value="" /><br />
MerchantTradeNo 商店交易編號: <input type="text" name="MerchantTradeNo" value="" /><br />
MerchantTradeDate 商店交易時間: <input type="text" name="MerchantTradeDate" value="" /><br />
PaymentType 交易類型: <input type="text" name="PaymentType" value="" /><br />
TotalAmount 交易金額: <input type="text" name="TotalAmount" value="" /><br />
TradeDesc 交易描述: <input type="text" name="TradeDesc" value="" /><br />
ItemName 商品名稱: <input type="text" name="ItemName" value="" /><br />
ReturnURL 付款完成通知回傳網址: <input type="text" name="ReturnURL" value="" /><br />
ChoosePayment 預設付款方式: <input type="text" name="ChoosePayment" value="" /><br />
會員商店代碼: <input type="text" name="StoreID" value="" /><br />
ClientBackURL Client端返回廠商網址: <input type="text" name="ClientBackURL" value="" /><br />
CheckMacValue 簽章類型: <input type="text" name="EncryptType" value="" /><br />
CheckMacValue 檢查碼: <input type="text" name="CheckMacValue" value="" /><br />
<input type="submit" value="送出訂單" /> </form>

CheckMacValue 產生步驟[收合]


如果您使用 phpJavaC# 的金流整合 SDK 工具包,可略過此步驟。

CheckMacValue(檢查碼)用來確保訂單的資訊安全,您的 HashKey 與 HashIV 金鑰請參考「取得串接資訊」。

 請小心 :為避免網頁前端洩漏您的 HashKey、HashIV 金鑰,請於伺服器端產生 CheckMacValue。

 先依參數名稱字順(由 A 至 Z)排序各組參數,用「參數名稱參數值」形式,以 & 符號相連:
 最前面加上您的 HashKey、最後面加上您的 HashIV
 以 UTF-8 的編碼 UrlEncode
 轉為小寫
 由於 UrlEncode 的結果可能不同,請依照 UrlEncode對照表 取代 UrlEncode 的結果,以和歐付寶(IIS+.NET) UrlEncode 的結果一致:
php 為例:php urlencode 函式會將「!」轉為「%21」,這和歐付寶(IIS+.NET) UrlEncode 的結果不同,為了 UrlEncode 的結果一致,請依照 UrlEncode對照表,使用 str_replace 函式將結果「%21」取代為「!」,php 程式如下:


$sMacValue = str_replace('%2d', '-', $sMacValue);
$sMacValue = str_replace('%5f', '_', $sMacValue);
$sMacValue = str_replace('%2e', '.', $sMacValue);
$sMacValue = str_replace('%21', '!', $sMacValue);
$sMacValue = str_replace('%2a', '*', $sMacValue);
$sMacValue = str_replace('%28', '(', $sMacValue);
$sMacValue = str_replace('%29', ')', $sMacValue);
                

UrlEncode 對照表[開啟]

符號歐付寶(IIS+.NET) UrlEncode
--
__
..
!!
~%7e
**
((
))
space 空格+
@40%
#23%
$24%
%25%
^%5e
&26%
=%3d
+%2b
;%3b
?%3f
/%2f
\%5c
>%3e
<%3c
%25%
`60%
[%5b
]%5d
{%7b
}%7d
:%3a
'27%
"22%
,%2c
|%7c
 轉為 SHA256 雜湊,並轉為大寫,即成功產生 CheckMacValue

 下一頁: 歐付寶回傳建立訂單結果


GO TOP