FastAPI 的 Stripe 集成

FastAPI 的 Stripe 集成包含官方 stripe Python SDK、FastAPI APIRouter、创建 PaymentIntent 的端点、在 await request.body() 上调用 construct_event 的 webhook、对现有存储的订单状态更新、针对 Stripe 测试事件的测试以及交付说明。你在项目中收到 FastAPI 源码。Stripe 手续费与账户是分开的。

会。FastAPI 的 Stripe 集成面向你已有的 FastAPI 应用。我们把路由、依赖与 Settings 装进当前 FastAPI 项目，而不是把单独演示应用当作交付物。

不会。FastAPI 不得存储 PAN。客户端使用 Stripe Checkout 或 Elements。FastAPI 的 Stripe 集成负责服务端 PaymentIntent、webhook 与订单写入。提交原始卡数据的自定义 FastAPI Form 不在默认范围内。

FastAPI 的 Stripe 集成使用官方 stripe Python 库做 PaymentIntents、Checkout Sessions 与 Webhook.construct_event。除非你明确要求，我们不会用无文档插件包裹 FastAPI 支付。

stripe.Webhook.construct_event 校验 Stripe 签名的原始字节。await request.json() 会解析并改动该请求体。FastAPI 的 Stripe 集成在 webhook 路由读取 await request.body()。跳过这一点是 FastAPI 签名失败的常见原因。

不等于。FastAPI 使用 APIRouter、Depends 与 pydantic-settings。Django 视图、urls.py 与 Django ORM 属于 Django 的 Stripe 集成。我们不会把 Django 模式贴进 FastAPI 应用。

FastAPI 可以创建 PaymentIntent 或 Checkout Session 并存储 Stripe customer id。周期性 Stripe Billing 产品、客户门户与发票逻辑留在服务端。偏重订阅的 FastAPI 工作可能需要定制报价。

FastAPI 进程从 Settings / 环境变量使用密钥与 webhook 签名密钥。客户端只收到可发布密钥。FastAPI 的 Stripe 集成不会把密钥放进 Pydantic 请求模型。

我们先用 Stripe 测试密钥与测试 webhook 事件实现 FastAPI 的 Stripe 集成。上线是 Stripe Dashboard 与 FastAPI 环境中有文档的密钥与端点切换，不是附加组件许可证激活。

FastAPI 创建支持 SCA 的 PaymentIntent。客户端用 Stripe.js 或 Checkout 完成 3-D Secure。FastAPI 只在 webhook 上的 payment_intent.succeeded 之后履约，不只凭浏览器重定向。

FastAPI 创建的 PaymentIntent 或 Checkout Session 之后的履约需要。FastAPI 返回给客户端的 200 不是事实来源。webhook 路由校验签名后标记订单已付。

可以。FastAPI 的 Stripe 集成通常在现有 FastAPI 订单模型旁添加字段或薄支付记录，而不是替换 SQLAlchemy 或发明 Django 模型。

不包含。你创建并拥有 Stripe 账户、API 密钥与 Stripe 手续费。FastAPI 附加组件价格是接入你的 FastAPI 项目，不是 Bacodo 支付许可证。

我们在 FastAPI 兼容性检查中如实确定范围。async def 中的阻塞 stripe 调用会放到线程池，或在所固定的 stripe 版本支持时使用异步 StripeClient。我们不假装同步 stripe 在异步 FastAPI 路由里是免费的。

可以。PaymentIntent 或 Checkout Session 元数据、客户记录以及 webhook 确认后持久化的字段会在 FastAPI 的 Stripe 集成期间对齐到现有 FastAPI 订单模型。

FastAPI 源码在你的仓库，团队可自行维护。包含的 30 天支持覆盖已交付的 FastAPI Stripe 集成范围内的技术问题与缺陷，不含无关的 FastAPI 功能开发。

在 30 天窗口内，我们协助因已文档化的 Stripe API 或 stripe 包变更导致的已交付 FastAPI 集成故障。之后的 FastAPI 升级由你维护，或购买延长技术支持。

我们说明如何阅读 PaymentIntent 状态、Stripe Dashboard 日志与 FastAPI webhook 投递。30 天支持包括排查签名失败（通常是 request.json() 而不是 request.body()）、重试与已交付 FastAPI 流程的密钥配置错误。

我们会在集成时对照所固定的 stripe 版本确认你的 FastAPI、Python 与 pydantic v2 版本。过旧或重度分叉的 FastAPI 运行时可能需要额外范围。

交付后 30 天包含在已交付的 FastAPI Stripe 路径内。延长技术支持可选，为本 FastAPI 附加组件价格的 20%，再覆盖六个月对同一 FastAPI 集成的技术帮助，不是新产品构建。