使用 Shopware 6.6 / 6.7 接受加密貨幣付款

選擇正確的安裝包與 PHP 環境

使用安裝包與確切商城核心均允許的 PHP 版本，外掛不能使舊商城核心相容新版 PHP。

新包使用可選 request_id 去重功能，需要 MochiPay Web65 或更高版本。已有客戶可繼續使用當前外掛和 API 接入。

01 · 準備 MochiPay 賬戶

1. 建立賬戶 · 啟用訂閱.
2. 錢包 · 為準備提供的每種幣種和網路啟用收款錢包，並在結賬前備份恢復資料。
3. API 憑證 · 商戶 API Key 和 Secret 僅儲存在服務端，不能放入結賬 HTML 或瀏覽器指令碼。

02 · 安裝並啟用原生閘道器

1. 僅安裝對應 Shopware 分支的 ZIP。可在 Extensions > My extensions 上傳，或將 MochiPay 解壓到 custom/plugins/MochiPay。不要同時安裝兩個包。
2. 在商城根目錄執行 bin/console plugin:refresh，再執行 bin/console plugin:install --activate MochiPay。
3. 為使用此閘道器的每個銷售渠道配置憑據並啟用擴充套件。在 Settings > Payment methods 啟用支付方式並分配銷售渠道。
4. 將 Shopware 6.6 升級到 6.7 時，先備份設定和支付歷史，再用 6.7 包替換外掛檔案，最後按正常流程執行 plugin:update MochiPay。

每個 ZIP 內的英文 README 包含準確路徑、原生配置、依賴和升級說明，請按對應平臺的檔案操作。

03 · 檢查預設預設值

填寫 API 憑據，選擇 Unique amount direction 的 UP 或 DOWN，啟用 MochiPay 並儲存。ON_SITE 和六種支付方式已預選；僅向客戶提供已啟用收款錢包的方式，仍需完成原生支付方式與渠道設定。

04 · ON_SITE 和 HPP 使用同一筆支付

重新開啟結賬或切換展示模式會複用已儲存的支付訂單。MochiPay API 無需新增 payment_mode 引數。

05 · 正式使用前驗證測試訂單

1. 建立小額測試訂單。付款前確認法幣總額、所選幣種、網路及準確加密貨幣金額。
2. 確認服務端查詢 MochiPay，只有匹配的 PAID 結果才更新原生已付款狀態。返回 URL 或回撥內容本身不能證明付款。
3. 測試 HPP、ON_SITE、重新開啟結賬及重複通知，確認複用同一訂單且只處理一次支付完成。

這些下載包已完成原始碼與介面檢查及模擬結賬驗證。完整原生商城安裝和真實付款結賬仍需測試環境驗收。

排查問題與下載

若閘道器未顯示，請檢查準確商城分支、PHP、快取、原生支付方式啟用狀態及渠道限制。若訂單一直等待付款，請檢查憑據、有效訂閱、錢包和公開回撥可達性。升級時保留已有支付嘗試記錄。