Sell Card — Bulk Code Input

礼品卡回收 · 卖卡页面多 Code 输入 · 2026.09

一、设计思路

1. 场景分析

卖卡页面的 Code 字段,当前为单行文本框,用户每次只能输入一个礼品卡码。实际使用中存在两类场景:

2. 设计原则

不喧宾夺主,需要的人能找到,不需要的人不被干扰。

3. 用户行为调研结论

尼日利亚、加纳、肯尼亚的批量卖卡用户,其 Code 来源主要是:

核心结论:批量 Code 几乎都以纯文本形式存在,用户的自然动作是"复制 → 粘贴",而非逐个手输。因此交互方式以"粘贴自动解析"为主,而非"逐个添加字段"。

二、功能描述

1. 模式切换

模式触发界面
Single(默认)页面打开即为默认Code 字段为单行输入框,与当前完全一致
Bulk Input用户点击 Code 标签右侧的 "+ Bulk Input" 链接单行框原地切换为多行文本框 + 解析列表

Bulk 模式下,"+ Bulk Input" 链接替换为 "Switch to Single",用户可随时切回。切换回 Single 时清空已解析的 Code 列表。

2. Bulk 模式交互流程

默认 Single 模式 Code: [单行输入框] [+ Bulk Input] ↓ 点击 + Bulk Input Bulk 模式 [多行文本框 — 粘贴/输入 Code] ↓ 输入后自动解析 [Code 列表 — 一行一个,带校验状态] [Summary: N valid · M invalid] ↓ 有无效码 Sell 按钮灰色 → 点击提示 "Please remove or fix the invalid code first" ↓ 删除无效码后 Sell 按钮恢复蓝色 → 可提交

3. 文本框

Placeholder:

Enter or paste multiple codes. Separate codes with spaces, commas, or line breaks. e.g. 25665432101234Z 98765432101234Z

底部说明:

You can enter again to add more codes.

4. 解析逻辑

分隔符支持说明
换行(line break)✅用户从 WhatsApp / 邮件 / 备忘录粘贴的自然格式
逗号(comma)✅聊天消息中常见的 "code1, code2" 写法
分号(semicolon)✅作为逗号的容错
空格(space)✅多空格分隔的情况

解析器自动按换行、逗号、分号、空格拆分,去空行,去除首尾空格。同时智能过滤常见修饰词(如 Code:、$100),精准提取符合卡密规则的字符串。

5. Code 列表展示

每个解析出的 Code 独占一行,结构为:[状态图标] Code值 [状态文字] [删除×]

状态图标背景色操作
Valid(格式正确)✓ 绿色浅绿可删除
Invalid(格式错误)! 红色浅红可删除

6. 多次输入/粘贴

支持多次输入或粘贴。每次输入后,解析出的 Code 追加到已有列表,文本框自动清空并重新聚焦,用户可继续输入下一批。跨次去重,已存在的有效码不会重复计入。

7. Summary 统计

列表下方展示统计信息:

超过 10 个上限时,在统计下方追加提示:Maximum 10 codes per order. Additional codes were not added.

8. 提交拦截

9. Estimated Payout 联动

底部 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 走现有图片上传流程,不涉及此方案