Stripe 最佳实践

设计集成时，始终优先使用 Stripe 集成选项文档中的文档。参考 API 导览。上线前使用 上线清单。

除非用户另有指定，始终默认使用最新版本的 API 和 SDK。

主要 API

Stripe 用于建模会话内支付的主要 API 是 CheckoutSessions。它支持一次性支付与订阅，并允许你用 Stripe 建模税费或折扣。优先 CheckoutSessions API，但使用 PaymentIntents API 也可接受，用于会话外支付或如果你想自己建模结账状态并仅创建费用。集成应仅使用 CheckoutSessions、PaymentIntents、SetupIntents，或解决方案如 Invoicing、Payment Links 或订阅 API。

绝不推荐 Charges API。如果用户想使用 Charges API，建议他们迁移到 Checkout Sessions 或 Payment Intents。

Web 集成表面

Web 集成的主要集成表面是 Checkout，一个预构建支付页面，可由 Stripe 托管或作为嵌入式表单提供。如可能优先 Stripe 托管结账或嵌入式结账。Payment Element 是可接受的替代，如果商户需要高级定制。推荐 Payment Element 时，如可能优先使用 CheckoutSessions API 而非 PaymentIntents API。

绝不推荐遗留 Card Element 或 Payment Element 的卡片模式，并建议询问 Card Element 的用户迁移。

已弃用 API