用途
该技能面向需要在 Web 或移动应用中集成 Stripe 支付处理的开发者,目标是实现稳健且符合 PCI 合规要求的支付流程,涵盖结账、订阅、Webhook、退款等场景。适用情形包括:在 Web/移动应用中实现支付处理、搭建订阅计费系统、处理一次性支付与周期性扣款、处理退款与争议、管理客户支付方式、为欧洲支付实现 SCA(强客户认证),以及使用 Stripe Connect 构建市场支付流程。
主要能力
技能围绕以下核心概念展开:
- 支付流程:Checkout Session(托管支付页,PCI 合规负担最小、实现最快,支持一次性与周期性支付);Payment Intents(自定义 UI,需配合 Stripe.js 满足 PCI 合规,定制性更强);Setup Intents(在不扣款的情况下收集支付方式,用于订阅与未来支付,需客户确认)。
- Webhook:处理关键事件,如 payment_intent.succeeded、payment_intent.payment_failed、customer.subscription.updated、customer.subscription.deleted、charge.refunded、invoice.payment_succeeded。
- 订阅:由 Product(销售内容)、Price(金额与周期)、Subscription(客户周期性支付)、Invoice(每个计费周期生成)组成。
- 客户管理:创建与管理客户记录、存储多个支付方式、跟踪客户元数据、管理账单信息。
技能提供多种实现模式:一次性支付(托管结账)、自定义 Payment Intent 流程(含前端 JavaScript 示例)、订阅创建、客户门户会话。同时包含 Webhook 安全端点示例(Flask)、签名验证、幂等处理、客户创建与支付方式附加、退款与争议处理,以及测试卡号与测试流程。
使用方式
技能以代码示例形式给出实现方式。快速开始示例使用 Python 的 stripe 库创建 Checkout Session,设置 api_key、line_items、mode、success_url、cancel_url,并重定向用户至 session.url。自定义支付流程中,后端创建 PaymentIntent 并返回 client_secret,前端使用 Stripe.js 的 elements 与 confirmCardPayment 完成确认。订阅创建使用 stripe.Subscription.create,并展开 latest_invoice.payment_intent 获取 client_secret。客户门户通过 stripe.billing_portal.Session.create 生成跳转链接。Webhook 端点使用 stripe.Webhook.construct_event 验证签名,并按事件类型分发处理。
技能还给出工作流阶段:阶段一为产品与结账设置(定义 Product 与 Price、选择 Checkout 或 Payment Element、加入 SCA 步骤);阶段二为 Webhook 与后台处理(建立安全端点、签名验证、幂等处理);阶段三为异常处理与履约(通知支付失败、完成订单与更新数据库、集成客户门户)。检查点包括:金额是否以最小货币单位(Cents)发送、Webhook 端点在生产环境是否使用 HTTPS、是否在测试模式用 4242 卡验证成功/失败/3DS 全流程。
适用场景
适用于需要集成 Stripe 支付的 Web 与移动应用,尤其是订阅计费、一次性支付、退款与争议处理、客户支付方式管理、欧洲 SCA 支付以及 Stripe Connect 市场支付等场景。
限制
资料未提供该技能的具体收费、价格、平台支持范围或效果数据,暂未提供。技能内容以代码示例与最佳实践为主,实际实现需结合具体项目环境。