payment-gateway-integration

支付网关集成

目录

• 概述
• 适用场景
• 快速开始
• 参考指南
• 最佳实践

概述

使用主流支付服务提供商（Stripe、PayPal、Square）构建安全的支付处理系统，在不同后端框架中处理交易、订阅、Webhook、PCI 合规性和错误场景。

适用场景

• 处理客户付款
• 实现订阅计费
• 构建电商平台
• 处理退款和争议
• 管理定期扣款
• 集成支付 Webhook

快速开始

最小可运行示例：

# config.py
import os

class StripeConfig:
    STRIPE_SECRET_KEY = os.getenv('STRIPE_SECRET_KEY')
    STRIPE_PUBLISHABLE_KEY = os.getenv('STRIPE_PUBLISHABLE_KEY')
    STRIPE_WEBHOOK_SECRET = os.getenv('STRIPE_WEBHOOK_SECRET')

# stripe_service.py
import stripe
from datetime import datetime, timedelta
import logging

logger = logging.getLogger(__name__)

stripe.api_key = os.getenv('STRIPE_SECRET_KEY')

class StripePaymentService:
    @staticmethod
    def create_payment_intent(amount, currency='usd', description=None, metadata=None):
        """Create a payment intent"""
        try:
            intent = stripe.PaymentIntent.create(
                amount=int(amount * 100),  # Convert to cents
                currency=currency,
// ... (see reference guides for full implementation)

参考指南

references/ 目录中的详细实现：

指南	内容
Stripe 与 Python/Flask 集成	Stripe 与 Python/Flask 集成
Node.js/Express Stripe 集成	Node.js/Express Stripe 集成
PayPal 集成	PayPal 集成
订阅管理	订阅管理

最佳实践

✅ 应该做

• 使用官方支付 SDK 库
• 验证 Webhook 签名
• 仅存储最少的支付信息
• 绝不存储完整的信用卡号
• 所有支付路由均使用 HTTPS
• 实现适当的错误处理
• 在沙盒环境中测试
• 妥善处理支付失败
• 确保符合 PCI 标准
• 记录所有支付交易
• 使用幂等键
• 实现重试逻辑

❌ 不应该做

• 处理原始银行卡数据
• 存储敏感支付信息
• 记录敏感详细信息
• 仅依赖客户端验证
• 忽略 Webhook 事件
• 将 API 密钥硬编码
• 在生产环境中使用测试密钥
• 跳过 SSL/TLS 验证
• 忘记验证金额
• 未加密存储支付令牌