歐付寶回傳付款結果  ►

歐付寶帳戶－建立訂單

修訂於2024年10月7日

請商店將網頁表單 POST 傳送至以下的介接網址，以建立 「歐付寶帳戶」（TopUpUsed） 訂單。

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

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

本頁內容

流程簡圖

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

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

介接網址：

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

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


請商店將以下參數 POST 傳送至介接網址，以建立 歐付寶帳戶(TopUpUsed) 訂單：

必要參數

參數 說明
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) 		預設付款方式 (必要)
請固定填入"TopUpUsed"。  
PaymentType
string (20) 		交易類型 (必要)
請固定填入"aio"。
※如果您使用 php、Java、C#、Ruby on Rails 或 Node.js 的金流整合 SDK 工具包，可略過此參數。
CheckMacValue
string (max) 		檢查碼 (必要)
※如果您使用 php、Java、C#、Ruby on Rails 或 Node.js 的金流整合 SDK 工具包，可略過此參數。
※請參考 CheckMacValue 產生步驟。

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

選填參數[開啟]

參數 說明
StoreID
string (20) 		會員商店代碼 (選填)
提供會員填入店家代碼使用
ChooseSubPayment
string (20) 		繳費子方式 (選填)
若設定此參數，將視消費者是否已登入 歐付寶做不同處理，說明如下：。
1.未登入，進入歐付寶付款選擇頁時，會依設定的付款方式及付款子項目帶入預設值，並可選擇其他付款子項目。 2.已登入，進入歐付寶訂單成立頁時，會依設定的付款方式及付款子項目帶入訂單，無法選擇其他付款子項目。
PaymentInfoURL
string (200) 		訂單建立通知回傳網址 (選填)
接收歐付寶回傳訂單建立通知的網址。
ClientBackURL
string (200) 		Client端返回廠商網址 (選填)
若需於歐付寶的付款完成頁面，顯示[回到廠商]的按鈕，請設定此參數，按鈕會連結至此網址。
※頁面導回的時候，不會帶付款結果到此網址，僅會將頁面導回。
ItemURL
string (200) 		商品銷售網址 (選填)
OrderResultURL
string (200) 		Client端回傳付款結果網址 (選填)
若不使用歐付寶的付款完成頁面，可設定此參數，指定您的付款結果頁。
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。




付款圖例[收合]

付款流程示例：

歐付寶帳戶付款流程

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 />


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