Stripe iOS SDK 中实现仅添加支付方式的最佳实践

在移动支付场景中，开发者有时需要限制用户只能添加新的支付方式而不能查看或删除已保存的支付方式。这种需求常见于订阅制应用或需要确保支付方式持续有效的业务场景。

核心问题分析

当使用Stripe iOS SDK的CustomerSheet时，默认会显示用户已保存的所有支付方式，并允许用户进行删除操作。这可能导致以下业务风险：

1. 用户意外删除有效支付方式导致自动扣款失败
2. 在延期支付场景中，支付方式被移除可能导致资金损失
3. 用户界面可能显示过多支付方式造成混淆

技术解决方案

通过Stripe的PaymentSheet配合SetupIntent可以实现安全的仅添加支付方式功能：

1. 服务端准备：

   • 创建SetupIntent对象并关联到特定客户
   • 获取SetupIntent的clientSecret用于客户端初始化

2. 客户端配置：

let configuration = PaymentSheet.Configuration()
// 特别注意不设置customer参数
configuration.merchantDisplayName = "Your App Name"

let paymentSheet = PaymentSheet(
    setupIntentClientSecret: setupIntentClientSecret,
    configuration: configuration
)

3. 界面展示：
   • 调用paymentSheet.present()方法显示支付表单
   • 用户只能添加新支付方式，不会显示已有支付方式列表

技术原理

这种实现方式的核心在于：

• SetupIntent专用于设置支付方式而不执行实际扣款
• 不传递customer参数使SDK不查询已有支付方式
• PaymentSheet的默认行为本身就限制了对支付方式的管理操作

注意事项

1. 确保正确处理支付方式添加完成后的回调
2. 对于需要同时支持支付和添加支付方式的场景，需要分别处理PaymentIntent和SetupIntent
3. 在服务端妥善保管SetupIntent的状态变更通知

替代方案比较

曾有开发者尝试通过自定义CustomerAdapter返回空支付方式列表，但这会导致：

• 添加支付方式后显示空白列表的糟糕用户体验
• 不符合SDK的设计预期
• 可能在未来版本中出现兼容性问题

相比之下，使用PaymentSheet+SetupIntent的方案：

• 是官方推荐做法
• 有长期稳定性保障
• 提供最佳用户体验

总结

在需要严格控制支付方式管理的场景下，合理组合Stripe SDK提供的不同组件可以满足各种业务需求。通过SetupIntent和PaymentSheet的配合使用，开发者既能保障支付安全性，又能提供流畅的用户体验。这种方案特别适合订阅服务、定期扣款等需要确保支付方式持续有效的业务场景。