平台對接插件使用教學
魔方財務對接插件教學
1. 安裝插件
將插件壓縮包解壓縮到 public/plugins/servers/ 目錄下。
確保解壓縮後的資料夾名稱與插件名稱一致，且目錄結構正確。
2. 新增介面
登入魔方財務後台，依序進入 設定 → 商品設定 → 通用介面，點擊 建立介面。
在編輯介面頁面，依以下說明填寫：
- 名稱：任意填寫，便於識別即可。
- IP 位址：填寫平台網域名稱。
- 伺服器模組：選擇 雲尚 API 分銷模組（若未找到，請檢查插件是否安裝成功）。
- 介面容量：依您的業務需求填寫（例如 1000）。
- 使用者名稱是應用 ID，密碼是應用金鑰（全域應用）。
3. 新增商品
商品分組：您可以選擇既有分組，也可以新建一個分組（例如「API 產品」）。
基本資訊：填寫商品名稱、描述等資訊。注意：「主機名稱」和「密碼」選項請不要開啟（保持關閉），其餘欄位可依需求自由調整。
定價：選擇「一次性」計費模式，並將價格設定為 0（此處僅為佔位，實際價格由可設定項目決定）。
自動開通：
- 開通方式：選擇 自動化介面。
- 介面分組：選擇您在 第 2 步 建立的介面分組。
- API 代碼：填寫您平台 API 的英文呼叫代碼（可從本平台的開發文件中取得）。
- 預設次數：可填寫 0，或依需求設定預設次數。
- 預設有效期限：建議填寫 12（表示 12 個月，可依實際調整）。
4. 設定可設定項目（即商品規格）
在商品編輯頁面，找到 可設定項目 區域，點擊 新增設定項目。
設定項目設定：
- 設定選項名稱：必須填寫為 「次數」（用於識別 API 呼叫次數）。
- 設定項目類型：選擇 單選。
- 子項目名稱：填寫您希望提供的次數級距，例如 100、200、500 等（僅填數字）。
價格設定：在對應子項目右側的「一次性價格」欄位中，設定該級距的售價。
> 範例：若子項目名稱為 100，一次性價格設為 4，則表示使用者支付 4 元可購買 100 次 API 呼叫。
5. 前台效果
完成以上設定後，使用者在前台商品詳情頁將看到類似下圖的選擇介面，可依需求選擇不同的次數級距並下單。
