卖卡页面的 Code 字段,当前为单行文本框,用户每次只能输入一个礼品卡码。实际使用中存在两类场景:
不喧宾夺主,需要的人能找到,不需要的人不被干扰。
尼日利亚、加纳、肯尼亚的批量卖卡用户,其 Code 来源主要是:
核心结论:批量 Code 几乎都以纯文本形式存在,用户的自然动作是"复制 → 粘贴",而非逐个手输。因此交互方式以"粘贴自动解析"为主,而非"逐个添加字段"。
| 模式 | 触发 | 界面 |
|---|---|---|
| Single(默认) | 页面打开即为默认 | Code 字段为单行输入框,与当前完全一致 |
| Bulk Input | 用户点击 Code 标签右侧的 "+ Bulk Input" 链接 | 单行框原地切换为多行文本框 + 解析列表 |
Bulk 模式下,"+ Bulk Input" 链接替换为 "Switch to Single",用户可随时切回。切换回 Single 时清空已解析的 Code 列表。
Placeholder:
底部说明:
You can enter again to add more codes.
| 分隔符 | 支持 | 说明 |
|---|---|---|
| 换行(line break) | ✅ | 用户从 WhatsApp / 邮件 / 备忘录粘贴的自然格式 |
| 逗号(comma) | ✅ | 聊天消息中常见的 "code1, code2" 写法 |
| 分号(semicolon) | ✅ | 作为逗号的容错 |
| 空格(space) | ✅ | 多空格分隔的情况 |
解析器自动按换行、逗号、分号、空格拆分,去空行,去除首尾空格。同时智能过滤常见修饰词(如 Code:、$100),精准提取符合卡密规则的字符串。
每个解析出的 Code 独占一行,结构为:[状态图标] Code值 [状态文字] [删除×]
| 状态 | 图标 | 背景色 | 操作 |
|---|---|---|---|
| Valid(格式正确) | ✓ 绿色 | 浅绿 | 可删除 |
| Invalid(格式错误) | ! 红色 | 浅红 | 可删除 |
Maximum 10 codes per order. Additional codes were not added.。删除已有 Code 后,可继续添加新的 Code。支持多次输入或粘贴。每次输入后,解析出的 Code 追加到已有列表,文本框自动清空并重新聚焦,用户可继续输入下一批。跨次去重,已存在的有效码不会重复计入。
列表下方展示统计信息:
N valid — 有效码数量(绿色)N invalid — 无效码数量(红色,仅有时展示)超过 10 个上限时,在统计下方追加提示:Maximum 10 codes per order. Additional codes were not added.
Please remove or fix the invalid code first底部 Estimated Payout 按 Valid Code 数量 × 单卡金额 实时计算。用户删除无效码后,金额自动更新。
| 场景 | 处理 |
|---|---|
| 切回 Single 模式 | 清空已解析的 Code 列表和文本框,恢复单卡输入状态 |
| 文本框为空 | 不触发解析,已解析的 Code 保持不变 |
| 同一个 Code 多次粘贴 | 静默去重,不重复计入,不提示去重数量 |
| Code 超过 10 个 | 前 10 个添加到列表,超出部分忽略,提示 Maximum 10 codes per order. Additional codes were not added. |
| 删除 Code 后低于 10 个 | 上限提示消失,用户可继续添加新的 Code |
| 混合有效和无效 Code | 分别展示,无效码不阻断有效码的提交(删除无效码后即可提交) |
| 物理卡用户 | Type 选 Physical 走现有图片上传流程,不涉及此方案 |