OpenPortal认证计费系统-用户手册 · 充值管理

适用系统：OpenPortalServer V6 后台 — 充值管理

手册说明：本文所有截图取自系统实际界面并按页面原样展示（未做任何遮挡），实际参数以生产环境为准。

一、模块概述

充值管理负责让接入账号获得上网时长或流量。用户买卡、扫码付款、或通过 ISP 渠道缴费后，系统据此为账号充值。本模块管理三类充值介质的生成与查询，以及收款通道的配置。

三条业务线：

功能地图

其中「新增/修改」类页面从对应列表页的按钮进入，不需要手工输入地址。

二、界面通用操作

后台所有列表页布局一致，掌握这一套，后面每个页面都一样用。

2.1 页面结构

1. 顶部位置条：显示「首页 → 模块 → 当前功能」，可点击返回上级。
2. 操作选项：可折叠。上半部分是查询条件，下半部分是操作按钮。
3. 数据表格：表头可点击排序，底部是分页条。

2.2 查询

• 条件填好后点「查询」；点「刷新」按当前条件重新加载。
• 条件留空表示不限制该字段。
• 日期格式为 yyyy-MM-dd，起始与结束都包含当天。
• 「排序」开关：默认 按编号从小到大，切换为 反向 则从大到小。

2.3 分页与列设置

• 底部可切换每页 10 / 20 / 30 / 40 / 50 条。
• 「数据设置」用于显示或隐藏表格列。该设置只对当前浏览器生效，清理浏览器缓存后会恢复默认。

2.4 导出

• 「按搜索结果导出」导出的是当前查询条件下的数据，不是整张表。
• 数据量较大时生成需要等待，点击后请勿重复点击。
• 导出只读取数据，不影响系统内的任何记录。

2.5 删除

• 单条删除在表格最右侧的「操作」列；批量删除先勾选行首复选框，再点「删除勾选」。
• 每次删除都会弹出确认提示，确认后立即生效。
• 删除不可撤销、没有回收站。删除前建议先导出留档。

三、充值卡管理

3.1 充值卡列表

查询、导出和作废已经生成好的充值卡，并查看每张卡当前的使用状态。

查询条件

表格字段：编号、名称、计费策略、充值用户、用户组、CD-KEY、充值记录、创建日期、充值日期、状态、售价、操作

操作按钮

使用步骤

1. 进入「充值管理 → 充值卡列表」。
2. 填写查询条件后点「查询」；要查看全部卡，直接点「刷新」。
3. 需要留档时点「按搜索结果导出」，浏览器会下载 Excel 文件。
4. 作废卡：单张点该行「删除」，多张则勾选后点「删除勾选」。

注意事项

• CD-KEY 就是充值凭据，等同于密码，导出文件请按敏感资料保管。
• 状态说明：「新卡」为尚未售出，「已售出」为已分发但未使用，「已激活」为已被使用。
• 已激活的卡被删除后，已经充值到账号的时长不会退回。

3.2 新增充值卡

从列表页点「添加」进入，用于按计费策略批量生成充值卡。

填写项

使用步骤

1. 选择计费策略，卡名称通常会自动带出，可手动修改。
2. 填写创建数量。
3. 点「保存」返回列表；点「返回」放弃本次填写。

注意事项

• 数量较大时生成需要等待，建议单批不超过 1000 张，分批生成更稳妥。
• 生成后状态为「新卡」，此时还未对外分发。

四、二维码充值

用户手机扫码完成支付，系统据支付结果自动充值。与充值卡的区别是：卡是提前印好的，二维码是按有效期生成、扫码后才产生实际充值。

4.1 二维码充值列表

查看扫码充值记录，跟踪每一笔的支付与使用状态。

查询条件：名称、充值用户、用户手机、状态（未使用 / 已使用 / 充值失败）、计费策略、用户组

表格字段：编号、名称、计费策略、状态、到期日期、创建日期、单价、充值用户、用户组、充值记录、用户手机、充值日期、操作

操作按钮：添加、查询、刷新、删除勾选、按搜索结果导出、数据设置（用法同 §3.1）

注意事项

• 「到期日期」是二维码的有效期，过期后用户扫码无法付款充值。
• 「充值记录」列可查看这笔充值带来的时长或余额变动明细。
• 状态为「充值失败」的记录，通常是用户支付后回调异常，需核对支付平台流水。

4.2 新增二维码充值

从列表页点「添加」进入，按批次生成扫码充值码。

填写项

使用步骤

1. 选择计费策略。
2. 填写批次名称与创建数量。
3. 填写到期日期，确认晚于预期使用时间。
4. 点「保存」。

注意事项

• 到期日期填错会导致整批二维码立刻失效。
• 第一次使用建议先生成 1 条验证流程，再批量生成。

五、ISP 充值

ISP 充值用于「渠道代收」场景：合作渠道把缴费名单交给你，你通过 Excel 批量把缴费落到对应账号上。分分类和记录两级，先建分类，再填记录。

5.1 ISP 充值分类

分类决定「这笔充值的钱进哪个用户组」以及「结算截止日怎么算」。没有分类就无法添加充值记录。

