Come configurare un setup avanzato di webhook Stripe

Questo documento contiene opzioni di configurazione avanzate non necessarie per la maggior parte dei siti.
Consulta la nostra documentazione standard sui webhook 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.

Se un Webhook viene perso

Un webhook che non arriva mai non è più permanente. Una volta all'ora WP Simple Pay controlla Stripe per i record che potrebbe aver perso e li allinea: checkout completati mentre il cliente non è mai tornato sul tuo sito, pagamenti riusciti o annullati in seguito e rimborsi o chargeback applicati direttamente dalla Dashboard di Stripe. Un pagamento che prima era un segnaposto in sospeso si risolve da solo.

Dovresti comunque configurare correttamente i webhook, poiché il controllo orario viene eseguito dopo l'evento e qualsiasi cosa che dipenda da una risposta immediata (email, piani rateali) necessita dell'evento live. Ma non devi cercare manualmente un singolo evento perso. Puoi confermare il risultato su Moduli di Pagamento > Transazioni — vedi Come Utilizzare la Pagina delle Transazioni.

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**
• carica.rimborsato
• 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

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.

charge.dispute.created

• Contrassegna il pagamento corrispondente come contestato mentre un chargeback è in corso, in modo che venga visualizzato nella vista Contestati nella pagina Transazioni. Richiede WP Simple Pay Pro.
• Espone l'azione simpay_webhook_charge_dispute_created per ulteriori elaborazioni quando viene aperto un chargeback.

charge.dispute.closed

• Ripristina lo stato precedente del pagamento quando la contestazione si chiude a tuo favore, sia che sia stata vinta, chiusa come indagine o prevenuta da Stripe. Un pagamento parzialmente rimborsato torna a parzialmente rimborsato anziché semplicemente riuscito. Una contestazione persa rimane contestata, poiché i fondi sono stati effettivamente prelevati. Richiede WP Simple Pay Pro.
• Espone l'azione simpay_webhook_charge_dispute_closed per ulteriori elaborazioni quando un chargeback si chiude.