萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> CMS 教學

帝國CMS商城自定義支付接口開發全流程(從複製默認接口到數據庫註冊)

一、支付體系概覽

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

二、支付參數配置(基礎設置)

後台 → 其他 → 支付參數配置:

  • 一元可購買點數:設定 1 元 = 多少點數(虛擬幣系統用)。
  • 最小支付金額:防止測試小額訂單干擾對賬。

支付參數配置

參數詳情

三、內置接口參數配置(以支付寶為例)

  1. 後台 → 其他 → 在線支付 → 管理支付接口。
  2. 點擊「支付寶」後的 配置接口。

管理支付接口列表

配置項詳解:

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

接口參數配置界面

配置詳情

四、支付記錄管理

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

支付記錄詳情

五、新增自定義支付接口(核心開發步驟)

1. 複製默認接口目錄作為模板

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

複製接口目錄

2. 修改接口核心文件

進入 /e/payapi/diypay/,逐一修改:

  • config.php:定義接口常量(商戶號、密鑰、網關 URL、回調地址、簽名方式等)。
  • submit.php:構建提交表單(GET/POST)、生成簽名、跳轉支付網關。
  • notify_url.php:處理異步通知(驗證簽名、解析業務參數、調用系統 PayApiReturn() 更新訂單)。
  • return_url.php:處理同步跳轉(用戶端返回頁面提示)。

接口文件列表

3. 數據庫註冊接口類型

執行 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 為序列化配置數組,可留空由後台配置界面寫入。

4. 後台配置新接口參數

重複「三」中的步驟,在「管理支付接口」中會出現新增的「自定義支付」,點擊配置填寫實際參數。

5. 添加前台支付方式

重複文章開頭「第二步」操作,支付地址填 /e/payapi/ShopPay.php?paytype=diypay。

六、開發調試建議

  • 本地/測試環境使用支付平台沙箱/測試賬號。
  • 異步通知 notify_url 必須公網可訪問,本地調試用 ngrok/frp 映射。
  • 日誌記錄:在關鍵節點(收到通知、驗簽結果、更新訂單)寫入文件日誌,便於排查。
  • 參考官方 alipay、chinabank 接口代碼風格,保持一致性。

七、總結

帝國CMS 支付擴展機制清晰:文件目錄名 = paytype = 數據庫標識。掌握此規律,即可快速接入任意支付渠道,構建多元化收款體系。

copyright © 萬盛學電腦網 all rights reserved