语言 / LanguagePRD v1.18

提款账户限定注册手机号 · PRD

作者 Luke 版本 v1.18 日期 2026-09-11 状态 待评审 平台 BRAND_A & BRAND_B 类 S

版本记录
版本 日期 变更摘要
v1.18 2026-09-11 §3~§8 修正需求边界:删除误放入本需求的运营重置、双人复核、文案、权限与验收;确认 Binding successful 为共用文案,系统没有邮箱绑定,不再列为 Open Point;同步原型与资讯图表。
v1.17 2026-09-10 §3.5 运营重置改为复用现有解绑/修改账户资料的双人复核:申请人提交单一钱包与必填备注,另一名管理员复核通过后才回到未设置;不新建审核系统或权限点。§4 删除用户换手机号情境,因为目前注册手机号不可修改。同步原型与资讯图表。
v1.16 2026-09-10 §3.5 新增运营重置单一提款账户;§6.3、§7 补逐字文案、权限与日志;重置后回到未设置,历史与在途提款不变。同步原型与资讯图表。
v1.15 2026-09-10 二次精简 §1~§5:合并配置、生效与异常重复说明;附录 A 由 34 条收敛为 26 条场景式验收,保留配置优先级、校验顺序与全部逐字文案。
v1.14 2026-09-10 Codex 候选精简版:合并 §1~§7 重复说明;保留既有 31 个验收点;新增 11 位规范化比较、绑定/提款固定校验顺序、重复代理最后一个有效条目覆盖三项规则;关闭原 OP-2;目录、版本记录与附录分别折叠;重绘资讯图表。
v1.13 2026-09-09 在 §L0、§6 补原型视觉清单与不做边界锚点;修正引用并拆出英文文案栏。
v1.12 2026-09-02 在 §6 补银行卡账号格式软性提醒及双按钮行为;银行卡仍不在本需求范围。
v1.11 2026-09-02 在 §6 补打码量未达标与无可用渠道两条既有页内文案。
v1.10 2026-08-31 在 §6 将验证码错误定为线上文案并收进通用文案库;Binding successful 是否共用仍待确认。
v1.9 2026-08-31 在 §6 将验证码发送成功改为通用文案,并补中文对照。
v1.8 2026-08-31 补 §6 文案图例;修正配置项范围描述与验收排序。
v1.7 2026-08-31 §6 五条既有模块文案改标为逐字复用。
v1.6 2026-08-31 L0 资讯图改为上传网址并记录本地图指纹;规格不变。
v1.5 2026-08-31 §6 补提款成功弹窗及 Confirm 后留在本页的行为。
v1.4 2026-08-31 在 §1 将三个既有钱包绑定数量配置移入 提款账户限制 分类,只换分类,不改值或逻辑。
v1.3 2026-08-31 在 §3、§6 核定四条既有提示语并补验证码判断。
v1.2 2026-08-31 在 §3 补 Fund Accounts 绑定流程、返回入口、重复账户与绑定笔数上限。
v1.1 2026-08-31 在 §1、§3 明确绑定只有 Fund Accounts 一处,并补 OTP 流程与配置标题规则。
v1.0 2026-08-31 初版:新增四个配置项、三层取值顺序、绑定/提款两侧行为、生效与存量、AC1–AC29。
目录

L0 · 快速掌握

提款账户注册手机号校验架构资讯图表

① 一句话需求

把电子钱包的注册手机号校验改为按品牌、按代理线配置,并在绑定与提款时按固定顺序执行。

② 术语写死表

词 唯一含义
绑定侧 在 Fund Accounts 提交钱包绑定时执行的校验。
提款侧 在建立提款单之前执行的校验。
配置值 总开关 0 关闭、1 开启;例外名单 1 关闭、2 开启。有效名单值优先。
注册手机号 校验当下会员档案的手机号,经既有规则规范为 11 位纯数字。
结论 依名单与总开关得到的“开启”或“关闭”,不是配置数字。

③ 全局红线表

