帝国 CMS 会员支付接口配置

照着这篇做完，你能给帝国 CMS 站点打通一条可用的会员在线支付通道，并知道付款成功但会员没到账时该去查哪里。

第一步：确认版本，找到支付接口目录

这一步的目的是搞清楚你这套程序有没有自带支付接口文件，做完后你手里会有一个明确的目录路径。

登录后台，首页右下角能看到版本号，本文以帝国 CMS 7.5 为准（7.2 及以上差别不大）。用 FTP 或宝塔面板的文件管理器打开网站根目录，进入 /e/payapi/ 文件夹，正常会看到 alipay、chinabank、tenpay 等子目录，每个目录就是一个支付通道。

注意：如果你在 /e/payapi/ 里只看到一两个过时的接口，说明这是老版本自带的支付宝「即时到账」接口。该接口支付宝早已停止新签约，必须换成「电脑网站支付」或改用第三方插件，不要在这上面浪费时间。

第二步：在后台打开会员在线支付开关

这一步是让系统允许会员充值，做完后前台会员中心才会出现「在线充值」入口。

后台顶部菜单点「系统」→ 左侧「系统设置」→「系统参数设置」→ 切到「会员参数」标签页 → 找到「开启会员在线支付」并选「是」→ 页面底部点「提交」。

找不到菜单时，直接在后台右上角的搜索框里输入「支付」，系统会列出相关设置项。不同小版本的菜单名可能叫「支付接口设置」，位置在「系统」菜单下。

第三步：填写支付平台参数

这一步是把你的商户信息写进接口文件，做完后系统才知道钱该收到哪个账号。

以支付宝为例，打开 /e/payapi/alipay/ 目录，找到配置文件（通常叫 config.php 或 alipay.config.php），里面一般有这几项要填：

• 商户 PID：支付宝开放平台里的 2088 开头的一串数字
• 密钥：新版接口填应用私钥，老版填 MD5 密钥
• 收款账号：你的支付宝登录邮箱或手机号

改完保存，用 UTF-8 无 BOM 格式上传回去，别用记事本保存，容易带上 BOM 导致页面顶部多出空白。

注意：同步返回地址（return_url）填 /e/payapi/alipay/return_url.php，异步通知地址（notify_url）填 /e/payapi/alipay/notify_url.php。这两个地址必须能被外网直接访问，本地 localhost 测试收不到异步通知，会导致「钱扣了但会员没加钱」。

第四步：绑定接口与会员组权限

这一步决定哪些会员组能用这个通道充值。

后台「会员」→「管理会员组」，点开需要充值的会员组（比如「普通会员」），确认「允许在线充值」相关权限是开启状态，保存。

然后回到支付接口设置页，把支付宝通道的状态改为「启用」，并设一个排序值。如果站点同时开通了微信，建议只开一个默认通道，避免用户在前台看到一堆按钮不知点哪个。

第五步：前台实测一笔小额订单

这一步是验收，做完后你能确认整条链路是否真的通。

退出后台，用普通会员账号登录前台，进入「会员中心」→「在线充值」，输入 1 元，点「确认充值」，页面应该跳转到支付宝收银台。付款完成后，支付宝会先跳回你的站，几秒内再发一次异步通知。

回到后台「会员」→「会员管理」，找到这个账号，看「资金」字段是否增加，以及「充值记录」里有没有这条流水。

没加钱的话，按这个顺序查：先看支付宝商家后台的「交易记录」里通知状态是不是「已发送」；再看服务器上 /e/payapi/alipay/ 目录有没有写日志文件；最后检查 notify_url.php 是否被防火墙拦截。

小结

• 支付接口文件都在 /e/payapi/ 下，先确认版本再动手
• 后台开关在「系统 → 系统参数设置 → 会员参数」里
• 配置文件要填 PID、密钥、收款账号三项，用无 BOM 的 UTF-8 保存
• return_url 和 notify_url 必须公网可访问，异步通知才是到账的关键
• 测试用 1 元小额，通过后台会员资金和充值记录双重确认