Come configurare un setup avanzato di webhook Stripe

Questo documento contiene opzioni di configurazione avanzate non necessarie per la maggior parte dei siti.
_{Vedere la nostra documentazione sui webhook standard per la configurazione di base.}

I webhook consentono a Stripe di inviare messaggi al tuo sito WordPress. La configurazione dei webhook è necessaria per alcune funzionalità di WP Simple Pay, come l'invio di email, la creazione di piani rateali, consentire ai clienti di aggiornare i dettagli di pagamento della loro sottoscrizione e l'utilizzo della sua integrazione con AffiliateWP.

Aggiunta dell'endpoint webhook

Per aggiungere gli endpoint webhook appropriati, nella tua Dashboard Stripe, vai su Sviluppatori → Webhook.

Fai clic su Aggiungi endpoint, quindi aggiungi l'URL trovato in WP Simple Pay → Impostazioni → Stripe → Webhook.

Ora dovrai aggiungere gli eventi specifici da ascoltare facendo clic sul pulsante etichettato +Seleziona eventi. Dopo averlo fatto, puoi copiare e incollare ciascun evento elencato di seguito nella casella di ricerca Seleziona eventi da inviare → Cerca eventi.

Dopo aver cercato ogni termine, fai clic sulla casella di controllo per aggiungerlo e cerca termini aggiuntivi. Non fare clic su Aggiungi eventi finché non hai selezionato tutti gli eventi elencati di seguito:

• 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

I dettagli sulla funzionalità di ciascuno di questi eventi sono mostrati in fondo a questo documento.

Al termine dell'aggiunta degli eventi, fai clic su Aggiungi endpoint per completare il processo. Dopo aver aggiunto l'endpoint, dovresti vedere il nuovo URL elencato nelle impostazioni dei webhook.

Configurazione del segreto di firma del webhook

Stripe può firmare gli eventi webhook che invia ai tuoi endpoint per una maggiore sicurezza, e raccomandiamo vivamente di impostare questa opzione.

Per farlo, recupera il segreto del tuo endpoint dalle impostazioni dei webhook della tua Dashboard. Seleziona un endpoint per il quale desideri ottenere il segreto, quindi fai clic sul pulsante Mostra.

Quindi copia il segreto di firma dalla Stripe Dashboard, torna alla scheda Configurazione Stripe nel tuo admin WP, quindi incollalo nella casella di testo Segreto endpoint per la modalità di pagamento corrente.

I tuoi webhook sono ora configurati e sicuri.

Attualmente, WP Simple Pay utilizza i seguenti eventi:

Descrizioni dei tipi di evento

invoice.payment_succeeded

• Utilizzato per incrementare i piani di rateizzazione e inviare le email “Conferma pagamento” e “Notifica pagamento” email per gli Abbonamenti.
• Espone l'azione simpay_webhook_subscription_created per ulteriori elaborazioni dopo una sottoscrizione riuscita.

payment_intent.succeeded

• Invia le email “Conferma pagamento” e “Notifica pagamento” email per i pagamenti una tantum.
• Espone l'azione simpay_webhook_payment_intent_succeeded per ulteriori elaborazioni dopo un pagamento riuscito

charge.succeeded

• Invia le email “Conferma pagamento” e “Notifica pagamento” email per i pagamenti una tantum tramite addebito diretto ACH.
• Espone l'azione simpay_webhook_charge_succeeded per ulteriori elaborazioni dopo un pagamento riuscito

invoice.upcoming

• Invia il promemoria via email “Fattura in arrivo” email per l'aggiornamento di un Metodo di pagamento. Scopri di più

checkout.session.completed

• Utilizzato per rimuovere i record generati di Stripe Checkout abbandonati.
• Espone l'azione simpay_webhook_checkout_session_completed per ulteriori elaborazioni, se necessario.

plan.updated

• Utilizzato per garantire che l'elenco dei Piani di Sottoscrizione sia aggiornato quando si configurano le Opzioni di Sottoscrizione.

charge.failed

• Espone l'azione simpay_webhook_charge_failed per ulteriori elaborazioni dopo che un addebito non è riuscito.