本模块分为 Nuxt工程 版本和普通版本两种，购买安装前请注意区分

模块简介

本模块为BuildAdmin应用提供了一套完整、专业的会员余额充值解决方案。支持灵活配置充值套餐，集成主流支付方式，并自动化管理充值订单与资金流水。

核心功能

• 套餐灵活配置：管理员可自定义多种充值套餐，支持设置支付金额、赠送金额及积分奖励规则。
• 多支付渠道集成：无缝集成微信支付、支付宝等主流支付方式（需依赖支付模块）。
• 自动化订单管理：系统自动记录每一笔充值订单的详细信息、支付状态及会员充值明细。
• 会员充值体系：助力商家快速搭建并高效管理会员充值业务，提升用户粘性与资金流动性。

配置说明

1. 支付模块依赖

本模块的支付功能依赖于BuildAdmin模块市场的支付模块。请确保您已：

• 安装并启用了支付模块。
• 已在支付模块中正确配置了微信和支付宝的商户参数（AppID、密钥、证书等）。

2. 充值套餐配置

启用模块后，您可以在后台管理界面（充值管理）中：

• 添加、编辑、删除充值套餐。
• 为每个套餐设置：
  • 充值金额（用户实际支付）
  • 赠送金额（额外赠送给用户的余额）
  • 奖励积分（充值成功后赠送的积分值）

3. 支付回调配置 (重要！)

支付成功后，微信/支付宝服务器会异步通知您的服务器处理订单。本模块已内置通知控制器，回调地址如下：

• 微信支付回调地址:
  http(s)://您的域名/index.php/api/recharge.Notify/wechat

• 支付宝回调地址:
  http(s)://您的域名/index.php/api/recharge.Notify/alipay

请注意：

• 请将 您的域名 替换为您实际部署的外部可访问的域名。
• 务必在微信支付和支付宝的商户平台中，将上述对应的URL设置为订单回调通知地址，否则无法正常接收支付成功通知并更新订单状态。

使用指南

1. 会员前台充值：

   • 会员可在前台 余额记录 查看可购买的充值套餐。
   • 选择套餐后，将跳转至相应的支付网关（微信/支付宝）完成支付。

2. 管理员后台管理：

   • 订单查询：查看所有充值记录，包括订单号、支付方式、金额、状态等信息。
   • 明细管理：跟踪每一笔充值带来的余额与积分变动详情。
   • 套餐管理：根据运营策略灵活调整上架的充值套餐。

常见问题

Q: 用户已付款，但订单状态一直显示“未支付”？
A: 绝大多数情况是回调地址配置错误或网络问题导致通知无法送达。请依次检查：

1. 支付模块中的商户配置是否正确。
2. 设置的回调地址是否与模块提供的地址完全一致。

Q: 模块启用后找不到管理菜单？
A: 请检查您的用户角色是否拥有访问充值管理菜单的权限。管理员需在 系统管理 -> 菜单规则 中确认菜单已生成并分配相应权限。