【Drupal教學】Commerce Spgateway 金流模組介紹+使用

前言

由於最近工作上的需要，需要串接智付通Spgateway的金流。秉持著開源與推廣的精神，我們也有將這個模組放到Drupal之中，讓想要用Drupal Commerce來開發電子商務網站的人，可以考慮使用Commerce Spgateway模組來進行金流的串接。

模組簡介

Commerce Spgateway是一個串接藍新金流（智付通金流）的模組，主要是使用在Drupal Commerce與D7的環境之下，提供各種金流串接的服務。

• 模組名稱：Commerce Spgateway
• 專案網址：前往下載
• 需求環境：Drupal 7 + Drupal Commerce
• 重要備註：並非官方提供的模組，而是HelloSanta自行開發。
• 支援金流：信用卡、ATM轉帳、超商代碼繳費、WebATM、超商條碼繳費、超商取貨付款、Pay2Go電子錢包、Google Pay、Samsung Pay、信用卡分期（1/7 補上）

如何安裝

這個模組安裝的方式很容易，安裝方式如同基本的Drupal模組安裝，將模組下載到sites/all/modules之中並且於後台啟用即可，當然若你是習慣使用Drush來進行安裝的，也可以直接使用以下指令進行安裝。

$ drush en commerce_spgateway -y

安裝完畢並且啟用之後，即可看到智付通後台設定畫面（admin/commerce/config/spgateway）與數個付款方式(admin/commerce/config/payment-methods)。

智付通設定後台

付款方式後台畫面

申請測試帳號

若想要測試智付通的金流方式，需要先到智付通的測試平台，進行帳號的申請方能使用，若申請完畢之後，需要於他們後台，啟用各種金流服務，並且於後台將會拿到你的商店代號（MerchantID）與HashKey、HashIV兩種金鑰。

備註：

1. 記得信用卡啟用後，要等一段時間測試環境才會通過。
2. 測試帳號持續30天。

如何設定

若現在已經開通了測試平台拿到了兩組KEY之後，事情的準備工作就已經完成了。可以直接進入模組後台（admin/commerce/config/spgateway）進行設定。

參數說明：

• 智付通系統狀態：可以切換測試環境與正式環境，預設為測試環境。
• 商店代號MerchantID：智付通平台可得到此資訊。
• HashKey:智付通平台可得到此資訊。
• HashIV:智付通平台可得到此資訊。
• 商品資訊：在Spgateway付款頁面左邊可以看到此資訊。
• 商店備註：提供此參數，將會於 MPG 頁面呈現商店備註內容。
• 付款人電子信箱是否開放修改：在Spgateway付款時，是否可以修改電子信箱。
• 智付通會員：要用Spgateway是否一定要是智付通會員。

進行付款結帳

若上述的設定都已經完善，再次回到Drupal的購物流程，即可以看到幾種付款方式等著你選擇囉。於智付通後台，確認金流的功能都已經啟用的狀態下，就可以大膽的按下付款了，以信用卡功能為例，馬上就會看到信用卡的刷卡畫面了。

購物流程選擇付款方式頁面

智付通選擇信用卡付款畫面

想要調整交易限制時間？有效繳費期間？

在這個模組當中，每種金流方式，都有其對應的參數設定，例如：信用卡付款要在60秒內刷卡完畢。超商代收需要在7天內付款完畢。這些金流方式的設定，都在各自的付款方式設定之中。

舉例信用卡為例，例如想要將信用卡的交易限制改成90秒內要刷卡付款。

• 第一步：去付款方式後台（admin/commerce/config/payment-methods），選擇編輯

• 第二步：編輯底下的付款方式

• 第三步：修改交易秒數

所有付款方式都可以比照上面的作法，就可以做進一步的設定囉。

如何查看交易記錄？

在使用Drupal Commerce購物之後，所有的付款方式都有交易記錄，並且每筆交易紀錄中有著跟智付通對應的所有交易參數。要查看這些交易紀錄。

查看方式只需要到訂單列表（admin/commerce/orders），針對想要查看的訂單，選擇付款方式即可看到對應的交易紀錄（admin/commerce/orders/1/payment）（以訂單1的交易紀錄為例）

小結

這個模組主要是希望能夠讓想要串接智付寶金流的人，能夠更快速的串接金流。其實主要原因也是智付通官方並未針對Drupal Commerce提供對應的模組>"< 若大家在使用上面，有發現問題，也歡迎在這個專案開Issue告訴我們問題是什麼，希望這個模組可以幫到需要的人囉～ Enjoy～