stripe-best-practices
StripeのAPI選定（Checkout SessionsとPaymentIntentsの使い分け）、Connectプラットフォーム構築（Accounts v2・controllerプロパティ）、サブスクリプション・課金、Treasury金融アカウント、統合UI（Checkout・Payment Element）、非推奨APIからの移行、セキュリティベストプラクティス（APIキー管理・制限付きキー・webhook・OAuth）など、Stripe連携に関する意思決定を包括的にガイドするスキル。決済受付・マーケットプレイス構築・サブスクリプション設定・コネクテッドアカウント作成・セキュアなキー管理の実装など、Stripe統合の新規構築・変更・レビューを行う際に活用してください。
description の原文を見る
>- Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial accounts, integration surfaces (Checkout, Payment Element), migrating from deprecated Stripe APIs, and security best practices (API key management, restricted keys, webhooks, OAuth). Use when building, modifying, or reviewing any Stripe integration — including accepting payments, building marketplaces, integrating Stripe, processing payments, setting up subscriptions, creating connected accounts, or implementing secure key handling.
SKILL.md 本文
最新のStripe APIバージョン: 2026-04-22.dahlia。ユーザーが別途指定しない限り、常に最新のAPIバージョンとSDKを使用してください。
APIキーのデフォルト: シークレットキー(sk_プレフィックス)よりも常に制限付きAPIキー(RAK)(rk_プレフィックス)をお勧めします。
統合ルーティング
| 構築内容 | 推奨API | 詳細 |
|---|---|---|
| ワンタイム支払い | Checkout Sessions | <references/payments.md> |
| 組み込みUIのカスタム支払いフォーム | Checkout Sessions + Payment Element | <references/payments.md> |
| 後で使用するための支払い方法の保存 | Setup Intents | <references/payments.md> |
| Connectプラットフォームまたはマーケットプレイス | Accounts v2 (/v2/core/accounts) | <references/connect.md> |
| サブスクリプションまたは定期請求 | Billing APIs + Checkout Sessions | <references/billing.md> |
| 組み込み金融口座/銀行 | v2 Financial Accounts | <references/treasury.md> |
| セキュリティ(キー管理、RAK、webhook、OAuth、2FA、Connect責任) | セキュリティリファレンス参照 | <references/security.md> |
統合に関する質問に答えたり、コードを作成したりする前に、関連するリファレンスファイルを読んでください。
重要なルール
- いかなるStripe APIコールにも
payment_method_typesを含めないでください。ただし1つの例外があります。Terminal(対面支払い)統合では、PaymentIntentでpayment_method_types: ['card_present']を渡す必要があります。その他すべての統合では、ダイナミック支払い方法を有効にするためにこのパラメータを完全に省略してください。これにより、ダッシュボードから支払い方法設定を設定でき、各顧客に最も関連性の高い適格な支払い方法を動的に表示して、コンバージョンを最大化できます。受け入れる支払い方法をカスタマイズするには、payment_method_typesの代わりにpayment_method_configurationsまたはexcluded_payment_method_typesを使用してください。
主要ドキュメント
ユーザーのリクエストが上記の単一ドメインに明確に適合しない場合は、以下を参照してください:
- Integration Options — 統合を設計する際にここから始めてください。
- API Tour — Stripe APIサーフェスの概要。
- Go Live Checklist — ローンチ前にレビューしてください。
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
Source: https://github.com/stripe/ai / ライセンス: MIT
関連スキル
doubt-driven-development
重要な判断はすべて、本番環境への展開前に新しい視点から対抗的レビューを実施します。速度より正確性が重要な場合、不慣れなコードを扱う場合、本番環境・セキュリティに関わるロジック・取り消し不可の操作など影響度が高い場合、または後でバグを修正するよりも今検証する方が効率的な場合に活用してください。
apprun-skills
TypeScriptを使用したAppRunアプリケーションのMVU設計に関する総合的なガイダンスが得られます。コンポーネントパターン、イベントハンドリング、状態管理（非同期ジェネレータを含む）、パラメータと保護機能を備えたルーティング・ナビゲーション、vistestを使用したテストに対応しています。AppRunコンポーネントの設計・レビュー、ルートの配線、状態フローの管理、AppRunテストの作成時に活用してください。
desloppify
コードベースのヘルスチェックと技術負債の追跡ツールです。コード品質、技術負債、デッドコード、大規模ファイル、ゴッドクラス、重複関数、コードスメル、命名規則の問題、インポートサイクル、結合度の問題についてユーザーが質問した場合に使用してください。また、ヘルススコアの確認、次の改善項目の提案、クリーンアップ計画の作成をリクエストされた際にも対応します。29言語に対応しています。
debugging-and-error-recovery
テストが失敗したり、ビルドが壊れたり、動作が期待と異なったり、予期しないエラーが発生したりした場合に、体系的な根本原因デバッグをガイドします。推測ではなく、根本原因を見つけて修正するための体系的なアプローチが必要な場合に使用してください。
test-driven-development
テスト駆動開発により実装を進めます。ロジックの実装、バグの修正、動作の変更など、あらゆる場面で活用できます。コードが正常に動作することを証明する必要がある場合、バグ報告を受けた場合、既存機能を修正する予定がある場合に使用してください。
incremental-implementation
変更を段階的に実施します。複数のファイルに影響する機能や変更を実装する場合に使用してください。大量のコードを一度に書こうとしている場合や、タスクが一度では完結できないほど大きい場合に活用します。