跳到主要内容

支付方式管理

OmniCRM 的支付方式系统允许客户和员工安全地管理支付卡，使用 多供应商支付处理（Stripe、PayPal 等）。支付方式支持自动计费服务、一次性付款和定期收费，而无需在 OmniCRM 中存储敏感的卡数据。

另请参见： Payment System Guide <payment_system_guide>， Billing Overview <billing_overview>， Payment Processing <payments_process>， Invoices <payments_invoices>。

概述​

支付方式系统提供：

  • 安全卡存储 - 由支付供应商（Stripe、PayPal）进行令牌化的卡片，永远不存储在 OmniCRM 中
  • 多供应商支持 - 支持 Stripe 和 PayPal 支付方式
  • 多张卡片 - 客户可以存储多种支付方式
  • 默认选择 - 指定首选支付方式以进行自动收费
  • 到期跟踪 - 监控和更新即将到期的卡片
  • 自助服务 - 客户可以通过 Self-Care Portal <self_care_portal> 管理自己的卡片
  • 员工管理 - 支持员工可以代表客户添加/删除卡片

支持的支付方式：

  • 卡片（通过 Stripe 或 PayPal）
    • ���用卡（Visa、Mastercard、American Express、Discover）
    • 借记卡
    • 预付卡（如果卡网络支持）
  • PayPal 账户（通过 PayPal 集成）

不存储在 OmniCRM 中：

卡片详细信息由支付供应商进行令牌化并安全存储。OmniCRM 仅存储：

  • 支付供应商（stripe、paypal）
  • 卡品牌（Visa、Mastercard 等）
  • 后四位数字
  • 到期月份/年份
  • 持卡人姓名/昵称
  • 供应商特定的支付方式令牌

访问支付方式​

从客户页面：

  1. 导航到 Customers → [选择客户]
  2. 点击 Billing 标签
  3. 滚动到 Payment Methods 部分

或者直接：

从即将到期的卡片仪表板：

查看所有即将到期的卡片客户：

这显示了系统范围内在接下来的 60 天内到期的卡片列表。

支付方式列表​

支付方式表显示客户的所有存储卡片：

Payment Methods List

列描述：

  • 昵称 - 卡片的友好名称（例如，“个人卡”，“工作 Visa”）
  • 发行人 - 卡品牌和后四位数字
  • 到期 - 到期月份/年份（MM/YYYY 格式）
  • 添加 - 卡片添加到账户的日期
  • 默认 - 勾选标记表示自动收费的默认支付方式

每张卡的操作：

每行��有一个操作菜单（⋮），选项包括：

  • 设为默认 - 将此卡片设为默认支付方式
  • 删除 - 从账户中移除卡片

添加支付方式​

点击 "Add Payment Method" 打开安全支付模态框。

第一步：输入卡片详细信息​

安全支付表单出现（由 Stripe Elements 或 PayPal SDK 提供支持）：

Add Payment Method Modal

必填字段：

  • 卡片信息 - 卡号、到期、CVC（由 Stripe 验证）
  • 持卡人姓名 - 卡上的姓名
  • 国家/地区 - 账单国家

可选字段：

  • 卡片昵称 - 友好的标签以区分卡片

安全性：

  • 卡片详细信息直接输入到供应商托管的安全 iframe（Stripe Elements / PayPal SDK）
  • OmniCRM 从未看到或存储完整的卡号
  • PCI DSS 合规性由支付供应商处理
  • 实时验证防止无效卡号

第二步：提交并令牌化​

当您点击 "Add Payment Method" 时：

  1. 客户端验证：
    • 支付供应商验证卡号格式
    • 检查到期日期是否在未来
    • 验证 CVC 格式
  2. 令牌化：
    • 卡片详细信息直接发送到支付供应商（而不是 OmniCRM）
    • 供应商创建一个安全令牌（例如，pm_1A2B3C4D 用于 Stripe）
    • 令牌返回给 OmniCRM
  3. 服务器处理：
    • OmniCRM 将令牌保存到客户记录中，并附上供应商标识符
    • 存储后四位数字、品牌、到期和供应商名称以供显示
    • 完整的卡号从未接触 OmniCRM 服务器

第三步：确认​

成功消息出现：

您的 Visa 卡（尾号 1234）已添加到您的账户中。

新卡片出现在支付方式表中。

自动默认选择：

  • 如果这是客户的第一张卡，它会自动设为默认
  • 如果客户已经有卡，新卡将作为非默认卡添加
  • 客户可以在添加后更改默认设置

