イベントをリッスンする
インストール済みのユーザーのアカウントでイベントをリッスンする
アプリでは Webhook を使用して、ユーザーのアカウントで発生しているイベントに関するアラートを受け取ることができます。これは、アプリで何らかの変更があった場合に、アプリの情報を同期したり、アプリ内でアクションをトリガーしたりするのに役立ちます。
始める
- アプリのバックエンドで Webhook イベントを処理します。
- Stripe ダッシュボードで Webhook エンドポイントを登録し、連結アカウントでイベントをリッスンするを選択します。
- Stripe ダッシュボードでテスト環境の Webhook エンドポイントを登録します。アプリは本番環境とテスト環境の両方でインストールできます。テスト環境のイベントを処理するために、テスト環境のエンドポイントも設定しておくことをお勧めします。Recommended
- 必要な権限ごとに
stripe apps grant permission
を実行して、アプリに必要な権限を追加します。以下を置き換えます。Command Linestripe apps grant permission "PERMISSION_NAME" "EXPLANATION"
PERMISSION_
には権限名が表示されます。NAME EXPLANATION
には、アクセス有効化についての説明が表示されます。この説明は、アプリのインストール時にユーザーに表示されます。
event_
権限と、処理する特定のイベントに関連付けられた権限を追加する必要があります。イベントにどの権限が必要かについての情報は、イベントの権限でご確認ください。
たとえば、payment_
イベントと setup_
イベントを処理する場合は、次のコマンドを実行します。
stripe apps grant permission "event_read" "Read webhook event data" stripe apps grant permission "checkout_session_read" "Read Checkout Session data in webhook events" stripe apps grant permission "payment_intent_read" "Read PaymentIntent data in webhook events" stripe apps grant permission "setup_intent_read" "Read SetupIntent data in webhook events"
これらのコマンドを実行した後のアプリのマニフェストファイルは次のようになります。
{ "id": "com.example.app", "version": "1.2.3", "name": "Example App", "icon": "./example_icon_32.png", "permissions": [ { "permission": "event_read", "purpose": "Read webhook event data" } { "permission": "checkout_session_read", "purpose": "Read Checkout Session data in webhook events" } { "permission": "payment_intent_read", "purpose": "Read PaymentIntent data in webhook events" } { "permission": "setup_intent_read", "purpose": "Read SetupIntent data in webhook events" } ], }
アカウントでイベントをリッスンする
アカウントのユーザーのみに提供されている非公開アプリのイベントを受け取るには、以下のようにします。
- アプリのバックエンドで Webhook イベントを処理します。
- Stripe ダッシュボードで Webhook エンドポイントを登録します。
アプリに関するイベント通知の受信
Webhook を使用して Stripe アプリのイベント (ユーザーによるインストールやアンインストールなど) をリッスンし、次のリアクションをシステムのバックエンドで自動的にトリガーできるようにします。
- ユーザーアカウントの作成
- 権限の更新
- ユーザーアカウントの無効化およびデータの削除
Stripe Apps では、Stripe がサポートするイベントタイプに加えて次のイベントもサポートされます。
加盟店のアクション | 結果としてアプリのバックエンドに送信される Webhook イベント |
---|---|
アプリを接続またはインストールする | account.application.authorized |
アプリを接続解除またはアンインストールする | account.application.deauthorized |
Webhook をローカルでテストする
次を対象に、Webhook をローカルでテストできます。
- 貴社のアカウントのすべてのユーザーのみが入手でき、自身のアカウントのイベントをリッスンするアプリ
- Stripe App Marketplace で入手でき、貴社のアプリをインストールしたアカウントのイベントをリッスンするアプリ
Webhook をローカルでテストするには次のようにします。
次のようにアカウントを認証します。
Command Linestripe login
端末ウィンドウを 2 つ開きます。
ある端末ウィンドウで、イベント転送を設定します。
別の端末ウィンドウで、イベントをトリガーして Webhook との連携をテストします。
詳細については、Webhook エンドポイントのテストに関する Stripe ドキュメントをご覧ください。