Cum să configurați o configurare avansată a webhook-urilor Stripe

Acest document conține opțiuni avansate de configurare care nu sunt necesare pentru majoritatea site-urilor.
Consultați documentația noastră standard pentru webhook-uri pentru configurarea de bază.

Webhook-urile permit Stripe să trimită mesaje înapoi pe site-ul dvs. WordPress. Configurarea webhook-urilor este necesară pentru anumite funcționalități ale WP Simple Pay, cum ar fi trimiterea e-mailurilor, crearea planurilor de plată în rate, permiterea clienților să-și actualizeze detaliile de plată ale abonamentului și utilizarea integrării sale cu AffiliateWP.

Dacă un Webhook este ratat

Un webhook care nu ajunge niciodată nu mai este permanent. O dată pe oră WP Simple Pay verifică Stripe pentru înregistrările pe care le-ar fi putut rata și le aduce în linie: checkout-uri care s-au finalizat în timp ce clientul nu s-a mai întors pe site-ul dvs., plăți care au reușit sau au fost anulate ulterior și rambursări sau chargeback-uri aplicate direct din Stripe Dashboard. O plată care obișnuia să fie un placeholder în așteptare se rezolvă de la sine.

Ar trebui totuși să configurați corect webhooks, deoarece verificarea orară rulează după fapt și orice depinde de un răspuns imediat (emailuri, planuri de rate) are nevoie de evenimentul live. Dar nu trebuie să căutați manual un singur eveniment pierdut. Puteți confirma rezultatul pe Formulare de plată > Tranzacții — consultați Cum se utilizează pagina Tranzacții.

Adăugarea Punctului Final Webhook

Pentru a adăuga punctele finale de webhook corespunzătoare, în panoul de control Stripe, accesați Dezvoltatori → Webhooks.

Faceți clic pe Adăugați punct final, apoi adăugați URL-ul găsit în WP Simple Pay → Setări → Stripe → Webhooks.

Acum va trebui să adăugați evenimentele specifice la care să ascultați, făcând clic pe butonul etichetat +Selectați evenimente. După ce ați făcut acest lucru, puteți copia și lipi fiecare eveniment listat mai jos în caseta de căutare Selectați evenimente de trimis → Căutați evenimente.

După ce ați căutat fiecare termen, faceți clic pe caseta de selectare pentru a-l adăuga și căutați termeni suplimentari. Nu faceți clic pe Adăugați evenimente până când nu ați bifat toate evenimentele listate mai jos:

• **eșec.încărcare**
• încărcare.rambursat
• 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

Detalii despre funcționalitatea fiecăruia dintre aceste evenimente sunt prezentate în partea de jos a acestui document.

Când ați terminat de adăugat evenimente, faceți clic pe Adăugați punct final pentru a finaliza procesul. După ce adăugați punctul final, ar trebui să vedeți noul URL listat în setările webhook-urilor.

Configurarea secretului de semnare a webhook-ului

Stripe poate semna evenimentele webhook pe care le trimite către endpoint-urile dvs. pentru o securitate sporită și recomandăm cu tărie să configurați acest lucru.

Pentru a face acest lucru, preluați secretul punctului final din setările webhook-urilor din Dashboard. Selectați un punct final pentru care doriți să obțineți secretul, apoi faceți clic pe butonul Afișare.

Apoi copiați secretul de semnare din Stripe Dashboard, reveniți la fila Configurare Stripe din administratorul dvs. WP, apoi lipiți-l în caseta de text Secret Punct Final pentru modul de plată curent.

Webhook-urile dvs. sunt acum configurate și securizate.

În prezent, WP Simple Pay utilizează următoarele evenimente:

Descrierea tipurilor de evenimente

invoice.payment_succeeded

• Utilizat pentru a incrementa planurile de rate și pentru a trimite e-mailuri de „Confirmare plată” și „Notificare plată” emailuri pentru Abonamente.
• Expune acțiunea simpay_webhook_subscription_created pentru procesare suplimentară după un abonament reușit.

**payment_intent.succeeded
**

• Trimite e-mailurile de „Confirmare plată” și „Notificare plată” emailuri pentru plățile unice.
• Expune acțiunea simpay_webhook_payment_intent_succeeded pentru procesare suplimentară după o plată reușită

**charge.succeeded
**

• Trimite e-mailurile de „Confirmare plată” și „Notificare plată” emailuri pentru plățile unice prin ACH Debit.
• Expune acțiunea simpay_webhook_charge_succeeded pentru procesare suplimentară după o plată reușită

invoice.upcoming

• Trimite remindere prin e-mail „Factură în curs de apariție” email pentru actualizarea unei Metode de plată. Aflați mai multe

checkout.session.completed

• Utilizat pentru a elimina înregistrările Stripe Checkout abandonate generate.
• Expune acțiunea simpay_webhook_checkout_session_completed pentru procesare suplimentară, dacă este necesar.

plan.actualizat

• Utilizat pentru a asigura că lista Planurilor de Abonament este actualizată atunci când se configurează Opțiunile de Abonament.

**eșec.încărcare**

• Expune acțiunea simpay_webhook_charge_failed pentru procesare suplimentară după eșecul unei Taxe.

charge.dispute.created

• Marchează plata corespunzătoare ca fiind disputată în timp ce un chargeback este în vigoare, astfel încât să apară sub vizualizarea Disputate din pagina Tranzacții. Necesită WP Simple Pay Pro.
• Expune acțiunea simpay_webhook_charge_dispute_created pentru procesare suplimentară atunci când se deschide un chargeback.

charge.dispute.closed

• Restabilește starea anterioară a plății atunci când disputa se închide în favoarea dvs., fie că a fost câștigată, închisă ca o investigație sau prevenită de Stripe. O plată care a fost parțial rambursată revine la parțial rambursată în loc de pur reușită. O dispută pierdută rămâne disputată, deoarece fondurile au fost într-adevăr retrase. Necesită WP Simple Pay Pro.
• Expune acțiunea simpay_webhook_charge_dispute_closed pentru procesare suplimentară atunci când se închide un chargeback.