设置默认支付方式​

默认支付方式用于：

  • 自动定期服务收费
  • 发票付款
  • 充值和补充
  • 一次性交易（除非另有说明）

更改默认设置：

  1. 在支付方式表中找到您想要设为默认的卡片

  2. 点击卡片旁边的 操作菜单（⋮）

  3. 选择 "Set as Default"

  4. 确认信息出现

    Visa 尾号 5678 现在是您的默认支付方式。

勾选标记移动到新选择的卡片。

视觉指示：

默认卡片显示：

在默认列中，通常带有绿色勾选标记徽章。

删除支付方式​

移除过期、丢失或不再需要的卡片。

第一步：启动删除​

  1. 在支付方式表中找到要删除的卡片
  2. 点击 操作菜单（⋮）
  3. 选择 "Delete"

第二步：确认删除​

确认模态框出现：

您确定要删除此支付方式吗？

卡片：Visa 尾号 1234 到期：12/2026

⚠️ 警告：如果这是您唯一的支付方式，您需要添加新的支付方式才能继续使用需要自动计费的服务。

[取消] [删除支付方式]

点击 "Delete Payment Method" 以确认。

第三步：删除完成​

成功消息：

卡片已从表中移除，并从支付供应商处删除。

重要限制：

  • 如果存在其他卡片，则无法删除默认卡 - 首先将其他卡片设为默认
  • 删除最后一张卡时的警告 - 需要付款的服务可能会被暂停
  • 无法撤销 - 删除是永久的；客户如果需要必须重新添加卡片

管理即将到期的卡片​

OmniCRM 跟踪卡片到期日期，并提供工具以主动更新即将到期的卡片。

即将到期的卡片仪表板​

导航到 Billing → Expiring Cards 以查看系统范围内的列表：

客户 卡片 到期 距离操作天数 John Smith Visa **1234 02/2025 12 天 更新 Acme Corp MC5678 03/2025 45 天 更新 Jane Doe Amex**9012 01/2025 已过期 更新

Expiring Cards Dashboard

��滤器：

  • 到期范围 - 接下来的 30/60/90 天或已过期
  • 客户类型 - 个人与企业
  • 服务类型 - 按需付款方式过滤服务

操作：

  • 更新 - 打开客户的支付方式页面以添加新卡
  • 通知 - 向客户发送电子邮件提醒（如果已配置 Mailjet）

到期通知​

如果已配置 Mailjet，将自动发送电子邮件：

  • 到期前 60 天 - 第一次提醒
  • 到期前 30 天 - 第二次提醒
  • 到期前 7 天 - 最后警告
  • 到期时 - 卡片已过期通知

客户可以点击电子邮件中的链接，通过自助服务门户更新他们的支付方式。

电子邮件模板变量：

Mailjet 模板接收：

  • 客户姓名
  • 卡品牌和后四位数字
  • 到期日期
  • 自助服务支付方式页面的链接

请参见 integrations_mailjet 以获取电子邮件模板配置。

更新即将到期的卡片​

推荐工作流程：

  1. 客户收到到期通知电子邮件
  2. 客户登录自助服务门户
  3. 导航到 Billing → Payment Methods
  4. 点击 "Add Payment Method"
  5. 输入新卡片详细信息（同一张卡的更新到期，或替换卡片）
  6. 将新卡片设为默认
  7. 删除旧的/过期的卡片

员工工作流程：

如果客户拨打支持电话：

  1. 员工打开客户账户
  2. 导航到 Billing → Payment Methods
  3. 代表客户添加新卡（客户通过电话提供详细信息）
  4. 将新卡片设为默认
  5. 删除过期的卡片
  6. 与客户确认

警告

切勿要求客户通过电子邮件或短信发送卡片详细信息。始终使用：

  • 安全的自助服务门户进行自助服务
  • 电话上由员工直接输入详细信息到系统
  • 在零售地点亲自处理

卡片到期时会发生什么​

当支付卡达到到期日期且未更新时：

立即影响：

  1. 自动支付失败
    • 支付供应商拒绝使用过期卡的交易
    • 月度服务续订未能处理
    • 自动充值失败
    • 发票自动付款失败
  2. 客户通知
    • 系统尝试收费卡片
    • 发送支付失败通知
    • 发送“更新支付方式”电子邮件，附有自助服务门户的链接
  3. 服务状态变化
    • 后付费服务 - 可能在欠款的情况下暂时继续
    • 预付费服务 - 当余额耗尽时服务暂停
    • 自动续订服务 - 续订失败，服务可能到期

