用途:在 Web 或移动应用中集成 Stripe 支付,实现 PCI 合规的支付流程,包括结账、订阅、Webhook、退款与争议处理。
主要能力:支持三种支付流程——托管 Checkout Session(PCI 负担最小、实现最快)、Payment Intent 自定义 UI(需 Stripe.js)、Setup Intent 保存支付方式;支持订阅计费(Product、Price、Subscription、Invoice);客户与支付方式管理;退款与争议证据提交;客户门户会话;SCA/3D Secure;Stripe Connect 市场支付。
关键事件:payment_intent.succeeded、payment_intent.payment_failed、customer.subscription.updated、customer.subscription.deleted、charge.refunded、invoice.payment_succeeded。
使用方式:服务端用 stripe.api_key 初始化,创建 Checkout Session 后重定向到 session.url;自定义 UI 用 PaymentIntent 返回 client_secret,前端用 Stripe.js 的 confirmCardPayment 确认;订阅用 Subscription.create 并展开 latest_invoice.payment_intent;Webhook 端点用 stripe.Webhook.construct_event 校验签名后按事件类型处理。测试使用 sk_test_ 密钥与测试卡号(如 4242424242424242、4000000000000002、4000002500003155、4000000000009995)。
限制与注意:金额以最小货币单位(分)传入;必须验证 Webhook 签名并做幂等处理;不要依赖客户端确认;服务端不得处理原始卡数据;需处理 Stripe 错误并实现重试;生产前充分测试。资料未提供具体收费、价格与平台支持信息。