Cum să trimiți e-mailuri de eșec al plății

Timp de citire: 4 minute | Dificultate: Începător

Prezentare generală

WP Simple Pay poate trimite două emailuri atunci când Stripe raportează o plată eșuată:

• Notificarea de eșec al plății este trimisă dvs., administratorul site-ului. Este activată implicit.
• Confirmarea eșecului plății este trimisă clientului. Îi spune că plata nu a putut fi procesată, oferă motivul și îi cere să își verifice detaliile și să încerce din nou. Este dezactivată implicit, așa că dvs. decideți dacă clienții o primesc.

Ambele emailuri sunt trimise pentru plăți unice eșuate și pentru reînnoiri eșuate ale abonamentelor. Un card refuzat, un card expirat înregistrat sau o reînnoire care rămâne fără încercări nu mai trece neobservată până când verificați Stripe.

Cerințe preliminare

• WP Simple Pay Pro (orice licență plătită).
• Webhooks configurate pentru contul dvs. Stripe. Ambele emailuri sunt trimise atunci când Stripe livrează un eveniment charge.failed site-ului dvs. Vezi Webhooks.
• Un formular de plată creat cu WP Simple Pay. Taxele eșuate care nu provin de la un formular WP Simple Pay nu trimit aceste emailuri.

Pasul 1: Configurarea notificării administratorului

1. Accesați WP Simple Pay → Setări → E-mailuri.
2. În meniul derulant Selectați un email de configurat…, alegeți Notificare eșec plată și faceți clic pe Configurare.
3. Lăsați bifată opțiunea Trimite un email de notificare administratorului site-ului atunci când o plată eșuează.
4. În câmpul Trimite către, introduceți adresa care ar trebui să primească alerta. Implicit este adresa de email a administratorului site-ului. Separați mai multe adrese cu virgule.
5. Editați Subiectul și Mesajul dacă doriți, apoi faceți clic pe Salvare modificări.

Subiectul implicit este Plata a eșuat pe {nume site}. Mesajul implicit include adresa de email a clientului, suma, titlul formularului, motivul eșecului și codul eșecului.

Pasul 2: Activarea confirmării clientului (Opțional)

1. Accesați WP Simple Pay → Setări → E-mailuri.
2. Alegeți Confirmare eșec plată și faceți clic pe Configurare.
3. Bifați Trimite un email de confirmare clientului atunci când o plată eșuează.
4. Editați Subiectul și Mesajul dacă doriți, apoi faceți clic pe Salvare modificări.

Emailul este trimis întotdeauna la adresa de email a clientului, deci câmpul Trimite către nu poate fi modificat. Subiectul implicit este Plata dvs. nu a putut fi procesată.

Etichete inteligente de eșec

Ambele emailuri suportă etichetele inteligente obișnuite, cum ar fi {customer-email}, {total-amount} și {form-title}, plus două care descriu eșecul:

Etichetă inteligentă	Exemplu	Descriere
{failure-reason}	Cardul dvs. a fost refuzat.	De ce a eșuat plata.
{failure-code}	card_declined	Codul de eșec Stripe.

În emailul clientului, {failure-reason} afișează doar mesajul destinat clienților. Nu afișează niciodată notele interne ale Stripe pentru comerciant. Dacă Stripe nu oferă un motiv, emailul clientului spune „Plata dvs. nu a putut fi procesată.”, iar emailul administratorului spune „Necunoscut”.

Limite de trimitere

Pentru a opri un atac de testare a cardurilor de a vă inunda inboxul sau de a vă folosi site-ul pentru a trimite emailuri unor necunoscuți, fiecare email este trimis de cel mult 10 ori pe formular pe oră. Eșecurile peste această limită sunt în continuare înregistrate în Stripe, dar niciun email nu este trimis până când nu a trecut ora.

Dezvoltatorii pot modifica limita și fereastra de timp cu aceste filtre:

• simpay_payment_failure_notification_email_rate_limit și simpay_payment_failure_confirmation_email_rate_limit setează numărul de emailuri (implicit 10, 0 dezactivează limita).
• simpay_payment_failure_notification_email_rate_limit_window și simpay_payment_failure_confirmation_email_rate_limit_window setează fereastra în secunde (implicit o oră).

Fiecare filtru primește valoarea curentă și ID-ul formularului de plată. Vezi Adăugarea de cod personalizat pentru cum să adăugați un filtru în siguranță.

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

Întrebări Frecvente

Va primi clientul un email când cardul îi este refuzat pe formularul de plată?

Da, dacă activați Confirmarea eșecului plății. Stripe raportează fiecare eșec de încărcare, inclusiv un refuz pe care clientul îl vede imediat pe formular. Dacă doriți ca clienții să afle doar despre eșecurile care apar atunci când nu sunt pe pagină, cum ar fi reînnoirile abonamentelor, lăsați emailul clientului dezactivat și gestionați reînnoirile cu propriile emailuri pentru plăți eșuate ale Stripe.

De ce nu am primit un email de eșec?

Verificați dacă webhook-urile sunt configurate și dacă Stripe afișează evenimentul charge.failed ca fiind livrat pe site-ul dvs. Apoi verificați dacă formularul nu a atins limita de 10 emailuri pe oră. Dacă niciuna dintre acestea nu se aplică, consultați Emailurile de chitanță și/sau notificările nu sunt trimise.

Sunt aceste emailuri disponibile în WP Simple Pay Lite?

Nu. Emailurile de eșec al plății fac parte din WP Simple Pay Pro și sunt disponibile pe toate licențele plătite.

Ce urmează?

• Referință tipuri de email – Fiecare email pe care WP Simple Pay îl poate trimite
• Utilizarea etichetelor inteligente pentru paginile de confirmare și emailuri – Toate etichetele inteligente disponibile
• Webhook-uri – Asigurați-vă că Stripe poate ajunge pe site-ul dvs.