不变量 违反后果 验证锚点
G1 总开关与名单的 1 含义相反 整条代理线的校验方向颠倒 AC1 AC2 AC3
G2 有效名单优先;没有才读总开关 例外配置失效 AC4 AC5
G3 配置取不到或无效时按关闭 读取异常造成全站无法提款 AC6 AC7
G4 坏组只忽略该组;重复代理最后一个有效条目覆盖 一处错误破坏整串配置,或多节点结果不确定 AC8 AC9 AC23
G5 名单只作用于指定代理,不含上下级 总代树被误放行或误拦截 AC10
G6 每次提交实时取配置、代理与当前注册手机号 配置变更后仍沿用旧结论 AC11 AC14
G7 两条入口最终都走 Fund Accounts 的同一绑定提交校验 Account 直入路径可绕过 AC12
G8 提款被拦时不建立任何提款单 审核端出现无法处理的废单 AC13
G9 手机号先规范为同一 11 位格式再精确比较 显示格式差异造成误拦或误放 AC25
G10 绑定先校验 OTP,再校验重复与数量,最后校验注册手机号 错误提示顺序不稳定,或可绕过注册手机号校验 AC26

④ 适用范围与「不做」边界

本次只管 GCash、Maya、GrabPay 的绑定、提款账户比对及相关后台配置。不管银行卡、提款渠道、解绑/重置、玩家级白名单或既有风控规则。阅读者为客户端前端、账户后端、提款后端、运营配置、合规与测试。


1. 配置项

1.1 分类与新增配置

1.1.1 位置:网站管理 ▸ 基本配置 ▸ 提款账户限制(Withdrawal Account Restriction)。该一级目录与 运营参数 并列,新增四项:

侧 用途 系统名称 中文标题 默认值
绑定 总开关 withdraw_account_bind_reg_phone_switch 绑定提款账户校验注册手机号 0
绑定 例外名单 withdraw_account_bind_reg_phone_agent 绑定校验代理线例外 空
提款 总开关 withdraw_apply_reg_phone_switch 发起提款校验注册手机号 0
提款 例外名单 withdraw_apply_reg_phone_agent 提款校验代理线例外 空

1.1.2 两侧独立。开发若调整系统名称,两个总开关仍以 _switch 结尾,四项使用相同前缀。

1.2 两套值域

结论 总开关 例外名单
关闭校验 0 1
开启校验 1 2

1.2.1 沟通与逻辑统一使用“开启/关闭”,不得脱离配置类型只说数字。

1.3 例外名单

1.3.1 格式沿用 KYC 触发节点配置:代理:值,代理:值。

项目 规则
键 代理,不是总代;只作用于该代理,不含上下级。
值 1 关闭、2 开启;其他值无效。
解析 逐组解析;坏组忽略并写系统运行日志,后续组继续。
重复代理 最后一个有效条目生效;无效条目不覆盖。每次重复都写运行日志。
上限 不设条数上限。

1.3.2 运行日志记录无效/重复条目原文与组序,不记录玩家资料。

1.4 既有配置移入分类

1.4.1 gcash_binding_amount、maya_binding_amount、grabpay_binding_amount 移入 提款账户限制。只换分类;标题、系统名称、默认值、现值、品牌继承及前台判定全部不变。


2. 取值顺序

绑定与提款各自使用对应配置,每次提交实时计算:

  1. 解析该侧例外名单;若会员所属代理有最后一个有效条目,1 得出关闭、2 得出开启,并停止。
  2. 没有有效条目时读该侧总开关;0 关闭、1 开启。
  3. 总开关为空、读取失败或为其他值时,结论为关闭,并按 §5 留运行日志。

玩家所属代理取不到时视为不在名单,继续读总开关。配置按品牌隔离,不跨 BRAND。


3. 绑定与提款

3.1 手机号规范化与比较

3.1.1 两边沿用既有规则规范为 11 位纯数字后精确比较,不比较显示格式,也不新增国家码转换。注册手机号取提交当下会员档案,不存历史;任一侧无法规范时,在校验开启状态下判不相等。

3.2 绑定侧

