用途:在网页或移动应用中集成 Stripe 支付,构建安全且符合 PCI 要求的支付流程,包括一次性付款、订阅计费、Webhook 处理、退款与争议、客户与支付方式管理,以及面向欧洲支付的强客户认证(SCA)和 Stripe Connect 市场分账。
主要能力:支持三种支付流程——托管结账(Checkout Session,PCI 负担最小、实现最快,支持一次性与周期付款)、自定义支付意图(Payment Intent,需配合 Stripe.js 保证 PCI 合规)、保存支付方式的 Setup Intent;支持订阅(Product、Price、Subscription、Invoice 概念);支持客户创建、多支付方式保存与默认支付方式设置;支持退款(全额/部分,reason 可为 duplicate、fraudulent、requested_by_customer)与争议证据提交;支持客户门户(billing portal)让客户自行管理订阅;Webhook 可处理 payment_intent.succeeded、payment_intent.payment_failed、customer.subscription.updated、customer.subscription.deleted、charge.refunded、invoice.payment_succeeded 等关键事件。
使用方式:用测试密钥 stripe.api_key = "sk_test_..." 初始化,创建结账会话后跳转 session.url;自定义 UI 则创建 Payment Intent 并返回 client_secret 给前端,前端用 stripe.confirmCardPayment 完成确认;订阅用 stripe.Subscription.create 并展开 latest_invoice.payment_intent;Webhook 端点用 stripe.Webhook.construct_event(payload, sig_header, endpoint_secret) 校验签名后按事件类型分发处理。测试卡号如 4242424242424242(成功)、4000000000000002(拒付)、4000002500003155(3D Secure)、4000000000009995(余额不足)。金额以最小货币单位(分)表示。
适用场景:网页/移动端收款、订阅计费系统、一次性与周期扣费、退款与争议处理、支付方式管理、欧洲 SCA 支付、Stripe Connect 市场支付。
限制:资料提及参考文档与示例客户端文件(references 与 assets 目录)但未提供具体内容;未提供定价、费率、支持平台版本或性能数据;Webhook 应做幂等处理并验证签名,失败时 Stripe 会重试;服务端不应处理原始卡数据。