支払い失敗メールの送信方法

読む時間: 4分 | 難易度: 初級

概要

WP Simple Payは、Stripeが支払い失敗を報告した場合に2つのメールを送信できます。

• 支払い失敗通知は、サイト管理者のあなたに送信されます。デフォルトでオンになっています。
• 支払い失敗確認は顧客に送信されます。支払い処理ができなかったこと、その理由、詳細を確認して再試行するように依頼することを伝えます。デフォルトではオフになっているため、顧客が受信するかどうかはあなたが決定します。

どちらのメールも、一時的な支払いの失敗とサブスクリプションの更新の失敗の両方に送信されます。期限切れのカード、保存済みのカードの期限切れ、またはリトライ回数がなくなった更新が、Stripeを確認するまで見過ごされることはもうありません。

前提条件

• WP Simple Pay Pro（有料ライセンス）。
• Stripeアカウントに設定されたWebhooks。Stripeがサイトにcharge.failedイベントを配信すると、両方のメールが送信されます。Webhooksを参照してください。
• WP Simple Payで作成された支払いフォーム。WP Simple Payフォームからではない失敗した請求は、これらのメールを送信しません。

ステップ1：管理者通知の設定

1. WP Simple Pay → 設定 → メールに移動します。
2. 設定するメールを選択…ドロップダウンで、支払い失敗通知を選択し、設定をクリックします。
3. 支払いが失敗した場合にサイト管理者に通知メールを送信するにチェックを入れたままにします。
4. 送信先に、アラートを受信するアドレスを入力します。デフォルトはサイト管理者のメールアドレスです。複数のアドレスはカンマで区切ります。
5. 必要に応じて件名とメッセージを編集し、変更を保存をクリックします。

デフォルトの件名は{site name}での支払いが失敗しましたです。デフォルトのメッセージには、顧客のメールアドレス、金額、フォームのタイトル、失敗理由、失敗コードが含まれます。

ステップ2：顧客確認をオンにする（任意）

1. WP Simple Pay → 設定 → メールに移動します。
2. 支払い失敗確認を選択し、設定をクリックします。
3. 支払いが失敗した場合に顧客に確認メールを送信するにチェックを入れます。
4. 必要に応じて件名とメッセージを編集し、変更を保存をクリックします。

このメールは常に顧客のメールアドレスに送信されるため、送信先フィールドは変更できません。デフォルトの件名はお支払いが処理できませんでしたです。

失敗スマートタグ

両方のメールは、{customer-email}、{total-amount}、{form-title}などの通常のスマートタグに加えて、失敗を説明する2つのタグをサポートしています。

スマートタグ	例	説明
{failure-reason}	お客様のカードは却下されました。	支払いが失敗した理由。
{failure-code}	card_declined	Stripeの失敗コード。

顧客向けメールでは、{failure-reason} には顧客向けのメッセージのみが表示されます。Stripe の内部メモがマーチャントに表示されることはありません。Stripe が理由を提供しない場合、顧客向けメールには「お支払いが処理できませんでした。」と表示され、管理者向けメールには「不明」と表示されます。

送信制限

カードテスト攻撃によって受信トレイが溢れたり、サイトを使用して見知らぬ人にメールを送信したりするのを防ぐため、各メールは 1 フォームあたり 1 時間あたり 10 回まで送信されます。この制限を超えた失敗は Stripe に記録されますが、1 時間が経過するまでメールは送信されません。

開発者はこれらのフィルターを使用して、制限と時間枠を変更できます。

• simpay_payment_failure_notification_email_rate_limit および simpay_payment_failure_confirmation_email_rate_limit は、メールの数（デフォルト 10、0 は制限をオフにします）を設定します。
• simpay_payment_failure_notification_email_rate_limit_window および simpay_payment_failure_confirmation_email_rate_limit_window は、ウィンドウを秒単位で設定します（デフォルトは 1 時間）。

各フィルターは現在の値と支払いフォーム ID を受け取ります。フィルターを安全に追加する方法については、カスタムコードの追加を参照してください。

// Allow up to 25 admin failure notifications per form per hour.
add_filter( 'simpay_payment_failure_notification_email_rate_limit', function() {
	return 25;
} );

よくある質問

支払いフォームでカードが拒否された場合、顧客にメールが届きますか？

はい、支払い失敗確認をオンにしている場合です。Stripe は、顧客がすぐにフォームで確認する拒否を含む、すべての失敗した請求を報告します。ページ上にいないときに発生する失敗についてのみ顧客に通知したい場合（サブスクリプションの更新など）、顧客向けメールをオフにし、Stripe 自体の失敗した支払いメールで更新を処理してください。

失敗メールが届かなかったのはなぜですか？

Webhook が設定されており、Stripe が charge.failed イベントをサイトに配信済みとして表示していることを確認してください。次に、フォームが 1 時間あたり 10 件のメール制限に達していないことを確認してください。どちらも当てはまらない場合は、メールレシートおよび/または通知が送信されないを参照してください。

これらのメールは WP Simple Pay Lite で利用できますか？

いいえ。支払い失敗メールは WP Simple Pay Pro の一部であり、すべての有料ライセンスで利用できます。

次にやること

• メールの種類リファレンス – WP Simple Pay が送信できるすべてのメール
• 確認ページおよびメールでのスマートタグの使用 – 利用可能なすべてのスマートタグ
• Webhook – Stripe がサイトに到達できることを確認してください