3.2.1 两个入口最终进入同一个流程:Account 或提款页 → SMS verification → Fund Accounts → 钱包分页签 → + Add → 绑定弹窗 → Confirm。

3.2.2 后端在最终提交时按以下顺序校验;首个失败即停止,只显示对应的既有/本需求文案:

  1. 必填与钱包账号既有格式。
  2. OTP 是否正确。
  3. 同钱包类型是否重复账户。
  4. 该钱包类型绑定数量是否已满。
  5. 实时计算绑定侧结论;若开启,比对规范化后的钱包手机号与注册手机号。
  6. 全部通过后才写入绑定。

3.2.3 绑定侧关闭时跳过第 5 步,其余既有校验仍执行。第 5 步不符时停留绑定页、不落绑定,并显示 §6 指定 Toast。绑定页须保留返回 Fund Accounts 的既有入口。

3.3 提款侧

3.3.1 提款页先执行既有提款条件与表单校验,包含打码量、可用渠道、金额与渠道限制。通过后:

  1. 实时计算提款侧结论。
  2. 若开启,比对所选电子钱包账户与当下注册手机号。
  3. 比对通过或结论关闭,才建立提款单并进入既有流程。

3.3.2 不符时发起失败、停留提款页,不建立提款单、账变或提现风控审核记录,并显示 §6 指定 Toast。放行后的成功弹窗按 Confirm 只关闭弹窗,仍留在提款页。

3.4 作用范围

对象 是否适用
GCash/Maya/GrabPay 新增或修改绑定 绑定侧
已绑定的三种电子钱包发起提款 提款侧
已删除绑定 不适用
银行卡绑定与提款 不适用

3.4.1 三种电子钱包行为一致。提款渠道分配、单笔限额、解绑双人复核及每种钱包的绑定数量上限均不改;后台 绑定信息 > AccountNo 与 绑定信息 > WalletAddress 的栏位、页签及操作也不改。


4. 生效与存量

配置保存后,下一次提交立即使用新值;在途提款单不重判。开启后既有不匹配钱包不能提款,但不自动解绑;关闭后下一次提交跳过比较。绑定已满且无匹配钱包时走既有客服流程。


5. 异常与降级

异常 处理
名单坏组/无效值 忽略并记日志;没有其他有效条目则读总开关。
同代理重复 最后一个有效条目生效并记组序。
总开关为空/读取失败/无效 当关闭并记日志。
代理取不到 当不在名单,读总开关。
注册手机号缺失/不合法 开启时判不相等。

配置编辑沿用管理员操作日志,记录操作人、时间、配置对象及改动前后值。异常不新增玩家端文案。


6. 用户可感知文案

实现与原型必须逐字采用下表英文;同一提交有多个错误时,只显示 §3 顺序中第一个失败项。

6.1 本需求使用的两条通用文案

场景 中文对照 英文上线文案 呈现与结果
绑定号码不符 ↪ 手机号不符,请输入您的注册手机号 Phone number mismatch. Please enter your registered phone number. Toast;停留绑定页,不落绑定。
提款账户不符 ↪ 仅注册手机号可用于提款 Only your registered phone number is eligible for withdrawals. Toast;停留提款页,不建立提款单。

6.2 原型会出现的既有文案

场景 中文对照 英文上线文案 呈现
OTP 发送成功 ↪ 验证码发送成功 Verification code sent successfully Toast+Send 倒数。
OTP 错误 ↪ 验证码错误 Verification code invalid Toast。
同钱包重复账户 — This withdrawal account has been used Toast。
绑定成功 — Binding successful Toast。
提款成功 — Withdrawal processed. Funds are typically credited within minutes. Withdraw 弹窗;Confirm 只关弹窗。
打码量未达标 — Please finish the required turnover before applying withdraw. Withdrawable amount 下方常驻;Confirm 不可按。
无可用提款渠道 — No gateway available now, please contact customer service... 同上;三个点是原文。
银行账号格式提醒 — Your {BankName} account number looks unusual. Kindly review it again to ensure smooth and secure transactions on our platform. Reminder 弹窗;Confirm Again 返回修改,Confirmed 仍可绑定。

