stripe-integration
Stripeを使った決済機能を初日から正しく実装するための完全ガイド。支払い処理・サブスクリプション・請求ポータル・Webhook・従量課金・Stripe Connectまでを網羅し、深夜3時に発覚するようなエッジケースも含めた実践的な対処法を提供します。API呼び出しにとどまらず、決済失敗のハンドリング・サブスクリプション管理・督促処理・収益維持まで、決済システム全体をカバーしており、stripe・payments・subscription・billing・checkoutに関わる実装時に活用できます。
description の原文を見る
Get paid from day one. Payments, subscriptions, billing portal, webhooks, metered billing, Stripe Connect. The complete guide to implementing Stripe correctly, including all the edge cases that will bite you at 3am. This isn't just API calls - it's the full payment system: handling failures, managing subscriptions, dealing with dunning, and keeping revenue flowing. Use when: stripe, payments, subscription, billing, checkout.
SKILL.md 本文
Stripe Integration
あなたは何十億ドルものトランザクションを処理してきた決済エンジニアです。 あらゆるエッジケースを経験しています - カード拒否、Webhook障害、サブスクリプション問題、通貨問題、払い戻し詐欺。決済コードは実際のお金を扱うため、完璧である必要があることを知っています。レースコンディション、べき等性、Webhook検証について用心深くなっています。
Capabilities
- stripe-payments
- subscription-management
- billing-portal
- stripe-webhooks
- checkout-sessions
- payment-intents
- stripe-connect
- metered-billing
- dunning-management
- payment-failure-handling
Requirements
- supabase-backend
Patterns
すべての操作にべき等性キーを付与する
重複請求を防ぐため、すべての決済操作にべき等性キーを使用する
Webhook ステートマシン
Webhookをトリガーではなく、状態遷移として処理する
開発全体でテストモードを使用
開発中のすべての処理で、実際のテストカードを使用したStripeテストモードを使用する
Anti-Patterns
❌ APIレスポンスを信頼する
❌ Webhook署名検証なしの使用
❌ リフレッシュなしでのサブスクリプション状態チェック
⚠️ Sharp Edges
| Issue | Severity | Solution |
|---|---|---|
| Webhook署名の検証をしていない | critical | # 常に署名を検証する: |
| Webhookが検証できる前にJSONミドルウェアがボディをパースしている | critical | # Next.js App Router: |
| 決済操作にべき等性キーを使用していない | high | # 常にべき等性キーを使用する: |
| APIレスポンスを信頼していて、支払いステータスのWebhookに頼っていない | critical | # Webhook優先アーキテクチャ: |
| チェックアウトセッション経由でメタデータを渡していない | high | # 常にメタデータを含める: |
| ローカルサブスクリプション状態がStripe状態から逸脱している | high | # すべてのサブスクリプション Webhook を処理する: |
| 失敗した支払いとダニング処理をしていない | high | # invoice.payment_failed を処理する: |
| テストモードと本番モード間で異なるコードパスまたは動作がある | high | # すべてのキーを分離する: |
Related Skills
Works well with: nextjs-supabase-auth, supabase-backend, webhook-patterns, security
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- davila7
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/davila7/claude-code-templates / ライセンス: MIT
関連スキル
doubt-driven-development
重要な判断はすべて、本番環境への展開前に新しい視点から対抗的レビューを実施します。速度より正確性が重要な場合、不慣れなコードを扱う場合、本番環境・セキュリティに関わるロジック・取り消し不可の操作など影響度が高い場合、または後でバグを修正するよりも今検証する方が効率的な場合に活用してください。
apprun-skills
TypeScriptを使用したAppRunアプリケーションのMVU設計に関する総合的なガイダンスが得られます。コンポーネントパターン、イベントハンドリング、状態管理（非同期ジェネレータを含む）、パラメータと保護機能を備えたルーティング・ナビゲーション、vistestを使用したテストに対応しています。AppRunコンポーネントの設計・レビュー、ルートの配線、状態フローの管理、AppRunテストの作成時に活用してください。
desloppify
コードベースのヘルスチェックと技術負債の追跡ツールです。コード品質、技術負債、デッドコード、大規模ファイル、ゴッドクラス、重複関数、コードスメル、命名規則の問題、インポートサイクル、結合度の問題についてユーザーが質問した場合に使用してください。また、ヘルススコアの確認、次の改善項目の提案、クリーンアップ計画の作成をリクエストされた際にも対応します。29言語に対応しています。
debugging-and-error-recovery
テストが失敗したり、ビルドが壊れたり、動作が期待と異なったり、予期しないエラーが発生したりした場合に、体系的な根本原因デバッグをガイドします。推測ではなく、根本原因を見つけて修正するための体系的なアプローチが必要な場合に使用してください。
test-driven-development
テスト駆動開発により実装を進めます。ロジックの実装、バグの修正、動作の変更など、あらゆる場面で活用できます。コードが正常に動作することを証明する必要がある場合、バグ報告を受けた場合、既存機能を修正する予定がある場合に使用してください。
incremental-implementation
変更を段階的に実施します。複数のファイルに影響する機能や変更を実装する場合に使用してください。大量のコードを一度に書こうとしている場合や、タスクが一度では完結できないほど大きい場合に活用します。