帝國CMS 內置支付寶、財付通、網銀在線三大接口,同時支持開發者自行擴展任意支付渠道(微信支付、易寶、銀聯、PayPal 等)。核心流程:接口文件開發 → 後台配置參數 → 前台添加支付方式 → 數據庫註冊接口類型。
後台 → 其他 → 支付參數配置:



配置項詳解:
| 字段 | 說明 |
|---|---|
| 接口類型 | 唯一標識,如 alipay、tenpay、chinabank,新增接口時必須一致 |
| 接口狀態 | 開啟/關閉 |
| 接口名稱 | 後台顯示名稱 |
| 接口描述 | 備註信息 |
| 商戶號(ID) | 支付平台分配的商戶 ID |
| 密鑰(KEY) | 支付平台分配的簽名密鑰 |
| 手續費 | 提示用戶手續費說明 |
| 顯示排序 | 前台支付方式列表排序 |


後台 → 其他 → 在線支付 → 管理支付記錄:可查看所有支付流水、狀態、金額、時間,支持導出對賬。


進入服務器 /e/payapi/ 目錄,復制任一現有接口目錄(如 tenpay),重命名為你的接口標識(如 diypay)。

進入 /e/payapi/diypay/,逐一修改:
config.php:定義接口常量(商戶號、密鑰、網關 URL、回調地址、簽名方式等)。submit.php:構建提交表單(GET/POST)、生成簽名、跳轉支付網關。notify_url.php:處理異步通知(驗證簽名、解析業務參數、調用系統 PayApiReturn() 更新訂單)。return_url.php:處理同步跳轉(用戶端返回頁面提示)。
執行 SQL(或使用 phpMyAdmin 手動插入):
INSERT INTO `phome_enewspayapi` (`paytype`, `payname`, `paysay`, `payfee`, `payconfig`, `paymyorder`, `isdefault`)
VALUES ('diypay', '自定義支付', '自定義接口描述', 0, 'a:4:{s:6:"payid";s:0:"";s:4:"paykey";s:0:"";s:8:"payemail";s:0:"";s:9:"paypartner";s:0:"";}', 0, 0);
paytype 必須與目錄名 diypay 完全一致。payconfig 為序列化配置數組,可留空由後台配置界面寫入。重複「三」中的步驟,在「管理支付接口」中會出現新增的「自定義支付」,點擊配置填寫實際參數。
重複文章開頭「第二步」操作,支付地址填 /e/payapi/ShopPay.php?paytype=diypay。
notify_url 必須公網可訪問,本地調試用 ngrok/frp 映射。alipay、chinabank 接口代碼風格,保持一致性。帝國CMS 支付擴展機制清晰:文件目錄名 = paytype = 數據庫標識。掌握此規律,即可快速接入任意支付渠道,構建多元化收款體系。