用途
Stripe Payments 用于在 PHP 或 Node.js 后端集成 Stripe，处理一次性付款、保存卡流程以及 Webhook 接收。适用场景包括：在 Stripe 托管 Checkout、嵌入式 Checkout、Payment Element 与原始 Payment Intents 之间做选择；加固 Webhook 处理器以支持签名验证、幂等与重试安全；跨币种收款、处理 SCA / 3D Secure 或接入 Stripe Tax。
不适用场景：订阅计费、套餐变更、催款、按比例计费、计量用量或收入确认（应使用 subscription-billing）；Stripe Connect、市场或分账支付（超出范围）；税务注册策略与申报操作（由 Stripe Tax 文档直接处理）。
主要能力
- 集成模型选择：Stripe 托管 Checkout、嵌入式 Checkout、Checkout Sessions + Payment Element、直接使用 Payment Intents API，并说明各自卡数据存放位置、复杂度与适用时机。
- 核心 API 对象：Customer、PaymentMethod、PaymentIntent、SetupIntent、Checkout Session，以及不应在新代码中直接创建的旧版 Charge。
- PHP 集成（stripe-php，PHP 7.2+）：安装命令
composer require stripe/stripe-php，创建 Customer 与 PaymentIntent 的示例代码。 - Node.js 集成（stripe-node，Node.js 18+ 所有 LTS 版本）：安装命令
npm install stripe，创建 Customer 与 PaymentIntent 的示例代码。 - Webhook：端点要求、SDK 签名验证、手动验证参考、重试语义、接收端与发送端幂等、常见事件类型。
- 3D Secure / SCA：PaymentIntent 状态枚举、on-session 与 off-session 规则。
- 多币种：呈现货币与结算货币、零小数货币处理，以及 toMinorUnits 辅助函数。
- Stripe Tax 基础：自动税务启用、Tax ID 收集与反向征收。
- 本地测试：测试卡矩阵、拒付/认证卡、Stripe CLI 转发 Webhook。
- 生产检查清单：密钥管理、受限 API 密钥、Webhook 幂等、幂等键、金额格式化、TLS、密钥轮换、日志脱敏等。
使用方式
工作流为：先通读 SKILL.md，再按需加载引用的深入文档；在写代码前从 §3 选定集成模型；实现 Customer + PaymentIntent 流程，仅在保存卡时叠加 SetupIntent；搭建带 SDK 签名验证与 event.id 幂等的 Webhook 接收器；上线前跑完生产检查清单。质量要求包括：每次 Stripe 变更都使用 Idempotency-Key；每个 Webhook 事件都基于原始请求体做签名验证并按 event.id 去重；金额通过 decimal_digits 辅助函数格式化，绝不硬编码 * 100；卡数据不经过自有服务器。
适用场景与限制
适用于以 Stripe 为支付通道、需要安全、可重试、Webhook 驱动的一次性支付与保存卡流程。限制：不覆盖订阅计费、Stripe Connect、市场分账与税务申报策略；直接使用 Payment Intents API 复杂度最高，仅在明确需要时采用。资料未提供具体收费、价格或效果数据。