大橘为重

主题切换

06 充值、支付、CDK 与余额刷新 ​

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

入口：

text
玩家前端 -> 充值
商城后台 -> 支付设置
商城后台 -> 抖音插件 / CDK相关功能

示例视频预留

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

一、充值页面有哪些功能 ​

玩家充值页常见卡片包括：

  • 充值商城币
  • 商城币换游戏美金
  • 游戏美金回收商城币
  • 商城币换金条
  • CDK 兑换
  • 建家权限购买

不同服务器可以按实际需要显示或隐藏部分功能。

二、充值商城币 ​

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

正常流程：

  1. 玩家选择充值档位。
  2. 选择支付方式。
  3. 打开支付 iframe 或跳转支付页面。
  4. 支付平台回调后端。
  5. 后端校验订单和签名。
  6. 给玩家增加商城币。
  7. 玩家前端自动刷新余额。

如果配置了会员“充值加成”，到账数量会按百分比计算。

示例：

text
原本 1 元到账 100 商城币
会员充值加成 = 120
实际到账 = 100 * 120 / 100 = 120 商城币

三、支付回调与补单 ​

支付是否到账以服务器后端收到并处理回调为准，不以玩家浏览器页面是否关闭为准。

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

  1. 支付平台是否显示支付成功。
  2. 后台支付订单是否存在。
  3. 订单状态是否已回调成功。
  4. 玩家 SteamID 是否正确。
  5. 是否已经手动补单或重复到账。

后台会员/通行证订单支持补单。补单前建议确认：

  • 订单确实支付成功。
  • 玩家权益未到账。
  • 没有重复补单记录。

补单会按订单类型处理权益：

订单类型补单后处理
商城币充值增加商城币，并应用会员充值加成
建家权限写入管理权限表，等待 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：

text
SteamID[SetGodMode]

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

text
#SetGodMode True

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

十、玩家可能会问 ​

玩家说：支付成功了，页面还显示未到账？ ​

支付页面可能比回调更早返回。让玩家稍等几秒，前端会轮询订单状态并刷新余额。如果仍未到账，管理查后台订单和支付平台记录。

玩家说：我关闭了支付页面，会不会不到账？ ​

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

玩家说：CDK 说已使用？ ​

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

玩家说：充值页没有套餐或没有支付按钮？ ​

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

玩家说：顶部余额和个人中心余额不一样？ ​

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

玩家说：买了建家权限，游戏里没提示？ ​

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

玩家说：建家权限到期为什么没踢出？ ​

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

十一、本章检查清单 ​

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

示例视频预留

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