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.

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:

• charge.failed
• charge.refunded
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• payment_intent.processing
• payment_intent.succeeded
• customer.subscription.deleted
• customer.subscription.updated

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.updated

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

charge.failed

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