用途
Payment Gateway Integration 用于帮助开发者构建安全可靠的支付处理系统，支持主流支付服务商（Stripe、PayPal、Square），围绕交易处理、订阅管理、Webhook 处理、PCI 合规以及各类错误场景展开，并适用于不同的后端框架。
适用时机
根据资料，以下场景适合使用该技能：处理客户支付、实现订阅计费、构建电商平台、处理退款与争议、管理周期性扣款、集成支付 Webhook。
主要能力
该技能以参考指南（references/ 目录）的形式组织具体实现，包含以下方向：
- Stripe Integration with Python/Flask
- Node.js/Express Stripe Integration
- PayPal Integration
- Subscription Management
快速上手给出了一个最小可用示例，展示配置与创建支付意图（Payment Intent）的思路。示例包含配置类（读取 STRIPE_SECRET_KEY、STRIPE_PUBLISHABLE_KEY、STRIPE_WEBHOOK_SECRET 等环境变量）以及 StripePaymentService 类中 create_payment_intent 方法的实现片段，金额通过 int(amount * 100) 转换为分（cents），并支持 currency、description、metadata 参数。资料中该代码片段在注释处截断，完整实现需参考参考指南。
使用方式
配置层面通过环境变量注入密钥（如 STRIPE_SECRET_KEY、STRIPE_PUBLISHABLE_KEY、STRIPE_WEBHOOK_SECRET），并在服务端设置 stripe.api_key。实现层面按所选参考指南进行集成，涵盖支付意图创建、订阅管理与 Webhook 处理等。
最佳实践（应做）
使用官方支付 SDK 库；验证 Webhook 签名；仅存储最少量的支付信息；绝不存储完整信用卡号；所有支付路由使用 HTTPS；实现完善的错误处理；在沙箱环境中测试；优雅处理支付失败；实现 PCI 合规；记录所有支付交易；使用幂等键；实现重试逻辑。
限制与注意事项（不应做）
不处理原始卡数据；不存储敏感支付信息；不记录敏感细节；不仅依赖客户端验证；不忽略 Webhook 事件；不硬编码 API 密钥；不在生产环境使用测试密钥；不跳过 SSL/TLS 验证；不忘记校验金额；不存储未加密的支付令牌。
暂未提供的信息
资料未提供具体价格、收费模式、平台限制、性能数据以及除上述示例外的完整代码实现。