使用 Shopyy / Shopoem 接受加密貨幣付款

01 · 準備 MochiPay 賬戶

1. 建立賬戶 與 啟用訂閱.
2. 開啟 錢包，選擇新增 HD 錢包 → 生成新錢包，私下備份助記詞並儲存，啟用測試使用的資產 / 網路。
3. 在此處設定客戶能識別的顯示名稱 賬戶資料.
4. 開啟 API 憑證 並複製 API Key。此 SaaS URL 使用 Key，不含 API Secret。

完成標準： 你的訂閱與收款錢包均有效，並已取得下方所需憑證。

結賬模式： 經典 SaaS 僅支援 HPP，現有支付介面跳轉至 MochiPay，不安裝站內外掛。

02 · 配置支付介面

開啟 Shopyy / Shopoem 商城後臺，找到相容的自定義支付閘道器或支付介面設定。具體選單名稱取決於賬戶和平臺版本。

開啟： 你的 Shopyy / Shopoem 支付介面配置

模式 1：固定幣種與網路

帶 /{PaymentMethod} 時，客戶直接進入指定幣種與網路的掃碼付款頁。

POSThttps://mochi.bz/api/v/orders/legacy_create/YOUR_API_KEY/USDT_TRC20

模式 2：在收銀台選擇

客戶到 MochiPay 收銀台選擇付款幣種與網路，再產生 QR 碼付款。

POSThttps://mochi.bz/api/v/orders/legacy_create/YOUR_API_KEY

兩種模式沿用相同的 POST 參數、回傳格式與回呼流程。

設定	填寫內容
URL 中的 API 憑證	你的商戶 API Key，絕不能填寫 API Secret
訂單與回撥欄位	保留平臺現有 POST 欄位、通知 URL 與返回 URL

Shopyy 和 Shopoem 使用同一相容閘道器格式。如果平臺無法提供或編輯此介面，請詢問平臺客服配置位置。請勿將原訂單格式替換為 JSON REST API 格式。

此示例的完整介面 URL 為：

https://mochi.bz/api/v/orders/legacy_create/YOUR_API_KEY/USDT_TRC20

請將 YOUR_API_KEY 替換為自己的金鑰。每個支付選項對應一種資產/網路，保留平臺原有表單 POST 或序列化子欄位格式及回撥欄位。

完成標準： 商城結賬時可選擇 MochiPay。

03 · 下單並支付測試訂單

將低價演示商品加入商城購物車。結賬時選擇 MochiPay 和已啟用的 USDT/TRC20 支付方式，提交訂單並進入托管收銀臺。

1. 確認所選幣種為 USDT，網路為 TRON（TRC20），並支付付款頁顯示的準確金額。
2. 傳送 付款頁上的精確金額 傳送至顯示的收款地址，不能取整或複用其他訂單地址。
3. 等待所需鏈上確認，並等 MochiPay 訂單狀態變為 PAID.

商城/API 示例可用美元標價。MochiPay 在建立訂單時鎖定匯率，唯一金額調整可能改變最終應付金額。請以收銀臺顯示金額付款。

成功檢查： MochiPay 訂單顯示 PAID 且已記錄交易，僅開啟瀏覽器返回頁不構成付款證明。

04 · 驗證結果與錢包收款

確認商城訂單進入已配置的已付款狀態。若 MochiPay 為 PAID 而商城未更新，請檢查平臺回撥/通知 URL 及其可訪問性。

核對付款交易、收款地址與 MochiPay 訂單，檢視收款錢包或區塊鏈瀏覽器。資金已在您的收款錢包中，無需申請平臺提現。

使用相容錢包轉移資金，並等待鏈上確認。 閱讀收款錢包管理指南 →

測試未完成時