決済ゲートウェイ統合

目次

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

概要

主要な決済プロバイダー（Stripe、PayPal、Square）を使用して安全な決済処理システムを構築し、トランザクション、サブスクリプション、webhook、PCI準拠、エラーシナリオを異なるバックエンドフレームワーク全体で処理します。

使用場面

• 顧客決済の処理
• サブスクリプション請求の実装
• e-commerceプラットフォームの構築
• 払い戻しと紛争への対応
• 定期的な課金の管理
• 決済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):
        """支払いインテントを作成"""
        try:
            intent = stripe.PaymentIntent.create(
                amount=int(amount * 100),  # セント単位に変換
                currency=currency,
// ... (完全な実装についてはリファレンスガイドを参照)

リファレンスガイド

references/ ディレクトリ内の詳細な実装：

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

ベストプラクティス

✅ すべき こと

• 公式の決済SDKライブラリを使用する
• webhook署名を検証する
• 最小限の決済情報を保存する
• フルのクレジットカード番号を保存しない
• すべての決済ルートで HTTPSを使用する
• 適切なエラーハンドリングを実装する
• サンドボックス環境でテストする
• 決済失敗に優雅に対応する
• PCI準拠を実装する
• すべての決済トランザクションをログに記録する
• べき等性キー(idempotency key)を使用する
• リトライロジックを実装する

❌ してはいけない こと

• 生のカードデータを処理する
• 機密の決済情報を保存する
• 機密情報をログに出力する
• クライアント側の検証のみを信頼する
• webhookイベントを無視する
• APIキーをハードコードする
• テストキーを本番環境で使用する
• SSL/TLS検証をスキップする
• 金額の検証を忘れる
• 決済トークンを暗号化せずに保存する