📦 Stripe Best Practices — 斗牌支付集成最佳实践

提供 Stripe 支付集成的最佳实践指南，涵盖订阅、计费和 Connect 的集成建议和限制。## 关键词 stripe, 支付, 结账, 订阅, 计费

意图

• 集成支付处理
• 处理订阅
• 处理信用卡

约束

永不

• Charges API
• Sources API
• Card Element
• Payment Element (仅卡模式)
• Tokens API (除非特定需求)
• 混合 Connect 收费类型
• 遗留 Connect 条款 (标准/表达/自定义)

始终

• 最新 API/SDK 版本 (除非指定否则)
• 建议 PCI 合规证明用于处理原始 PAN
• 使用控制器属性进行 Connect (而非遗留条款)

偏好

• CheckoutSessions 优先于 PaymentIntents (会话支付)
• Stripe 主机 Checkout 优先于嵌入式 Checkout (默认选择)
• 嵌入式 Checkout 优先于 Payment Element (需要更多控制)
• 动态支付方法 优先于明确 payment_method_types (使用 Payment Element)
• SetupIntents 优先于 Sources (保存支付方法)
• 确认令牌 优先于 createPaymentMethod/createToken (检查卡前支付)
• Billing APIs 优先于原始 PaymentIntents (订阅/定期)
• 直接收费 优先于目的地收费 (平台希望 Stripe 承担风险)
• 目的地收费 优先于直接收费 (平台接受责任)

决策

• 当 用户希望使用 Charges API：建议迁移到 CheckoutSessions 或 PaymentIntents
• 当 用户希望使用 Card Element：建议迁移到 Payment Element
• 当 定期收入/订阅/SaaS：推荐 Billing APIs + Checkout 前端
• 当 平台/市场/Connect：遵循集成推荐，使用控制器属性
• 当 迁移来自其他处理器的 PAN 数据：指向迁移流程
• 当 在创建意图前渲染 Payment Element：使用确认令牌

参考

• stripe:integration-options - 主要集成设计参考
• stripe:api-tour - API 概览
• stripe:go-live - 上线前检查清单
• stripe:migration/charges - Charges 到 PaymentIntents 迁移
• stripe:migration/payment-element - Card Element 到 Payment Element 迁移
• stripe:billing/design-integration - 订阅集成规划
• stripe:connect/recommendations - Connect 收费类型选择
• stripe:pan-import - PAN 数据迁移