后续操作：

第 1-3 天（宽限期）：

  • 服务正常继续
  • 客户收到第一次支付失败通知
  • 系统尝试重试（根据配置）

第 4-7 天：

  • 第二次支付尝试（如果配置）
  • 发送警告电子邮件
  • 客户服务可能联系客户

第 8-14 天：

  • 服务可能因未付款而暂停
  • 暂停状态阻止使用但保留账户
  • 客户可以通过更新支付方式和支付欠款来恢复

第 15 天及以后：

  • 服务可能因未付款而终止
  • 库存（SIM 卡、设备）标记为退回
  • 发送最终通知
  • 账户转交催收（如适用）

防止服务中断：

为避免服务中断：

  • 在到期前 30 天 更新卡片
  • 添加多种支付方式以提高冗余性
  • 启用支付失败警报
  • 每周监控即将到期的卡片仪表板

到期后恢复服务：

如果因过期卡片暂停服务：

  1. 添加新的有效支付方式
  2. 设为默认
  3. 支付欠款（如有）
  4. 联系支持以重新激活服务
  5. 服务在几分钟到几小时内恢复

支付方式安全​

令牌化​

OmniCRM 使用供应商令牌化确保安全：

  1. 客户输入卡片 → 直接发送到支付供应商服务器
  2. 供应商验证并令牌化 → 创建唯一令牌
  3. 令牌存储在 OmniCRM → 从不存储完整卡号
  4. 支付处理 → 令牌发送给供应商，供应商收费卡片

OmniCRM 存储的内容：

{
  "vendor": "stripe",
  "vendor_payment_method_id": "pm_1A2B3C4D5E6F",
  "payment_type": "card",
  "brand": "visa",
  "last4": "1234",
  "exp_month": 12,
  "exp_year": 2026,
  "name": "John Smith",
  "nickname": "Personal Card",
  "is_default": true
}

OmniCRM 不存储的内容：

  • 完整的卡号
  • CVV/CVC 代码
  • 磁条数据
  • PIN 号码

PCI 合规性​

通过使用供应商托管的支付表单：

  • 减少 PCI 范围 - 卡数据从未接触 OmniCRM 服务器
  • 供应商托管字段 - 卡片输入发生在供应商的安全 iframe 中
  • 无卡存储 - 使用令牌代替原始卡数据
  • 安全传输 - 所有通信通过 HTTPS/TLS

请参见 Payment System Guide <payment_system_guide> 以获取支付供应商安全详细信息。

常见工作流程​

工作流程 1：客户添加第一张支付方式​

场景： 新客户注册服务

  1. 客户创建账户
  2. 选择服务计划
  3. 在结账时提示添加支付方式
  4. 在 Stripe 模态框中输入卡片详细信息
  5. 卡片令牌化并保存
  6. 自动设为默认
  7. 服务提供
  8. 第一次收费处理

工作流程 2：客户更新即将到期的卡片​

场景： 信用卡即将到期

  1. 客户收到电子邮件通知（到期前 60 天）
  2. 登录自助服务门户
  3. 导航到 Billing → Payment Methods
  4. 查看当前卡片到期 12/2025
  5. 点击 "Add Payment Method"
  6. 输入到期 12/2028 的替换卡
  7. 将新卡设为默认
  8. 删除旧卡
  9. 发送确认电子邮件

工作流程 3：员工通过电话帮助客户​

场景： 客户拨打电话：“我的卡被拒绝”

  1. 客户拨打支持电话
  2. 员工验证身份（安全问题）
  3. 员工检查支付方式：卡片到期 01/2025
  4. 员工：“您的卡片已过期。您有新卡吗？”
  5. 客户通过电话提供新卡详细信息
  6. 员工导航到 Customers → [Customer] → Billing
  7. 点击 "Add Payment Method"
  8. 输入客户朗读的卡片详细信息
  9. 将新卡设为默认
  10. 删除过期的卡片
  11. 重试失败的支付
  12. 与客户确认：“支付成功，服务恢复”

工作流程 4：拥有多张卡的企业客户​

场景： 公司希望为不同目的使用不同的卡片

  1. 企业客户添加主卡（Visa 尾号 1111）
  2. 将其设为每月服务收费的默认卡
  3. 添加备用卡（Mastercard 尾号 2222）用于充值
  4. 添加采购卡（Amex 尾号 3333）用于设备采购
  5. 在进行充值时，在结账时手动选择 Mastercard
  6. 默认的 Visa 仍用于自动每月计费

