payment-gateway-integration

決済ゲートウェイの統合

目次

• 概要
• 使用する場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

主要な決済プロバイダー（Stripe、PayPal、Square）を利用して、安全な決済処理システムを構築します。さまざまなバックエンドフレームワークで、取引、サブスクリプション、Webhook、PCI 準拠、エラーシナリオに対応します。

使用する場面

• 顧客の決済処理
• サブスクリプション課金の実装
• Eコマースプラットフォームの構築
• 返金や異議申し立てへの対応
• 継続課金の管理
• 決済 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/ ディレクトリを参照してください。

ガイド	内容
Python/Flask による Stripe の統合	Python/Flask による Stripe の統合
Node.js/Express による Stripe の統合	Node.js/Express による Stripe の統合
PayPal の統合	PayPal の統合
サブスクリプション管理	サブスクリプション管理

ベストプラクティス

✅ 推奨事項

• 公式の決済 SDK ライブラリを使用する
• Webhook の署名を検証する
• 決済情報の保存は最小限にする
• クレジットカード番号の全桁を保存しない
• すべての決済ルートで HTTPS を使用する
• 適切なエラー処理を実装する
• サンドボックス環境でテストする
• 決済の失敗に適切に対処する
• PCI 準拠を実装する
• すべての決済取引を記録する
• 冪等性キーを使用する
• 再試行ロジックを実装する

❌ 禁止事項

• カードの生データを扱う
• 機密性の高い決済情報を保存する
• 機密情報をログに記録する
• クライアント側の検証だけを信頼する
• Webhook イベントを無視する
• API キーをハードコードする
• 本番環境でテストキーを使用する
• SSL/TLS の検証を省略する
• 金額の検証を忘れる
• 決済トークンを暗号化せずに保存する