不指定付款方式－建立訂單

修訂於2024年4月23日

歐付寶提供多樣化的金流，本頁以「不指定付款方式」做介紹。

請商店將網頁表單 POST 傳送至以下的介接網址，歐付寶會顯示多種付款方式，讓消費者自行選擇付款方式，建立訂單。

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

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

本頁內容

流程簡圖

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

介接網址：

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

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


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

必要參數

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

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

選填參數[開啟]

參數 說明
StoreID
string (20) 		會員商店代碼 (選填)
提供會員填入店家代碼使用
ChooseSubPayment
string (20) 		預設子付款方式 (選填)
此參數用來指定消費者可付款的銀行／超商。
若未指定此參數，則有多家銀行／超商可供消費者自行選擇。
例：此參數設定為"TAISHIN"，則此次交易會以台新銀行付款。
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新增此欄位。

範例程式下載[收合]

使用 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。




付款圖例[收合]

將建立訂單的參數 POST 傳送至介接網址後，在付款選擇頁，消費者自行選擇付款方式：

1. 將建立信用卡訂單的參數 POST 傳送至介接網址後，在付款頁面，消費者須登入歐付寶會員。
信用卡付款流程(1)-歐付寶串接教學 金流 電子發票
2. 訂單成立，消費者填寫信用卡資料。
信用卡付款流程(2)-歐付寶串接教學 金流 電子發票
3. 消費者付款完成畫面。
信用卡付款流程(3)-歐付寶串接教學 金流 電子發票
1. 將建立超商代碼訂單的參數 POST 傳送至介接網址後，在付款選擇頁，消費者須登入歐付寶會員。
超商代碼付款流程(1)-歐付寶串接教學 金流 電子發票
2. 消費者取得「超商繳費代碼」。
超商代碼付款流程(2)-歐付寶串接教學 金流 電子發票
3. 訂單成立，請消費者記下「超商繳費代碼」，並前往超商繳費，完成付款。
超商代碼付款流程(3)-歐付寶串接教學 金流 電子發票
1. 將建立 ATM 訂單的參數 POST 傳送至介接網址後，在付款選擇頁，消費者須登入歐付寶會員。
ATM付款流程(1)-歐付寶串接教學 金流 電子發票
2. 消費者選擇付款銀行，取得「ATM繳費帳號」。
ATM付款流程(2)-歐付寶串接教學 金流 電子發票
3. 訂單成立，請消費者記下「ATM繳費帳號」，並前往 ATM 櫃員機轉帳，完成付款。
ATM付款流程(3)-歐付寶串接教學 金流 電子發票
1. 將建立「網路ATM」訂單的參數 POST 傳送至介接網址後，在付款選擇頁，消費者須登入歐付寶會員。
網路ATM付款流程(1)-歐付寶串接教學 金流 電子發票
2. 消費者選擇付款銀行，頁面將會轉導到銀行的「網路ATM繳費頁」。
網路ATM付款流程(2)-歐付寶串接教學 金流 電子發票
3. 訂單成立後，頁面會轉導到銀行的「網路ATM繳費頁」，請消費者使用金融卡插入讀卡機，完成線上付款。
網路ATM付款流程(3)-歐付寶串接教學 金流 電子發票
1. 將建立「歐付寶帳戶」訂單的參數 POST 傳送至介接網址後，在付款選擇頁，消費者須登入歐付寶會員。
歐付寶帳戶付款流程(1)-歐付寶串接教學 金流 電子發票
2. 消費者選擇「歐付寶帳戶」進行付款。
歐付寶帳戶付款流程(2)-歐付寶串接教學 金流 電子發票
3. 付款完成。
歐付寶帳戶付款流程(3)-歐付寶串接教學 金流 電子發票

線上模擬[收合]


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

 小提醒 ：測試用的信用卡卡號資訊，請參考「取得串接資訊」。

自訂您的參數

參數














網頁原始碼 （點此複製，以建立訂單） 

<form id="formWebATM" 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 />


ChooseSubPayment 預設子付款方式: 
<input type="text" name="ChooseSubPayment" 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 產生步驟[收合]


如果您使用 php、Java 或 C# 的金流整合 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
GO TOP