先決條件:
Magento 版本:2.x
第一步:註冊 Crypto.com Pay 帳戶
如果你還沒有 Crypto.com Pay 帳戶,請先註冊。
前往儀表板上的「設定」頁籤,然後完成 KYC 要求。
一旦您有權存取 Crypto.com Pay 商家儀表板,即可夠生成一對秘鑰與可公開的金鑰。 API 金鑰可以在 整合 > API 金鑰頁籤中找到。
注意:您可以在左側選單上的測試資料開關之間切換,以在即時模式和測試模式下存取 API 金鑰:如果切換為開啟狀態,則 API 金鑰處於測試模式。如果切換為關閉狀態,則 API 金鑰處於即時模式。
第二步:在 Magento 上安裝外掛程式
您可以在我們的 GitHub 程式庫了解 Crypto.com Pay 外掛程式相關詳細資訊,並以下列步驟安裝:
在 Releases 頁面下載模組壓縮檔
解壓縮並將所有檔案上傳到你的 Magento 2安裝路徑,即將 zip 檔中的
/code/Cdcpay
/code>移到 Magento 伺服器中的/app/code/Cdcpay
登入您的伺服器,並在 Magento2 安裝的根目錄中執行以下命令:
php bin/magento setup:upgrade
php bin/magento module:enable Cdcpay_CDCCheckout
php bin/magento setup:static-content:deploy -f
重新整理你的 Magento2 快取
php bin/magento cache:flush
安裝完成,您現在可以在您的 Magento 商店中啟用 Crypto.com Pay。
注意:如果遇到類似「The requested class did not generate properly, because the ‘generated’ directory permission is read-only」錯誤訊息,或是在您的 Magento 2 商店中出現「Can't create directory」錯誤,表示您環境中的檔案權限設定不正確。 你可以參考 Magento 的說明文件以更新設定。
第 3 步:在 Magento 上啟用 Crypto.com Pay
登入 Magento 管理面板 。
前往 Stores > Configuration > Sales > Payment Methods 。
前往 Crypto.com Pay 並展開配置頁面。
在啟用中選擇 「Yes 」。
如果你想跳過測試流程,直接啟用即時交易,可以直接跳到第 5 步。
在測試模式的金鑰欄位中輸入自第 1 步中取得的值。
在測試模式中選擇「Yes」。
複製測試模式中的 Webhook 簽署密鑰 描述中的 webhook url ,並將
[Store URL]
以您的 Magento Store URL 來替換。回到 Crypto.com 商家儀表板,並確認左側選單的測試資料開關為開啟狀態。
前往整合 > Webhooks 頁籤。
點按新增 Webhook 按鈕,然後將複製的 webhook url 貼到 Payload URL 中 ,即可產生 webhook 使用的
簽署密鑰
。將
簽署密鑰
複製並貼回 Magento 配置頁面中的 測試模式下的 Webhook 簽署密鑰 。點按儲存配置 按鈕以儲存配置。
注意:請依據你是否正在進行測試,在表格中選擇正確的測試模式,同時確認你輸入了正確的密鑰,因為在測試模式和上線模式的密鑰是不同的。
第四步:檢驗流程
此時,Crypto.com Pay 已與您的 Magento 商店完全整合。 但是,建議至少進行一次付款流程測試。
請參閱此處了解如何完成付款測試。
Crypto.com Pay 核准付款後,結帳視窗便會顯示付款已獲准,而你的訂單狀態亦會更新。
第 5 步:配置即時交易帳戶
全面測試付款流程後,你可以按照以下步驟啟用即時交易:
登入 Magento 管理面板 ,然後前往 Stores > Configuration > Sales > Payment Methods ,然後展開 Crypto.com Pay 配置。
在測試模式中選擇「No」。
將你在商戶儀表板取得的即時模式
密鑰
填入即時模式密鑰欄位中。複製即時模式中的 Webhook 簽署密鑰 描述中的 webhook url ,並將
[Store URL]
以您的 Magento Store URL 來替換。回到 Crypto.com 商家儀表板,並確認左側選單的測試資料開關為關閉狀態。
前往整合 > Webhooks 頁籤。
點按新增 Webhook 按鈕,然後將複製的 webhook url 貼到 Payload URL 中 ,即可產生 webhook 使用的
簽署密鑰
。將
簽署密鑰
複製並貼回 Magento 配置頁面中的 即時模式下的 Webhook 簽署密鑰 。點按儲存配置 按鈕以儲存配置。
恭喜,您現在可以在 即時模式下接受加密貨幣支付。