支付中心运维

版本 v1.0.1· 张先生 · 22 次获取 · 运维

支付中心：支付宝/微信官方、虎皮椒、易支付统一下单、回调与金币充值履约。

¥29.90

一次购买，永久使用

详情介绍

一、插件简介

项目	说明
插件标识	`payment`
版本	1.1.3
分类标签	交易
前台入口	充值 `/payment/recharge`、提现 `/payment/withdraw`、积分兑换 `/payment/exchange`（若社区开启伪静态，路径带后缀，如 `/payment/recharge.html`）
后台入口	应用中心 → 插件列表 → 支付中心；菜单「支付中心」`/admin/payment_order`
回调地址	`/payment/notify/{channel}`、`/payment/return/{channel}`（`channel` 为 alipay/wechat/xunhu/epay 等）

独立支付插件，为社区金币充值、VIP 现金购买、勋章付费等业务提供统一下单、异步回调与履约能力。支持支付宝官方、微信支付官方、虎皮椒、易支付四种通道，并可配置沙箱模式、弹窗扫码与提现/积分兑换。

二、核心能力

能力	说明
多通道支付	支付宝官方、微信官方、虎皮椒、易支付，可多选启用，前台按渠道展示
金币充值	阶梯充值套餐，按汇率换算到账金币
沙箱/模拟支付	联调时可不走真实通道，使用模拟支付完成订单
弹窗/跳转支付	弹窗展示二维码扫码，或关闭后跳转收银台/电脑网站支付
异步回调	各通道 notify/return 统一处理订单状态与业务履约
提现审核	用户申请金币提现，管理员在后台审核通过/拒绝
积分兑换	积分与金币双向兑换（需安装社区插件）
订单管理	后台查看充值记录、手动补单、删除订单
插槽扩展	`member_asset_tabs`：在「我的资产」页注入兑换/提现 Tab

三、依赖与安装

将插件目录置于 plugins/payment/。
在应用中心安装「支付中心」。
安装时自动创建 payment_order 表并注册后台菜单。
依赖：社区插件 community 提供金币/积分账户与提现表；业务插件（VIP、勋章等）通过支付服务发起订单。
配置各支付通道密钥后，将回调 URL 填入支付平台（格式：https://你的域名/payment/notify/alipay 等）。

四、应用中心基础配置

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

配置项	类型	默认值	说明
启用支付	开关	开	关闭后业务插件无法发起付费/充值
沙箱模式	开关	开	开启后不走真实通道，可用「模拟支付」完成订单（联调推荐）
弹窗支付	开关	开	开启后前台弹出二维码扫码；关闭后直接跳转支付链接
可用支付接口	多选	—	可多选；前台只展示支付宝/微信等渠道，实际走勾选的接口（优先官方，其次易支付，再次虎皮椒）
默认币种	文本	CNY	默认结算币种
金币汇率	数字	10	1 元默认兑换多少金币（可含小数）；到账金币四舍五入为整数；套餐可单独覆盖
充值套餐	套餐	6:60 等	按阶梯逐条添加：金额（元）与到账金币
支付宝 AppId	文本	—	勾选支付宝时显示
支付宝应用私钥	多行文本	—	RSA2 私钥，可带或不带 BEGIN 头
支付宝公钥	多行文本	—	支付宝开放平台「支付宝公钥」，非应用公钥
支付宝沙箱网关	开关	关	仅支付宝官方通道使用沙箱环境网关
微信 AppId	文本	—	勾选微信时显示
微信商户号	文本	—
微信 API 密钥	密码	—	商户平台设置的 API 密钥（V2）
虎皮椒 AppId	文本	—	勾选虎皮椒时显示
虎皮椒 AppSecret	密码	—
虎皮椒网关	文本	官方默认
易支付接口地址	文本	—	如 `https://pay.example.com`，不要末尾斜杠
易支付商户ID	文本	—
易支付商户密钥	密码	—	V1 接口填 MD5 密钥
易支付可用方式	多选	alipay,wxpay	决定前台能否出现对应渠道
开启提现	开关	关	开启后用户可在金币页面申请提现
最低提现金币	数字	100	每次提现至少需要多少金币
单次最高提现	数字	0	0 表示不限制
提现金币汇率	数字	10	多少金币兑换 1 元人民币
每日提现限额	数字	0	0 表示不限制，每日累计提现金币上限
开启积分兑换	开关	关	开启后用户可在前台将积分与金币互相兑换
兑换比例	数字	10	多少积分兑换 1 金币（双向同比例）
最低兑换积分	数字	10	积分换金币时，单次至少消耗多少积分
最低兑换金币	数字	1	金币换积分时，单次至少消耗多少金币
每日兑换限额	数字	0	0 表示不限制；按积分等值累计当日兑换消耗

五、后台重点配置

支付通道对接

支付宝官方：在开放平台创建应用，配置 RSA2 密钥，将异步通知地址设为 /payment/notify/alipay。
微信支付官方：配置 AppId、商户号、API 密钥，通知地址 /payment/notify/wechat。
虎皮椒：填写 AppId、AppSecret 与网关地址。
易支付：填写接口地址、商户 ID、密钥，并勾选可用支付方式。

充值套餐

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

提现审核

菜单「支付中心」内可查看提现记录，执行审核通过或拒绝（路由 community_withdraw）。

六、前台用户流程

金币充值：进入「我的资产」→ 选择充值套餐 → 选择支付渠道 → 弹窗扫码或跳转支付 → 支付成功后金币到账。
沙箱联调：开启沙箱模式后，可使用模拟支付按钮完成充值测试。
积分兑换（需开启）：进入 /payment/exchange → 输入数量 → 确认兑换。
金币提现（需开启）：进入 /payment/withdraw → 填写提现金币数 → 提交申请 → 等待管理员审核。

七、后台审核与运维

功能	路径	说明
充值记录	`/admin/payment_order`	查看所有支付订单
订单列表 API	`GET /admin/payment_order/list`	分页查询
手动补单	`POST /admin/payment_order/fulfill`	对未履约订单手动完成业务
删除订单	`POST /admin/payment_order/delete`	删除记录
提现列表	`/admin/community_withdraw`	查看提现申请
审核通过	`POST /admin/community_withdraw/approve`
审核拒绝	`POST /admin/community_withdraw/reject`

前台路由

方法	路径	说明
GET/POST	`/payment/notify/:channel`	异步回调
GET/POST	`/payment/return/:channel`	同步跳转
GET	`/payment/cashier`	收银台
GET	`/payment/status`	订单状态查询
GET	`/payment/recharge`	充值页
POST	`/payment/recharge/pay`	发起充值支付
GET	`/payment/recharge/result`	充值结果
POST	`/payment/recharge/simulate`	模拟支付
GET	`/payment/withdraw`	提现页
POST	`/payment/withdraw/submit`	提交提现
GET	`/payment/exchange`	积分兑换页
POST	`/payment/exchange/submit`	提交兑换

八、特殊说明

插槽：member_asset_tabs — 在会员资产页注入「积分兑换」「金币提现」Tab。
静态资源：无独立前台静态目录，支付 UI 由社区资产页承载。
数据表：payment_order — 统一支付订单，含业务类型 biz_type、履约状态 fulfilled。
旧配置兼容：历史 channel 字段自动迁移为 enabled_providers；epay_type 迁移为 epay_types。