分类列表

• 查询条件：编号、名称、用户组
• 表格字段：编号、名称、用户组、截止日、操作
• 操作按钮：添加、查询、刷新、删除勾选、数据设置

新增 / 修改分类

新增从列表页点「添加」，修改点对应行的「修改」，两个页面填写内容一致。

注意事项

• 修改分类的用户组，只影响之后新增的充值记录，已有记录不会迁移。
• 删除分类前，请确认该分类下已没有充值记录。

5.2 ISP 充值记录

管理渠道缴费名单，可按账号、电话、分类检索。

查询条件：编号、名称、电话号码、充值用户、所属分类、是否使用

表格字段：编号、名称、所属分类、电话、最后更新日期、是否使用、最后充值日期、充值用户、姓名、身份证号、地址、操作

操作按钮

注意事项

• 本页有三个删除入口，「删除全部」和「按搜索结果删除」会批量清除数据，操作前务必先用查询条件确认范围，并先导出留档。
• 表格中包含姓名、身份证号、电话等个人信息，导出文件请按个人隐私资料管理。

新增 / 修改充值记录

新增从列表页点「添加」，修改点对应行的「修改」，两个页面填写内容一致。

5.3 ISP 增量导入

通过 Excel 批量追加充值记录，只新增，不改动已有记录。

页面元素：最近一次导入的操作人、导入时间、成功与失败条数，「查看上一次导入失败列表」「模板下载」「选择文件」和提交按钮。

使用步骤

1. 点「模板下载」获取标准 Excel 模板。
2. 按模板填写，注意列顺序与必填项。
3. 点「选择文件」选中填写好的文件，提交。
4. 页面显示本次成功与失败条数；若失败不为 0，点「查看上一次导入失败列表」定位具体行。

注意事项

• 模板格式不要自行改动，列顺序错位会导致整批失败。
• 导入前先确认目标分类已建好。
• 每次导入前建议先在列表页确认没有重复记录。

5.4 ISP 匹配导入

按 Excel 中的账号匹配系统内已有账号并完成充值，与 §5.3 的「只建记录」不同，本页会实际改变账号的时长或余额。

使用步骤

1. 按页面模板整理账号与充值内容。
2. 点「选择文件」选中文件，提交。
3. 提交后查看处理结果，并抽查若干账号的实际时长或余额是否正确。

注意事项

• 本页会直接变更账号数据，建议先用 1～2 个测试账号验证模板，再处理正式批次。
• 匹配不上的账号不会充值，请逐条核对结果清单。

六、支付平台设置

配置前台自助充值的收款通道，以及「未付款用户可临时上网」的放行策略。页面分四组：支付放行公共帐号、支付宝、微信、iPay。

6.1 支付放行公共帐号

6.2 支付宝对接

6.3 微信对接

6.4 iPay 通道

使用步骤

1. 进入「充值管理 → 支付平台设置」。
2. 只启用需要的通道，未使用的通道把状态设为「停用」。
3. 点「保存」，配置立即生效，无需重启系统。

注意事项

• 校验模式从 MD5 换成 RSA（或反向）时，两套字段必须同时填全，否则用户付款后系统无法确认到账。
• 配置填错会导致前台充值页面无法下单，改动后请立刻用一笔小额订单验证。
• 本页的密钥类字段以明文显示，任何截图、录屏或远程协助画面都不要停留在本页。

七、支付放行记录

用户未付款也能临时上网若干次，本页记录每个终端或账号当天已经用掉多少次放行。

查询条件：MAC/帐户

表格字段：编号、MAC地址/用户名、今日次数、操作

操作按钮：查询、刷新、删除勾选、删除全部、数据设置

使用步骤

1. 按 MAC 地址或账号查询。
2. 查看「今日次数」，找出已用完放行次数的终端。

注意事项

• 删除一条记录等于把该终端当天的放行次数清零，用户可再次免付费上网。需要限制用户时请谨慎删除。
• 本页只记录放行次数，不影响在线用户；要让用户下线请到「Portal在线记录日志」或「Radius在线列表」操作。

八、信息与安全提示

以下内容涉及数据安全与合规，日常使用请留意。

1. CD-KEY 等同密码。充值卡列表导出的文件中包含卡密，属敏感资料，不要通过即时通讯工具随意传递。
2. 支付密钥不外泄。支付平台设置页的密码、AppSecret、商户私钥以明文显示，截图或录屏前请先离开该页面。
3. 个人信息需保护。ISP 充值记录中包含姓名、身份证号、电话和地址，导出文件应按个人信息管理要求存放与销毁。
4. 批量删除先留档。所有删除都不可撤销，尤其是「删除全部」「按搜索结果删除」这类批量入口，操作前先导出备份。
5. 配置变更后立即验证。支付通道、放行次数这类配置影响前台用户能否正常充值上网，改完请用测试账号走一遍完整流程。
6. 充值通知默认关闭。需要「充值成功后通知管理员」时，到「系统管理 → 系统全局设置」页底部的「系统通知渠道设置」按模块开启并保存（详见 02 篇 4.7），出厂与升级后都是全关状态。