コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
AI に質問
アカウントを作成サインイン
導入方法
決済管理
売上管理
プラットフォームとマーケットプレイス
資金管理
開発者向けリソース
API & SDKヘルプ
概要
バージョン管理
変更ログ
API バージョンのアップグレード
SDK バージョンをアップグレードする
Essentials
SDK
API
テスト
Stripe CLI
サンプルプロジェクト
ツール
Stripe ダッシュボード
ワークベンチ
開発者ダッシュボード
Visual Studio Code をご利用の場合
Terraform
機能
ワークフロー
イベントの送信先
    イベントとの連携
    Amazon EventBridge
    Webhook エンドポイント
      Webhook ビルダー
      決済イベントの処理
      Webhook のバージョン管理
      シンイベントに移行する
      Webhook の署名確認エラーを解決
      未配信の Webhook イベントを処理
      回復不能な Webhook イベントを処理する
      イベント通知ハンドラーを使用して Webhook を管理
Stripe 健全性アラートファイルのアップロード
AI ソリューション
エージェントツールキット
モデルコンテキストプロトコルエージェントを使用した AI SaaS 請求ワークフローの構築
セキュリティとプライバシー
セキュリティ
Stripebot ウェブクローラー
Stripe を拡張する
Stripe Appsを構築する
Stripe アプリを使用する
パートナー
Partner Ecosystem
パートナー認定
アメリカ
日本語
ホーム開発者向けリソースEvent destinationsWebhook endpoint

イベント通知ハンドラーを使用して受信する Webhook を処理する公開プレビュー

公開プレビュー

イベント通知ハンドラーはパブリックプレビューで利用可能です。

この機能は、パブリックプレビューで EventBridge を使用するイベント宛先をサポートしていません。

各 SDK には、Stripe Webhook の解析と検証の仕組みをカプセル化した専門クラスを作成しています。イベント通知ハンドラーは、受信する Webhook の検証、解析、そしてビジネスロジックへのルーティングを行います。

この機能を使うには、処理したい各イベントタイプごとに関数を書く必要があります。これらの機能をハンドラーに登録すると、対応するイベント通知を受け取ったときに Stripe がそれらを呼び出します。

はじめに

イベント通知ハンドラーを使用するには、以下の SDK バージョン (またはそれ以上のバージョン) を使用する必要があります。

  • Java: v31.2.0-beta.1
  • Python: v14.2.0b1
  • Ruby: v18.2.0-beta.1
  • PHP: v19.2.0-beta.1
  • Go: v84.2.0-beta.1
  • Node: v20.2.0-beta.1
  • .NET: v50.2.0-beta.1

フォールバックコールバックを作成する

特定のイベントタイプに対して専用コールバックが登録されていないときに実行される関数を書いてください。EventNotification、StripeClient、イベントに関する追加情報を受け取ります。

この関数は、予期せぬイベントの受信事実を記録したり、予期せぬ状態の警告エラーをスローしたりします。また、SDK に型がないイベントを扱う場合は、この関数にビジネスロジックを追加することもできます。

Python
Java
Ruby
PHP
Go
Node
.NET
No results
def fallback_callback(notif: EventNotification, client: StripeClient, details: UnhandledNotificationDetails): print(f'Got an unhandled event of type {notif.type}!')

移行の一環として、すべての Webhook エンドポイントコードをこの関数に移行することを検討してください。その後、個々のイベントタイプをそれぞれの関数に移行できます。

ハンドラーを初期化する

Webhook エンドポイントで EventNotificationHandler を初期化し、フォールバックコールバックを渡します。StripeClient には、このステップを簡素化する便利なメソッドがあります。

Python
Java
Ruby
PHP
Go
Node
.NET
No results
client = StripeClient(api_key) handler = client.notification_handler(webhook_secret, fallback_callback)

コールバックを記述して登録する

次に、特定のイベントタイプを処理する関数を作成します。これは、2025 年 9 月にリリースされた Clover API バージョンでリリースされたイベントタイプを使用します。

コールバックは正しいクラスにイベント通知がキャストされて届きます。また、通知の context に紐づく StripeClient も提供されるため、アカウント ID を管理せずに追加の API コールを簡単に行えます。

Python
Java
Ruby
PHP
Go
Node
.NET
No results
# can be anywhere in your codebase @handler.on_v1_billing_meter_error_report_triggered def handle_meter_error( notif: V1BillingMeterErrorReportTriggeredEventNotification, client: StripeClient, ): event = notif.fetch_event() print(f"Err! No meter found: {event.data.developer_message_summary}")

コールバックは 0 件またはそれ以上登録できます。登録しない場合、すべてのイベントがフォールバックコールバックにルーティングされます。

イベントを処理する

POST の受信ボディをハンドラーに送信します。これにより、Webhook エンドポイントの元のコードの大部分が置き換えられます。

Python
Java
Ruby
PHP
Go
Node
.NET
No results
@app.route("/webhook", methods=["POST"]) def webhook(): webhook_body = request.data sig_header = request.headers.get("Stripe-Signature") try: handler.handle(webhook_body, sig_header) return jsonify(success=True), 200 except Exception as e: return jsonify(error=str(e)), 500

参照情報

  • Thin イベントの使用
  • Webhook エンドポイントで Stripe イベントを受信する
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM は llms.txt を参照してください。
  • Powered by Markdoc