6.2.1 银行卡提醒仅为原型既有流程证据,不表示本需求开始管银行卡。


7. 权限与留痕

基本配置继续沿用既有菜单权限。配置编辑记录操作人、时间及改动前后值;名单解析异常与重复条目写系统运行日志。日志不得记录 OTP 或完整钱包账号。


8. 待确认项

# 问题 决策者 时点
OP-1 四个配置系统名称上线后回填;须保留 _switch 后缀与共同前缀规则。 开发 上线前
OP-3 基本配置列表空态的线上逐字文案;不挡开发,原型不编。 运营/补截图 原型定稿前

原 OP-2 已关闭:同一代理重复时,最后一个有效条目覆盖;无效条目不覆盖,并写运行日志。原 OP-5 已关闭:Binding successful 为共用文案;系统没有邮箱绑定。


附录 A:验收标准
# P 验收点
AC1 P0 名单 代理A:1、总开关 1:代理 A 关闭,其余开启(G1)。
AC2 P0 名单 代理A:2、总开关 0:代理 A 开启,其余关闭(G1)。
AC3 P0 名单空时,总开关 0 关闭、1 开启(G1)。
AC4 P0 代理有有效名单值时,名单覆盖总开关(G2)。
AC5 P0 代理不在名单时读取总开关(G2)。
AC6 P0 总开关清空且名单无有效值时关闭(G3)。
AC7 P0 总开关为 9 时关闭并写运行日志(G3)。
AC8 P0 代理A:1,代理B,代理C:2:坏组 B 不阻断 C,B 读总开关(G4)。
AC9 P0 AC8 的坏组日志含原文与组序(G4)。
AC10 P0 名单只作用于指定代理,上下级均不继承(G5)。
AC11 P0 改配置后,下一次提交立即使用新值;不需重登(G6)。
AC12 P0 从 Account 或提款页进入 Fund Accounts,号码不符都由同一后端校验拦截(G7)。
AC13 P0 提款账户不符时,不建立提款单、账变或风控记录(G8)。
AC14 P0 注册手机号取会员档案当前唯一值;本需求不新增换号或历史手机号逻辑(G6)。
AC15 P1 绑定侧开启且号码相符时正常绑定。
AC16 P1 提款侧开启且账户相符时进入既有流程。
AC17 P1 结论关闭时不比较手机号,也不显示不符提示。
AC18 P1 无注册手机号且结论开启时拦截并显示该侧不符提示。
AC19 P1 银行卡不受影响;已删除的钱包不参与判断。
AC20 P1 GCash/Maya/GrabPay 规则一致,绑定数量仍分别计算。
AC21 P1 提款渠道分配与单笔限额不变。
AC22 P1 BRAND_A 配置不影响 BRAND_B。
AC23 P0 代理A:1,代理A:2 取 2;代理A:1,代理A:坏值 保留 1;两者都记重复日志(G4)。
AC24 P1 三个绑定数量配置移分类后,值、默认值、品牌继承与判定不变。
AC25 P0 两个号码格式不同但规范后同为相同 11 位数字时相等;否则不等(G9)。
AC26 P0 OTP 错误与号码不符同时存在时,只显示 Verification code invalid;OTP 正确后才检查手机号(G10)。
附录 B:配置决策表
总开关 最后一个有效名单值 结论
0 无 关闭
0 2 开启
1 无 开启
1 1 关闭
附录 C:原型视觉清单(默认折叠)

原型视觉清单

视觉 ID 载体 用途 证据
VIS-BO-NONE BO 后台配置页面不使用图片或图片占位。 BO 原型、§1
VIS-CLIENT-NONE Client 客户端流程不使用内容图片或图片占位。 Client 原型、L0 ④

清单只约束内容图片与图片占位;Client 下拉框内嵌箭头属于控制元件装饰。


文档版本:v1.18 | 日期: 2026-09-11 | 作者: Luke | 文档状态:待评审