Visual Studio Code をご利用の場合

エディターから Stripe を構築、テスト、使用します。

Visual Studio Code 用の Stripe の拡張機能を使用すると、サンプルコードの生成、API リクエストログの表示、アプリケーションへのイベントの転送、エディター内での Stripe の使用が可能になります。

アクティビティーバーの新しい Stripe パネルを使用すると、複数言語のコードスニペットにアクセスできるほか、デバッグ設定の追加や、一般的な開発者ワークフローでコマンドパレットの拡張が可能になります。

VS Code 向けの Stripe を使用して、以下のことが可能になります。

Stripe サンプルですぐに開始
Stripe Webhook イベントをローカルアプリケーションに転送
リアルタイムでリクエストログをストリーミング
テスト中に新しいイベントをトリガー
一般的なシナリオのためのスニペットを生成
ソースコードが API キーを公開していないことを確認
API リファレンスにすばやく移動
Stripe ダッシュボードに簡単にアクセス

VS Code 向けの Stripe のインストール

注

前提条件として、Stripe CLI がインストールされていることを確認してください。

Stripe VS Code の拡張機能は Visual Studio のマーケットプレイスで確認できます。インストールをクリックして、拡張機能をエディターに追加します。

機能

Stripe サンプルですぐに開始する

Stripe サンプルは、Stripe が作成したもので、Stripe Billing を使用したサブスクリプションの作成など、一般的な組み込みのシナリオに必要なクライアントとサーバーのコードをすべて提供します。

Start with a Stripe Sample (Stripe サンプルで開始する) ボタンを使用すると、カタログを参照して、組み込みに適した言語を選択できます。この拡張機能は、サンプルを複製して新しいワークスペースで開き、サンプルの .env ファイルに API キーを自動入力します。

Webhook イベントをトリガーして転送する

受信する Webhook イベントをリッスンし、以下の 2 つのいずれかの方法でローカルマシンに転送できます。

EVENTS (イベント) セクションで Forward webhook events to your local machine (Webhook イベントをローカルマシンに転送) をクリックします。
コマンドパレットから、Stripe: Forward webhook events to your local machine コマンドを実行します。

次に、イベントの転送先の localhost URL を入力します。Connect を使用している場合は、Connect アプリケーションからのイベントに対して別の URL を設定できます。ローカルホスト URL が HTTPS を使用している場合は、SSL 証明書の検証をスキップできます。

Trigger new event (新しいイベントをトリガー) ボタンを使用すると、Stripe API のイベントを使用して Webhook 組み込みをテストできます。

注意

イベントをトリガーできるのは、テスト環境のみです。

Start streaming events (イベントのストリーミングを開始) ボタンを使用すると、アカウントのメンバーが作成したイベントをリアルタイムでストリーミングできます。Recent events (最近のイベント) の下のイベントエントリーをクリックすると、イベントの詳細がエディター内に直接表示されます。

注

イベントを再送信するには、Recent events (最近のイベント) のイベントエントリーを右クリックするか、Stripe CLI で stripe events resend <event> コマンドを実行してください。

Stripe デバッグ設定

イベントをローカルマシンに転送する際、同じ URL を何度も入力しなければならないことがあります。この問題を解決するには、デバッグ設定を作成して転送設定を保存しておくと、ボタン 1 つで URL への転送を開始することができます。

以下の設定を launch.json ファイルに記述します。このファイルは VS Code がデバッグ設定の詳細を追跡するために使用します。次に、RUN (実行) ビューで設定を選択します。設定を選択した後、F5 を押すと、イベントの転送がすぐに開始されます。

.vscode/launch.json
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Stripe: Webhooks listen",
      "type": "stripe",
      "request": "launch",
      "command": "listen",
      "forwardTo": "https://localhost:3000",
      "forwardConnectTo": "https://localhost:3000",
      "events"
: ["payment_intent.succeeded", "payment_intent.canceled"],
      "skipVerify"
: true
    }
  ]
}

