Jak wysyłać e-maile o nieudanej płatności

Czas czytania: 4 minuty | Poziom trudności: Początkujący

Przegląd

WP Simple Pay może wysyłać dwa e-maile, gdy Stripe zgłosi nieudaną płatność:

• Powiadomienie o nieudanej płatności trafia do Ciebie, administratora strony. Jest ono domyślnie włączone.
• Potwierdzenie nieudanej płatności trafia do klienta. Informuje go, że płatność nie mogła zostać przetworzona, podaje powód i prosi o sprawdzenie danych i ponowną próbę. Jest ono domyślnie wyłączone, więc to Ty decydujesz, czy klienci je otrzymają.

Oba e-maile są wysyłane w przypadku nieudanych płatności jednorazowych i nieudanych odnowień subskrypcji. Odrzucona karta, wygasła karta w pliku lub odnowienie, które wyczerpało próby ponowienia, nie pozostaną już niezauważone, dopóki nie sprawdzisz Stripe.

Wymagania wstępne

• WP Simple Pay Pro (dowolna płatna licencja).
• Webhooks skonfigurowane dla Twojego konta Stripe. Oba e-maile są wysyłane, gdy Stripe dostarczy zdarzenie charge.failed do Twojej strony. Zobacz Webhooks.
• Formularz płatności utworzony za pomocą WP Simple Pay. Nieudane obciążenia, które nie pochodzą z formularza WP Simple Pay, nie wysyłają tych e-maili.

Krok 1: Skonfiguruj powiadomienie administratora

1. Przejdź do WP Simple Pay → Ustawienia → E-maile.
2. W menu rozwijanym Wybierz e-mail do skonfigurowania… wybierz Powiadomienie o nieudanej płatności i kliknij Konfiguruj.
3. Pozostaw zaznaczone Wyślij e-mail z powiadomieniem do administratora strony, gdy płatność się nie powiedzie.
4. W polu Wyślij do wprowadź adres, który powinien otrzymać alert. Domyślnie jest to adres e-mail administratora strony. Oddziel wiele adresów przecinkami.
5. Edytuj Temat i Wiadomość, jeśli chcesz, a następnie kliknij Zapisz zmiany.

Domyślny temat to Płatność nieudana na {site name}. Domyślna wiadomość zawiera adres e-mail klienta, kwotę, tytuł formularza, powód błędu i kod błędu.

Krok 2: Włącz potwierdzenie dla klienta (opcjonalnie)

1. Przejdź do WP Simple Pay → Ustawienia → E-maile.
2. Wybierz Potwierdzenie nieudanej płatności i kliknij Konfiguruj.
3. Zaznacz Wyślij e-mail z potwierdzeniem do klienta, gdy płatność się nie powiedzie.
4. Edytuj Temat i Wiadomość, jeśli chcesz, a następnie kliknij Zapisz zmiany.

E-mail jest zawsze wysyłany na adres e-mail klienta, więc pole Wyślij do nie może być zmienione. Domyślny temat to Twoja płatność nie mogła zostać przetworzona.

Inteligentne tagi dotyczące błędów

Oba e-maile obsługują zwykłe inteligentne tagi, takie jak {customer-email}, {total-amount} i {form-title}, a także dwa opisujące błąd:

Inteligentny tag	Przykład	Opis
{failure-reason}	Twoja karta została odrzucona.	Dlaczego płatność się nie powiodła.
{failure-code}	card_declined	Kod błędu Stripe.

W e-mailu do klienta, {failure-reason} wyświetla tylko komunikat przeznaczony dla klientów. Nigdy nie pokazuje wewnętrznych notatek Stripe dla sprzedawcy. Jeśli Stripe nie poda powodu, e-mail do klienta będzie zawierał komunikat „Nie udało się przetworzyć Twojej płatności”, a e-mail do administratora „Nieznany”.

Limity wysyłania

Aby zapobiec zalewaniu skrzynki odbiorczej atakami testującymi karty lub wykorzystywaniu Twojej witryny do wysyłania wiadomości do nieznajomych, każdy e-mail jest wysyłany maksymalnie 10 razy na formularz na godzinę. Błędy przekraczające ten limit są nadal rejestrowane w Stripe, ale żaden e-mail nie zostanie wysłany, dopóki nie minie godzina.

Deweloperzy mogą zmienić limit i okno czasowe za pomocą następujących filtrów:

• simpay_payment_failure_notification_email_rate_limit i simpay_payment_failure_confirmation_email_rate_limit ustawiają liczbę e-maili (domyślnie 10, 0 wyłącza limit).
• simpay_payment_failure_notification_email_rate_limit_window i simpay_payment_failure_confirmation_email_rate_limit_window ustawiają okno w sekundach (domyślnie jedna godzina).

Każdy filtr otrzymuje bieżącą wartość i identyfikator formularza płatności. Zobacz Dodawanie niestandardowego kodu, aby dowiedzieć się, jak bezpiecznie dodać filtr.

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

Często zadawane pytania

Czy klient otrzyma e-mail, gdy jego karta zostanie odrzucona w formularzu płatności?

Tak, jeśli włączysz Potwierdzenie niepowodzenia płatności. Stripe raportuje każdą nieudaną transakcję, w tym odrzucenie, które klient widzi od razu w formularzu. Jeśli chcesz, aby klienci byli informowani tylko o błędach, które występują, gdy nie ma ich na stronie, takich jak odnowienia subskrypcji, wyłącz e-mail do klienta i obsługuj odnowienia za pomocą własnych e-maili o nieudanych płatnościach Stripe.

Dlaczego nie otrzymałem e-maila o błędzie?

Sprawdź, czy webhooki są skonfigurowane i czy Stripe pokazuje zdarzenie charge.failed jako dostarczone do Twojej witryny. Następnie sprawdź, czy formularz nie osiągnął limitu 10 e-maili na godzinę. Jeśli żadne z powyższych nie dotyczy, zobacz E-maile z potwierdzeniami i/lub powiadomienia nie są wysyłane.

Czy te e-maile są dostępne w WP Simple Pay Lite?

Nie. E-maile o niepowodzeniu płatności są częścią WP Simple Pay Pro i są dostępne na wszystkich płatnych licencjach.

Co dalej?

• Referencje typów e-maili – Każdy e-mail, który WP Simple Pay może wysłać
• Używanie tagów inteligentnych dla stron potwierdzeń i e-maili – Wszystkie dostępne tagi inteligentne
• Webhooks – Upewnij się, że Stripe może uzyskać dostęp do Twojej witryny