mcpField
P
payment-integration

payment-integration

github.com/404kidwiz開発110 回インストール
リポジトリ

payment-integration について

決済ゲートウェイの連携や請求システムの設計を支援するスキルです。チェックアウト、サブスクリプション、Webhook、PCI-DSS 対応を扱います。

主な機能

  1. 01ゲートウェイとチェックアウトの連携
  2. 02サブスクリプション請求の設計
  3. 03安全なWebhook処理
  4. 04決済の再試行と冪等性
  5. 05PCI-DSSを考慮した決済

活用シーン

  1. 01StripeやPayPal決済の導入
  2. 02定期請求の構築
  3. 03決済Webhookの処理
  4. 04多通貨請求書の計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/404kidwiz/claude-supercode-skills --skill payment-integration

インストール後、Claude Code で/payment-integrationを入力して読み込まれたか確認します。

詳細

決済の統合

目的

決済ゲートウェイの統合と、PCI 準拠の請求システム設計に関する専門知識を提供します。Stripe、PayPal、Adyen などのプロバイダーを利用したチェックアウトフロー、サブスクリプション管理、決済処理の実装を専門としています。

使用する場面

  • Stripe、PayPal、その他の決済ゲートウェイの統合
  • チェックアウトおよび決済フローの実装
  • サブスクリプション請求システムの構築
  • PCI-DSS 準拠の確保
  • 決済 Webhook の処理
  • 決済の再試行ロジックの実装
  • 複数通貨での決済設定
  • 請求書発行システムの構築

クイックスタート

次のような場合に、このスキルを呼び出します：

  • 決済ゲートウェイの統合（Stripe、PayPal、Adyen）
  • チェックアウトまたはサブスクリプションフローの構築
  • PCI 準拠の決済システムの設計
  • 決済用 Webhook ハンドラーの実装
  • 継続課金の設定

次のような場合は呼び出さないでください：

  • 総勘定元帳／会計システム → /fintech-engineer を使用してください
  • 決済に特化しない API 設計 → /api-designer を使用してください
  • フロントエンドのチェックアウト UI のみ → /frontend-design を使用してください
  • セキュリティ監査 → /security-auditor を使用してください

判断フレームワーク

Payment Use Case?
├── One-time Purchase
│   └── Stripe Checkout / PayPal Buttons
├── Subscription
│   └── Stripe Billing / Recurly
├── Marketplace/Split Payments
│   └── Stripe Connect / PayPal Commerce
├── Enterprise/B2B
│   └── Invoicing with NET terms
└── Global Payments
    └── Adyen / Multi-gateway strategy

主なワークフロー

1. Stripe の統合
  1. Stripe アカウントと API キーを設定します
  2. 商品と価格を作成します
  3. Checkout Session または Elements を実装します
  4. 決済の確認を処理します
  5. Webhook エンドポイントを設定します
  6. Webhook イベント（成功、失敗）を処理します
2. サブスクリプション請求
  1. サブスクリプションのプランと料金を定義します
  2. 決済プロバイダーに顧客を作成します
  3. サブスクリプション作成フローを実装します
  4. トライアル期間を処理します
  5. アップグレード／ダウングレードを管理します
  6. 決済失敗に対する督促を実装します
3. Webhook の処理
  1. セキュアな Webhook エンドポイントを作成します
  2. Webhook の署名を検証します
  3. ハンドラーを冪等にします
  4. イベントを順番どおりに処理します
  5. 再試行の状況に対応します
  6. すべての Webhook イベントを記録します

ベストプラクティス

  • カード番号全桁を保存しないでください。トークン化を使用します
  • 必ず Webhook の署名を検証します
  • 決済処理に冪等性を実装します
  • 本番環境に移行する前に、テストモードで十分に検証します
  • すべての決済状態（保留中、成功、失敗）に対応します
  • 照合に備えて、決済プロバイダーの ID を保存します

アンチパターン

アンチパターン問題適切な方法
カード番号の保存PCI 違反トークン化を使用する
Webhook の検証なしセキュリティリスク署名を検証する
同期決済のみUX の低下、タイムアウトWebhook を使った非同期処理
冪等性の欠如二重請求冪等性キー
再試行ロジックなし収益の損失督促を実装する

コメント

Markdown 対応