forwardTo および forwardConnectTo パラメーターを指定できます。これらのパラメーターは、アカウントのイベントと Connect イベントをそれぞれ受信するローカルマシン上の URL です。events パラメーターは、受信するイベントを指定するオプションのリストを受け付けます。HTTPS URL を使用している場合は、skipVerify パラメーターに SSL 証明書の検証をスキップするブール値を指定できます。

複数の設定を組み合わせる

複合起動設定を使用すると、ローカルアプリケーションの起動と Webhook イベントの転送を同時に行うことができます。

.vscode/launch.json
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Stripe: Webhooks listen",
      "type": "stripe",
      "request": "launch",
      "command": "listen",
      "forwardTo": "https://localhost:3000",
      "forwardConnectTo": "https://localhost:3000",
      "events": ["payment_intent.succeeded", "payment_intent.canceled"],
      "skipVerify": true
    },
    {
      "type": "node",
      "request": "launch",
      "name": "Node: Launch Program",
      "program": "${workspaceFolder}/examples/standalone.js",
      "skipFiles": ["<node_internals>/**"]
    }
  ],
  "compounds": [
    {
      "name": "Launch: Stripe + API",
      "configurations": ["Node: Launch Program", "Stripe: Webhooks listen"]
    }
  ]
}

リアルタイムで API ログリクエストをモニタリングする

Start streaming API logs (API ログのストリーミングを開始) ボタンを使用すると、アカウントのメンバーが作成した API リクエストのログをリアルタイムでストリーミングできます。Recent logs (最近のログ) の下のログエントリーをクリックすると、ログの詳細がエディター内に直接表示されます。そこで、リクエスト ID にカーソルを合わせると、ダッシュボードにログを表示することができます。

注意

この拡張機能では、テスト環境で行われたリクエストのログのみが配信されます。

一般的な Stripe シナリオのコードスニペット

一般的なシナリオ (Checkout セッションを作成してユーザーをブラウザーにリダイレクトするなど) や基本的な API リクエストに対応したコードスニペットを迅速に生成できます。スニペットを生成した後は、タブでスニペットを移動して値を入力できます。

ソースコードが API キーを公開していないことを確認する

構築済みの Stripe linter は、ソースコード内にある API キーをチェックし、API キーが安全に公開されていない場合、API キーを問題としてマークします。

注

linter は、キーが安全に使用されていない場合、テスト環境では警告として、本番環境ではエラーとして扱います。

Stripe API リファレンスにアクセスする

リソースメソッドにカーソルを合わせると、Stripe API リファレンスへのリンクが表示されます。これは、API リクエストのパラメーターや API レスポンスの構造を識別するときに役立ちます。

Stripe ダッシュボードにアクセスする

QUICK LINKS (クイックリンク) セクションには、ダッシュボードにすばやく移動するためのリンクが含まれ、API キー、Webhook、その他のリソースを管理することができます。

設定

VS Code の設定では次を設定できます。

設定名	説明
`stripe.cliInstallPath`	Stripe CLI 実行可能ファイルの絶対インストールパスを指定します。デフォルトは、Stripe CLI のデフォルトのインストールパスです。
`stripe.projectName`	Stripe CLI 設定の読み取り元となるプロジェクト名を指定します。個々のプロジェクトに固有の設定を定義することも、デフォルトでグローバル設定を使用することもできます。詳細については、Stripe CLI リファレンスを参照してください。デフォルトは `default` です。
`stripe.telemetry.enabled`	Stripe テレメトリを有効にするかどうかを指定します (有効にした場合でも、全体的な `telemetry.enableTelemetry` 設定に従います)。デフォルトは `true` です。

コマンド

拡張機能は、コマンドパレットを介して機能にアクセスするためのさまざまなコマンドをサポートします。サポートされているコマンドのリストを表示するには、コマンドパレットを開いて Stripe と入力します。

寄付

Stripe VS Code は、MIT ライセンスに基づくオープンソースプロジェクトです。よろしければプロジェクトへの寄付をお願いいたします。プロジェクトに寄付する方法の詳細については、GitHub の vscode-stripe プロジェクトを確認してください。

フィードバック

プロジェクトの issue tracker (課題追跡) から、お気軽にフィードバックや機能リクエストを送信してください。