支付中心运维管控

一、插件简介

独立支付插件，为社区金币充值、VIP 现金购买、勋章付费、付费内容等业务提供统一下单、异步回调与履约能力。支持支付宝官方、微信支付官方、虎皮椒、易支付、USDT；可配置积分/金币前台名称（全站插件共用）、沙箱模式、弹窗扫码、免登录购买，以及提现/积分兑换。

二、核心能力

三、依赖与安装

1. 将插件目录置于 plugins/payment/。
2. 在应用中心安装「支付中心」。
3. 安装时自动创建 payment_order 表并注册后台菜单。
4. 硬依赖：社区插件 community，提供金币/积分账户、资产流水与提现表。
5. 软依赖：消息中心（充值成功通知）；VIP、勋章、付费阅读、隐藏内容、网盘、积分商城、抽奖、签到、广告、任务中心、应用市场、发卡商城等通过本插件收款或读取积分/金币名称。未安装不影响支付中心本身。
6. 配置各支付通道密钥后，将回调 URL 填入支付平台（格式：https://你的域名/payment/notify/alipay 等）。站点需公网可访问；回调优先使用社区站点域名，避免内网 Host 导致无法到账。

四、应用中心基础配置

在应用中心 → 支付中心 → 配置，字段来自 configSchema：

五、后台重点配置

支付通道对接

1. 支付宝官方：在开放平台创建应用，配置 RSA2 密钥，将异步通知地址设为 /payment/notify/alipay。
2. 微信支付官方：配置 AppId、商户号、API 密钥，通知地址 /payment/notify/wechat。
3. 虎皮椒：微信、支付宝可分别填写 AppId、AppSecret 与网关；分项留空则回退通用配置。通知地址 /payment/notify/xunhu。
4. 易支付：填写接口地址、商户 ID、密钥，并勾选可用支付方式。通知地址 /payment/notify/epay。
5. USDT：填写网络、收款地址与汇率。可选配置回调密钥后使用 /payment/notify/usdt；未配置时也可在充值记录手动补单。

充值套餐

在应用中心按「金额:金币」格式配置阶梯，例如 6:60 表示 6 元到账 60 金币。套餐金币可覆盖全局汇率。自定义金额按「金币汇率」折算。

积分/金币名称

填写后，社区侧栏、资产明细、悬赏打赏、积分商城、抽奖、签到、广告、任务中心、应用市场、发卡商城等前台文案统一使用该名称。插件菜单名（如「积分商城」）不随此修改。

提现审核

菜单「支付中心」内可查看提现记录，执行审核通过或拒绝（路由 community_withdraw）。通过后金币不再退回；拒绝后金币退回用户账户。

六、前台用户流程

1. 金币充值：进入「我的资产」或侧栏「立即充值」→ 选择套餐或自定义金额 → 选择支付渠道 → 弹窗扫码或跳转支付 → 支付成功后金币到账。
2. 沙箱联调：开启沙箱模式后，可使用模拟支付按钮完成充值测试。
3. 积分兑换（需开启）：进入 /payment/exchange → 选择积分换金币或金币换积分 → 输入数量 → 确认兑换。
4. 金币提现（需开启）：进入 /payment/withdraw → 填写提现金币数与收款信息 → 提交申请 → 等待管理员审核。
5. 游客购买（需开启免登录购买）：未登录用户打开金币标价内容 → 选择现金支付 → 成功后解锁，作者按金币价入账。

七、后台审核与运维

前台路由

八、特殊说明

• 插槽：member_asset_tabs — 在会员资产页注入「积分兑换」「金币提现」Tab（文案随配置名称变化）。
• 静态资源：/static/payment/payment.css、recharge-modal.js、guest-pay.js；充值/兑换/提现页由社区布局承载。
• 数据表：payment_order — 统一支付订单，含业务类型 biz_type、履约状态 fulfilled。提现记录使用社区提现表。
• 名称约定：配置中的积分名称、金币名称仅影响前台展示，不改变数据字段 coins / gold。
• 旧配置兼容：历史 channel 字段自动迁移为 enabled_providers；epay_type 迁移为 epay_types；虎皮椒通用项在分项未填时回退。

九、推荐上线清单

• 关闭沙箱模式，配置真实支付密钥
• 在支付平台配置正确的 notify/return 回调 URL（HTTPS、公网可访问）
• 设置合理的金币汇率与充值套餐
• 按需填写积分名称、金币名称
• 测试支付宝、微信各至少一笔真实小额支付；若启用 USDT，用小额核对汇率与到账
• 若开启提现，设置最低/最高限额与汇率，并明确审核人员
• 若开启积分兑换，确认社区积分体系正常
• 若开放游客购买，确认仅金币标价内容可走现金购
• 确认 PHP 与服务器可接收 POST 回调（无防火墙拦截）

十、常见问题

Q：支付成功但金币未到账？ 检查订单 fulfilled 状态；可在后台手动补单。确认回调 URL 可被支付平台访问，且使用公网站点域名。

Q：前台没有支付方式？ 确认已启用支付、已勾选通道且密钥完整。沙箱模式下走模拟支付，不展示真实通道。

Q：易支付弹窗支付失败？ 部分易支付平台已升级 V2 RSA，需关闭弹窗支付改用跳转，或联系平台开通 V1 mapi。

Q：积分、金币名称没变？ 以本插件「积分名称」「金币名称」为准，保存后刷新前台。留空则显示默认「积分」「金币」。插件菜单名不会跟着改。

Q：前台不显示兑换/提现 Tab？ 需在应用中心分别开启「开启积分兑换」「开启提现」，且社区插件已安装。

Q：游客无法购买？ 需开启「免登录购买」，且内容必须为金币标价。积分标价不支持游客现金购。

Q：沙箱模式与支付宝沙箱网关的区别？ 全局「沙箱模式」使用模拟支付；「支付宝沙箱网关」仅让支付宝官方通道走沙箱环境，二者可独立配置。

Q：提现审核在哪里？ 后台「支付中心」菜单内，非独立菜单项。