支付设置

支付设置模块让您将 Kuee 与 Stripe 支付平台完整集成，实现刷卡收款、POS 终端管理和自动对账。本指南涵盖四个核心标签页：账户设置、POS 终端、交易记录和高级设置。

进入支付设置

在左侧菜单点击 系统设置 > 基础设置，然后在顶部标签栏选择 Payment Settings（支付设置）。

支付设置分为四个标签页：

账户设置

未连接状态：连接 Stripe 账户

首次使用时，账户设置标签显示 Connect Stripe Account（连接 Stripe 账户） 引导界面：

• Connect Stripe（连接 Stripe） — 点击后跳转至 Stripe 注册/认证流程（Stripe Connect Onboarding）
• 已经设置账号点击 — 如果您已在 Stripe 控制台创建了 Express 账户，点击此链接让系统自动匹配并同步

连接 Stripe 的步骤：

1. 在账户设置标签点击 Connect Stripe
2. 在 Stripe 页面填写业务信息（企业名称、银行账户、身份验证等）
3. 完成所有步骤后点击 提交，Stripe 审核通过后自动返回 Kuee
4. 返回 Kuee 后，账户设置标签将显示绿色的"账户已连接"界面

提示： 如果您已有 Stripe Express 账户，使用「已经设置账号点击」自动同步，无需重新注册。

设置未完成状态

如果您已开始 Stripe Connect 注册但未完成（如中途退出），系统会显示黄色警告提示：

可用操作：

注意： 在设置完成前，无法接受卡支付或使用 Stripe Terminal。

已连接状态

账户成功连接后，页面显示绿色的账户信息卡：

可用操作：

• 打开控制面板 — 生成一次性链接，在新标签页打开您的 Stripe Express 控制台（查看资金流水、提款等）
• 重新连接 — 刷新账户连接状态

POS 终端

POS 终端标签用于管理实体读卡器设备，支持芯片卡、磁条卡和非接触式（NFC）支付。

读卡器列表

添加读卡器

点击右上角 添加读卡器 按钮：

1. 在物理读卡器设备屏幕或 Stripe 控制面板中找到 注册码（Registration Code）
2. 在弹出对话框中填写：
   • 注册码（必填）
   • 读卡器名称（可选，如"前台读卡器"）
3. 点击 添加读卡器 完成注册

提示： 每台物理读卡器有唯一注册码，只需注册一次即可与门店绑定。

从 Stripe 同步

点击 从 Stripe 同步 按钮，系统自动从 Stripe 拉取最新读卡器状态：

• 新增设备 → 添加到列表
• 已移除设备 → 从列表移除
• 状态变更（在线/离线）→ 自动更新

交易记录

交易记录标签显示所有通过 Stripe Terminal 完成的刷卡支付记录。

统计卡片

页面顶部展示所选时间段内的四项关键指标：

查看和筛选

• 日期范围 — 默认显示最近 7 天，点击可选择自定义日期范围
• 搜索 — 在搜索框输入关键词快速查找
• 导出 — 导出交易数据

交易状态说明

说明： 交易记录仅显示通过 Stripe Terminal 读卡器收取的款项，现金和手动记录刷卡的订单请查看订单管理模块。

高级设置

高级设置标签提供读卡器小费配置功能。

小费设置

启用后，顾客在读卡器上完成支付时，设备屏幕会显示小费选项供其选择。

配置步骤：

1. 开启 启用读卡器小费 开关
2. 设置三个预设的小费百分比选项（如 15%、18%、20%）
3. 点击 保存配置

说明：

• 三个百分比选项不能重复，且必须在 1–100 之间
• 除预设选项外，顾客还可以选择"自定义金额"输入任意小费
• 配置保存后将在几分钟内应用到所有已连接的读卡器

最佳实践

Stripe 账户连接：

• 连接前准备好营业执照和银行账户信息，可加快 Stripe 认证速度
• 连接成功后，定期通过"打开控制面板"核对资金状态
• 如更换银行账户，请在 Stripe 控制面板中直接修改

POS 终端管理：

• 为每台设备设置有意义的名称（如"前台 1 号"、"包厢读卡器"）
• 定期点击"从 Stripe 同步"确保设备状态是最新的
• 离线状态的读卡器需检查设备电量和 Wi-Fi 连接

小费设置：

• 参考行业惯例设置合理的小费比例（如 15%/18%/20%）
• 启用前告知员工，以便在顾客询问时能正确说明小费选项