Drupal Ubercart 6.x-2.x 串接紅陽科技 Chinapay 銀聯卡付款通道

花了幾天的時間，終於把這個問題處理完成。以下介紹一下如何串接 Drupal 6.x 的 Ubercart 2.x 與紅陽科技的 Chinapay 銀聯卡付款通道。

首先，當然是先取得這個串接模組，目前我已上慱到 Drupal Taiwan 網站，可以從這裡取得。取得之後，請把這個模組安裝到 sites/all/modules/ubercart/payment 的目錄下面。不過當 ubercart 版本更新時，此目錄會被覆蓋掉，假如擔心因此需要再重新安裝一次紅陽 Chinapay 模組的話，那麼也可以將這個模組安裝在 sites/all/modules 下面。

接下來，要做一些設定。由 Drupal 網站上的 Administration Menu 或是你自已的 Drupal 管理介面，來到 Store Administration -> Configuration -> Payment Settings 的管理介面。

再來，再選擇 Edit 的子頁籤，接下來，再選擇 Payment Methods 的子子頁籤。


這裡會有一個 Payment Method 叫做「紅陽科技 ChinaPay」，先把它勾選啟動起來，此通道的權重 (List Position) 由你決定。如下面圖示。



接著就是在同一個畫面上紅陽科技的 Chinapay 設定了，如下圖。我已經盡量將資訊作完整，填寫這些設定應該不難。



其中的第一個設定是「 使用測試通道, 進行測試交易 」。此串接模組根據紅陽科技 Chinapay 的文件，在你選擇使用測試通道時，通道的網址會自動定義為紅陽文件中所示的測試用銀聯卡付款網址，並且在串接到測試通道時，也會使用測試用商家帳號。使用測試通道時，請依照紅陽科技 Chinapay 的文件輸入相關的資料。

不過，可惜的是，我一直無法成功轉接到紅陽 Chinapay 的測試網址，因此到底有沒有如文件上所說的測試通道，就要問一下紅陽了。

即使如此，我們還是可以利用正式通道與正式的商家帳號繼續測試，一直到轉接到紅陽科技 Chinapay 的付款網頁為止。

關於台幣 : 人民幣的匯率換算這個欄位，你可以參考奇摩 Yahoo 的理財網頁取得相關的匯率。這裡目前是一個文字欄位，因此填寫之後，後續的匯率換算都會用這個匯率值。

如果你想要每天自動取得當日的匯率值。那麼你可以寫一個程式取得相關的匯率值，並且存到上述設定畫面中關於匯率欄位提示的 Drupal 變數。如此一來，你的系統便可以每天利用最新的匯率值進行交易的結算與轉換。

另外在匯率換算之後，不可避免地會產生小數位的情形。這裡我提供了二個選擇來處理人民幣小數位的問題：四捨五入或是無條件進位到整數。

關於 Payment Methods 這個管理介面裡的相關設定完成後，接下來，我們還要再設定 Checkout Settings。再從 Drupal 的管理介面，來到 Store Administration -> Configuration -> Checkout Settings。

到了 Checkout Settings 的管理介面，再選擇 Edit 的子頁籤，接下來，再選擇 Ceckout Panes 的子子頁籤，如下圖。



在這裡我們要做的設定是把紅陽科技 Chinapay 的 checkout pane，稱之為「人民幣換算」，把它啟動起來，同時權重設大一點，讓這個 pane 在檢視訂單時，成為最後一個出現的 Pane。

以上設定完成之後，我們可以開始加入商品到購物車，並且進行結帳。

結帳時，請選擇紅陽科技 Chinapay 銀聯卡付款通道，如下圖。



接下來，按下檢視訂單的按鈕。如此會來到檢視訂單的網頁畫面，如下圖。



在這個畫面，因為我們採用了紅陽科技 Chinapay 銀聯卡的付款通道，因此在訂單小計的小窗之後，會多一個叫做「人民幣換算」的小窗。這裡的金額就是買家需要支付的人民幣金額。

假如使用者沒有選擇紅陽 Chinapay 的付款通道的話，這個小窗在檢視訂單時不會出現，以避免不必要的資訊干擾。

在按下了「付款 - 使用紅陽 Chinapay - 銀聯卡交易管道」，接著就會轉接到紅陽的 Chinapay 銀聯卡付款的網頁。使用者在這個網頁上填寫相關的銀聯卡資訊後，交易便完成了。