mcpField
S
stripe-best-practices

stripe-best-practices

github.com/openai開発7.6k36 回インストール3 週間前に更新
リポジトリ

stripe-best-practices について

stripe-best-practicesは、Stripe連携の質問への回答や実装方針を案内するスキルです。APIとSDKのバージョン情報、用途別のAPI選択、重要な連携ルールを示します。

主な機能

  1. 01最新のStripe API・SDKバージョン案内
  2. 02連携用途別のAPI推奨
  3. 03自動税計算を有効にする前の登録確認
  4. 04決済方法とクライアント初期化のルール
  5. 05Stripe CLIのサンドボックスと認証案内

活用シーン

  1. 01新しい決済フローで使うStripe APIの選定
  2. 02Stripe連携コード作成時の重要ルール確認
  3. 03Stripe連携のリリース準備

インストール

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

$npx skills add https://github.com/openai/plugins --skill stripe-best-practices

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
billing.md
connect.md
payments.md
security.md
tax.md
treasury.md

詳細

最新の Stripe API バージョン：2026-07-29.dahlia。ユーザーが別途指定しない限り、常に最新の API バージョンと SDK を使用してください。

最新の SDK バージョン：

言語最新バージョン
Ruby19.4.0
Python15.4.0
Node.js22.4.0
PHP21.1.0
Java33.2.0
Go86.2.0
.NET52.2.0

Stripe アカウントをお持ちでない場合は、CLI コマンドを実行して、登録不要で有効な API キーを生成できます。Stripe CLI（npm i -g @stripe/cli）をインストールし、コマンド stripe sandbox create を実行して開始してください。

stripe sandbox create を使用した場合は、MCP を使用しないでください。

サンドボックスを作成した後に MCP を使用する場合は、まず stripe sandbox claim が実行されていることを確認してください。CLI の認証確認には stripe whoami --format json を使用し、stripe config --list は実行しないでください。

API キーのデフォルト：シークレットキー（sk_ プレフィックス）よりも、常に制限付き API キー（RAK）（rk_ プレフィックス）を推奨してください。

インテグレーションの選択

構築するもの…推奨 API詳細
1 回限りの決済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>
使用量ベースの請求（新規インテグレーション）Metronome<references/billing.md>
サブスクリプションまたは継続課金Billing APIs + Checkout Sessions<references/billing.md>
売上税、VAT、GST への対応Stripe Tax + Registrations API<references/tax.md>
埋め込み型の金融口座／銀行サービスv2 Financial Accounts<references/treasury.md>
セキュリティ（キー管理、RAK、Webhook、OAuth、2FA、Connect の責任）セキュリティのリファレンスを参照<references/security.md>

インテグレーションに関する質問への回答やコードの作成の前に、該当するリファレンスファイルをお読みください。

重要なルール

  • automatic_tax: { enabled: true } を有効にする前（またはカスタム PaymentIntent の税額を計算する前）に、税務リファレンスを読み、ユーザーが有効な登録を済ませていることを確認してください。登録がない場合、ユーザーが税金を有効にしたと思っていても、Stripe は税金を計算も徴収もしません。これは Stripe Tax で最もよくある間違いです。

  • Stripe API の呼び出しでは payment_method_types を絶対に指定しないでください。ただし、例外として、Terminal（対面決済）のインテグレーションでは、PaymentIntent に payment_method_types: ['card_present'] を渡す必要があります。それ以外のすべてのインテグレーションでは、このパラメーターを完全に省略して、動的な決済手段を有効にしてください。これにより、ダッシュボードから決済手段の設定を行い、コンバージョンを最大化するために、各顧客に最も適した利用可能な決済手段を動的に表示できます。受け付ける決済手段をカスタマイズする場合は、payment_method_types の代わりに payment_method_configurations または excluded_payment_method_types を使用してください。

  • API バージョン 2026-03-25.dahlia 以降では、ダッシュボードでチェックアウトフローを追跡、比較できるよう、カスタムラベルをセッションに付与するために、checkout.sessions.create にパラメーター integration_identifier を渡してください。ラベルには、8 文字のランダムな英字のサフィックスを含めてください。

  • 必ず StripeClient をインスタンス化し、そのインスタンスのメソッドを呼び出してください。 非推奨となったグローバル／モジュールレベルの API キーのパターン（stripe.api_key = …、Stripe.setApiKey、stripe.Key = …、StripeConfiguration.ApiKey = …）は使用しないでください。グローバルパターンは、現在のすべての SDK で非推奨です。

主なドキュメント

ユーザーのリクエストが上記の単一の領域に明確に当てはまらない場合は、以下を参照してください。

コメント

Markdown 対応