高度なStripe Webhook設定の構成方法

このドキュメントには、ほとんどのサイトで必要とされない高度なセットアップオプションが含まれています。
基本的なセットアップについては、 標準のWebhookドキュメントを参照してください。

Webhookを使用すると、StripeはWordPressサイトにメッセージを送信できます。WP Simple Payの一部の機能（メールの送信、分割払いの作成、顧客によるサブスクリプションの支払い詳細の更新、およびAffiliateWPとの連携の使用）には、Webhookの設定が必要です。

Webhookが見逃された場合

届かないWebhookはもはや永続的ではありません。WP Simple Payは1時間ごとにStripeをチェックし、見逃した可能性のあるレコード（顧客がサイトに戻らなかった間に完了したチェックアウト、成功または後でキャンセルされた支払い、Stripeダッシュボードから直接適用された返金またはチャージバック）を取り込みます。かつて保留中のプレースホルダーとして存在していた支払いは、自己解決します。

それでもWebhookは適切に設定する必要があります。なぜなら、時間ごとのチェックは事後に行われ、即時応答（メール、分割払いプラン）に依存するものはすべてライブイベントを必要とするからです。しかし、単一のドロップイベントを手動で検索する必要はありません。「支払いフォーム > 取引」で結果を確認できます。詳細は取引ページの使い方法を参照してください。

Webhookエンドポイントの追加

適切なWebhookエンドポイントを追加するには、Stripeダッシュボードの開発者 → Webhooksに移動します。

エンドポイントを追加をクリックし、次にWP Simple Pay → 設定 → Stripe → WebhooksにあるURLを追加します。

次に、+イベントを選択というラベルのボタンをクリックして、リッスンする特定のイベントを追加する必要があります。その後、以下の各イベントをコピーして、送信するイベントを選択 → イベントを検索の検索ボックスに貼り付けることができます。

各用語を検索した後、チェックボックスをクリックして追加し、追加の用語を検索します。以下のすべてのイベントをチェックするまで、イベントを追加をクリックしないでください。

• **charge.failed**
• 請求.返金済み
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• payment_intent.processing
• payment_intent.succeeded
• customer.subscription.deleted
• customer.subscription.updated
• charge.dispute.created
• charge.dispute.closed

これらの各イベントの機能に関する詳細は、このドキュメントの最後に示されています。

イベントの追加が完了したら、エンドポイントを追加をクリックしてプロセスを完了します。エンドポイントを追加すると、新しいURLがWebhooks設定に表示されるはずです。

Webhook署名シークレットの設定

Stripeは、エンドポイントに送信するWebhookイベントに署名してセキュリティを強化できます。強く推奨します。

これを行うには、 ダッシュボードのWebhook設定からエンドポイントのシークレットを取得します。シークレットを取得したいエンドポイントを選択し、表示 ボタンをクリックします。

次に、Stripeダッシュボードから署名シークレットをコピーし、WP管理画面のStripe設定タブに戻って、現在の支払いモードのエンドポイントシークレットテキストボックスに貼り付けます。

これでWebhookの設定が完了し、安全になりました。

現在、WP Simple Payは以下のイベントを利用しています：

イベントタイプの説明

invoice.payment_succeeded

• 分割払いのインクリメントに使用され、サブスクリプションの「支払い確認」および「支払い通知」メールを送信します。
• サブスクリプションが正常に完了した後、さらに処理を行うためにsimpay_webhook_subscription_createdアクションを公開します。

**payment_intent.succeeded
**

• 都度払いの「支払い確認」および「支払い通知」メールを送信します。
• 支払いが正常に完了した後、さらに処理を行うためにsimpay_webhook_payment_intent_succeededアクションを公開します。

**charge.succeeded
**

• ACHデビットを使用した都度払いの「支払い確認」および「支払い通知」メールを送信します。
• 支払いが正常に完了した後、さらに処理を行うためにsimpay_webhook_charge_succeededアクションを公開します。

invoice.upcoming

• 支払い方法の更新のための「次回の請求書」メールリマインダーを送信します。詳細はこちら

checkout.session.completed

• 生成された放棄されたStripe Checkoutレコードを削除するために使用されます。
• 必要に応じて、処理をさらに行うためにsimpay_webhook_checkout_session_completedアクションを公開します。

plan.updated

• サブスクリプションオプションの設定時に、サブスクリプションプランのリストを最新の状態に保つために使用されます。

**charge.failed**

• チャージが失敗した後、さらに処理を行うためにsimpay_webhook_charge_failedアクションを公開します。

charge.dispute.created

• チャージバックが継続している間、一致する支払いを紛争中としてマークするため、取引ページの「紛争中」ビューに表示されます。WP Simple Pay Proが必要です。
• チャージバックが開かれたときに、さらに処理するためにsimpay_webhook_charge_dispute_createdアクションを公開します。

charge.dispute.closed

• 紛争が有利に終了した場合（勝訴、問い合わせとしてクローズ、またはStripeによって防止された場合）、支払いの以前のステータスを復元します。一部返金された支払いは、単に成功したのではなく、一部返金された状態に戻ります。負けた紛争は、資金が実際に引き落とされたため、紛争中のままです。WP Simple Pay Proが必要です。
• チャージバックがクローズされたときに、さらに処理するためにsimpay_webhook_charge_dispute_closedアクションを公開します。