用途:在 Web 或移动应用中集成 Stripe 支付,涵盖一次性付款、订阅计费、退款与争议、客户支付方式管理、欧洲 SCA 强客户认证,以及基于 Stripe Connect 的市场平台收款。
主要能力:支持三种支付流程——托管 Checkout Session(PCI 负担最小、实现最快)、Payment Intents 自定义 UI(需配合 Stripe.js)、Setup Intents 保存支付方式;支持订阅(Product、Price、Subscription、Invoice)、客户与支付方式管理、退款与争议举证、客户门户;Connect 支持 Direct Charge、Destination Charge 与 Separate Charges & Transfers 三种模式。
必要用法:服务端用 stripe.api_key 初始化,创建 Checkout Session 或 Payment Intent,前端跳转 session.url 或用 client_secret 确认支付;Webhook 端点必须用 stripe.Webhook.construct_event 校验签名,并做幂等处理。Connect 的 Direct Charge 场景下,checkout.session.completed 等事件发往 Connect 端点而非平台端点,需单独处理。
关键限制与注意:100% 折扣码的订单状态为 complete、payment_status 为 paid、amount_total 为 0 且无 payment_intent,不能用 no_payment_required 判断;建议采用 Webhook 与前端轮询的双重确认,用条件更新保证幂等;测试使用 sk_test_ 密钥与测试卡号。资料未提供具体收费、价格与平台支持范围。