06 充值、支付、CDK 与余额刷新 ​充值和支付是玩家最敏感的功能。管理需要知道：玩家付了钱后系统怎么到账、什么时候刷新余额、不到账时先查哪里。

入口：

text玩家前端 -> 充值

商城后台 -> 支付设置

商城后台 -> 抖音插件 / CDK相关功能示例视频预留

这里后续可放“充值支付完整流程”的视频，例如：/mp4/newwebdoc/06-payment.mp4

一、充值页面有哪些功能 ​玩家充值页常见卡片包括：

充值商城币商城币换游戏美金游戏美金回收商城币商城币换金条CDK 兑换建家权限购买不同服务器可以按实际需要显示或隐藏部分功能。

二、充值商城币 ​玩家选择充值档位并支付后，系统会通过支付回调确认订单。

正常流程：

玩家选择充值档位。选择支付方式。打开支付 iframe 或跳转支付页面。支付平台回调后端。后端校验订单和签名。给玩家增加商城币。玩家前端自动刷新余额。如果配置了会员“充值加成”，到账数量会按百分比计算。

示例：

text原本 1 元到账 100 商城币

会员充值加成 = 120

实际到账 = 100 * 120 / 100 = 120 商城币三、支付回调与补单 ​支付是否到账以服务器后端收到并处理回调为准，不以玩家浏览器页面是否关闭为准。

玩家说“我付了但没到账”时，管理排查顺序：

支付平台是否显示支付成功。后台支付订单是否存在。订单状态是否已回调成功。玩家 SteamID 是否正确。是否已经手动补单或重复到账。后台会员/通行证订单支持补单。补单前建议确认：

订单确实支付成功。玩家权益未到账。没有重复补单记录。补单会按订单类型处理权益：

订单类型补单后处理商城币充值增加商城币，并应用会员充值加成建家权限写入管理权限表，等待 AdminUsers.ini 同步会员订单更新会员等级、会员称号、到期时间和赠送代币通行证订单切换玩家付费通行证资格如果订单已经是成功状态，不要重复补单。重复补单可能导致玩家重复获得权益。

补单要留痕

补单属于管理员操作，建议在后台审计日志中保留记录，方便以后核对。

玩家等待支付回调时，不建议反复重新支付同一档位。可以让玩家保留订单号、支付截图和 SteamID，管理在后台订单或支付平台里核对。

四、余额为什么不是立即变化 ​不同余额来源不同：

余额来源商城币数据库 user.金币数量游戏美金RCON 在线玩家数据同步到 user.游戏美金金条RCON 在线玩家数据同步或对应命令变动商城币支付成功后通常会很快刷新。游戏美金和金条可能要等下一次 RCON 在线玩家数据刷新。

玩家常问：

text我游戏里美金变了，为什么网页还没变？可以解释：网页显示的是后端最近一次 RCON 同步结果，不是游戏内实时推送。让玩家等待一个数据获取间隔，或让管理查看数据面板最近在线玩家同步。

五、商城币换游戏美金 ​这个功能会扣除玩家商城币，并通过 RCON 给玩家增加游戏美金。

常见命令：

text#ChangeCurrencyBalance Normal 金额 SteamID管理需要配置兑换比例，让系统知道商城币和游戏美金的换算关系。

六、游戏美金回收商城币 ​这个功能会通过 RCON 扣玩家游戏美金，再给玩家增加商城币。

注意：

扣美金实际由 RCON 命令完成。本地 游戏美金 只用于余额限制和显示。如果 RCON 不在线，不建议开放该兑换功能。七、CDK 兑换 ​CDK 可以用于给玩家发放不同类型的奖励。

常见 CDK 类型：

类型兑换结果金币充值卡增加商城币美金充值卡发送 RCON 命令增加游戏美金声望充值卡发送 RCON 命令增加声望金条充值卡发送 RCON 命令增加金条商品兑换卡按商品配置发货会员兑换卡调整玩家会员等级或到期时间复活币充值卡增加复活币付费通行证兑换卡给玩家开通付费通行证资格声望充值卡建议使用：

text#ChangeFamePoints 数量 SteamID八、CDK 使用次数 ​CDK 会记录使用次数和领取记录。玩家兑换失败常见原因：

卡密不存在。卡密使用次数已达上限。玩家已经使用过该卡密。CDK 类型配置错误。RCON 不在线导致游戏货币类奖励暂时无法到账。九、建家权限购买 ​建家权限属于充值页中的特殊服务。

价格为 0 时不允许购买。玩家重复购买或续买时，应增加可用时间，而不是覆盖成更短时间。

建家权限实际基于服务器 AdminUsers.ini：

textSteamID[SetGodMode]购买成功后，系统会同步 AdminUsers.ini，并通过游戏内提示告诉玩家使用：

text#SetGodMode True如果建家权限托管关闭，则不应允许玩家购买，也不应同步或监管建家权限。

十、玩家可能会问 ​玩家说：支付成功了，页面还显示未到账？ ​支付页面可能比回调更早返回。让玩家稍等几秒，前端会轮询订单状态并刷新余额。如果仍未到账，管理查后台订单和支付平台记录。

玩家说：我关闭了支付页面，会不会不到账？ ​不会因为关闭页面就必然失败。只要支付平台成功回调后端，权益仍会到账。关闭页面只会影响玩家前端即时展示。

玩家说：CDK 说已使用？ ​CDK 有使用次数和玩家领取记录。管理需要查卡密库存和使用记录，确认是同一个玩家已兑换，还是卡密总次数到上限。

玩家说：充值页没有套餐或没有支付按钮？ ​套餐来自后台支付/充值配置；支付宝、微信按钮可能被后台隐藏。管理先检查支付设置中的充值档位和支付方式显示开关。

玩家说：顶部余额和个人中心余额不一样？ ​支付成功后前端会尝试刷新导航余额。如果玩家页面停留太久或网络卡顿，可能还没刷新。让玩家刷新页面或重新打开个人中心；管理可在后台玩家信息中查真实余额。

玩家说：买了建家权限，游戏里没提示？ ​管理先查建家权限记录是否写入、AdminUsers.ini 是否上传成功，再看发货队列里是否有提示消息。提示应显示玩家昵称，不建议直接显示 SteamID。

玩家说：建家权限到期为什么没踢出？ ​到期卸载权限通常只移除 AdminUsers.ini 权限，不一定踢出玩家。违规使用非 SetGodMode true 命令才应按服务器规则踢出或处理。

十一、本章检查清单 ​支付配置已填好，支付回调能到后端。充值后余额能自动刷新。会员/通行证订单能查询和补单。CDK 类型和次数配置正确。美金、金条、声望类奖励确认 RCON 在线。建家权限价格、时长、托管开关和同步状态正确。示例视频预留

这里后续可放“玩家不到账排查”的视频，例如：/mp4/newwebdoc/06-payment-troubleshooting.mp4