工作流程 5：管理即将到期的卡片（管理员）​

场景： 主动到期管理

  1. 管理员导航到 Billing → Expiring Cards
  2. 过滤器：“接下来的 30 天”
  3. 看到 15 个客户的卡片即将到期
  4. 选择所有 → "Send Reminder Emails"
  5. Mailjet 向每个客户发送个性化电子邮件
  6. 客户通过自助服务更新卡片
  7. 管理员一周后查看列表
  8. 联系尚未更新的剩余客户
  9. 通过电话协助更新卡片

故障排除​

“添加支付方式时卡被拒绝”

  • 原因： 支付供应商拒绝了卡片（资金不足、欺诈预防、发行人拒绝）
  • 解决方案：
    • 尝试不同的卡片
    • 联系卡片发行人以授权交易
    • 确保卡片支持在线购买
    • 检查账单地址是否与档案中的卡片匹配

“添加支付方式时出错”（通用错误）

  • 原因： 支付供应商 API 错误或网络问题
  • 解决方案：
    • 刷新页面并重试
    • 检查互联网连接
    • 验证系统设置中的支付供应商配置是否正确
    • 检查浏览器控制台以获取具体错误信息
    • 尝试不同的浏览器（禁用广告拦截器）

无法删除支付方式（按钮禁用）

  • 原因： 尝试删除默认卡，或者这是唯一的卡
  • 解决方案：
    • 首先将其他卡设为默认
    • 如果这是唯一的卡，先添加新卡再删除

卡片显示已过期，但不在“即将到期的卡片”列表中

  • 原因： 卡片最近过期，缓存未刷新
  • 解决方案：
    • 刷新页面
    • 检查即将到期的卡片仪表板上的过滤器
    • 过期的卡片可能会移动到不同的视图

新卡未立即出现

  • 原因： 添加卡片后页面未刷新
  • 解决方案：
    • 支付方式表应自动刷新
    • 如果没有，手动刷新浏览器
    • 检查添加过程是否发生错误

支付模态框无法加载

  • 原因： 支付供应商 SDK 未加载、API 密钥问题或浏览器扩展阻止
  • 解决方案：
    • 检查浏览器控制台中的错误
    • 禁用广告拦截器和跟踪保护
    • 验证系统设置中的支付供应商配置
    • 确保供应商 SDK 脚本加载（检查网络标签）
    • 尝试隐身/私密浏览模式

客户未收到到期通知

  • 原因： Mailjet 未配置或电子邮件模板缺失
  • 解决方案：
    • 验证 crm_config.yaml 中的 Mailjet 凭据
    • 检查是否存在卡片到期的电子邮件模板
    • 确认客户电子邮件地址有效
    • 检查 Mailjet 日志以获取投递失败信息

最佳实践​

对于客户：

  • 在服务激活之前添加支付方式以避免延误
  • 保持至少 2 张卡片以提高冗余性
  • 在到期前 30 天以上更新即将到期的卡片
  • 删除旧的/过期的卡片以避免混淆
  • 使用描述性昵称（“个人 Visa”，“工作 Amex”）
  • 验证默认支付方式是否正确以进行自动计费

对于支持员工：

  • 在访问支付方式之前验证客户身份
  • 切勿要求客户通过电子邮件/SMS/聊天发送卡片详细信息
  • 在通话期间立即处理卡片添加（不要延迟）
  • 确认添加后新卡设为默认
  • 仅在确认新卡有效后删除旧卡
  • 更新过期卡片后测试支付（处理 £0.01 授权）

对于管理员：

  • 每周监控即将到期的卡片仪表板
  • 在到期前 60/30/7 天发送提醒电子邮件
  • 保持支付供应商的测试/实时密钥分开用于开发与生产
  • 确保配置 Mailjet 模板以进行到期通知
  • 审查失败的支付报告以识别过期卡片
  • 培训员工有关安全卡片处理程序

相关文档​

  • Payment System Guide <payment_system_guide> - 完整的支付 API 参考和架构
  • payments_process - 使用存储支付方式处理支付
  • payments_invoices - 使用默认卡进行自动发票付款
  • features_topup_recharge - 使用支付方式的充值系统
  • basics_payment - 一般支付和计费概念
  • customer_care - 自助服务门户，供客户管理自己的卡片

Payment Methods Management Interface