Skip to main content

Introduzione

L’integrazione n8n avvia un workflow n8n ogni volta che si verifica un evento di pagamento, così puoi collegare Dodo Payments a qualsiasi app con cui n8n si integra. I workflow possono inviare email, aggiornare fogli di calcolo, creare attività, scrivere nei database e molto altro.
Questa integrazione richiede l’URL del webhook da un nodo Webhook nel tuo workflow n8n.

Iniziare

1

Open the Webhook Section

Nel dashboard di Dodo Payments, vai a Developer → Webhooks e fai clic su Add endpoint.
Finestra di dialogo per aggiungere un endpoint con n8n selezionato nel menu a discesa Integration
2

Select n8n

Nell’elenco Integration, seleziona n8n.
3

Create Webhook in n8n

In n8n, crea un workflow e aggiungi un nodo Webhook come trigger. Imposta HTTP Method su POST, quindi copia la Production URL. L’URL di test riceve eventi solo mentre n8n è in ascolto di un evento di test.
4

Paste Webhook URL

Incolla l’URL di produzione di n8n nel campo Endpoint URL.
5

Configure Transformation

Modifica il codice in Transformation code per adattare i dati al tuo workflow n8n. Parti dagli esempi riportati di seguito.
6

Test & Create

In Test this code, esegui la trasformazione su un payload di esempio, quindi fai clic su Create endpoint.
7

Publish the Workflow

In n8n, pubblica il tuo workflow. n8n registra l’URL del webhook di produzione solo quando il workflow è pubblicato.
8

Done

Gli eventi di pagamento ora attivano i tuoi workflow n8n.

Esempi di Codice di Trasformazione

Ogni esempio appiattisce un evento Dodo Payments in un piccolo oggetto JSON che i nodi n8n possono leggere direttamente.

Payload Webhook di base

Questo esempio invia l’importo del pagamento, la valuta, il cliente e il metodo di pagamento quando un pagamento va a buon fine.
basic_webhook.js

Gestore degli eventi di subscription

Questo esempio invia un evento subscription_started o subscription_cancelled, così un workflow può diramarsi in base a event_type.
subscription_webhook.js

Gestore degli avvisi sulle dispute

Questo esempio invia ogni evento dispute.* e imposta urgent su true quando si apre una disputa.
dispute_webhook.js

Casi d’uso più comuni di N8N

Questi sono workflow comuni che i merchant creano sugli eventi di Dodo Payments.
  • Inviare email Gmail o Outlook per le conferme di pagamento.
  • Creare sequenze email in Mailchimp o ConvertKit.
  • Inviare notifiche Slack o Discord tramite webhook.
  • Creare record in Google Sheets.
  • Inviare messaggi Telegram o WhatsApp.
  • Aggiungere contatti a HubSpot o Salesforce.
  • Creare trattative in Pipedrive o Close.
  • Aggiornare i record dei clienti in Airtable.
  • Registrare attività in Monday.com.
  • Sincronizzare i dati con database PostgreSQL o MySQL.
  • Creare attività in Asana o Trello.
  • Aggiungere elementi da fare in Notion.
  • Creare eventi in Google Calendar.
  • Inviare notifiche SMS tramite Twilio.
  • Creare issue GitHub per le dispute.
  • Trasformare e arricchire i dati dei pagamenti.
  • Archiviare gli eventi in database come PostgreSQL o MongoDB.
  • Aggregare metriche e analisi.
  • Generare report ed esportazioni.
  • Attivare workflow con più passaggi.

Suggerimenti

  • Mantieni semplice la struttura del payload, così i nodi n8n possono analizzarlo.
  • Usa gli stessi nomi dei campi per tutti gli eventi.
  • Includi i timestamp per la gestione delle tempistiche e della programmazione dei workflow.
  • Testa il workflow con dati di esempio prima di pubblicarlo.
  • Usa il nodo IF per la logica condizionale e l’instradamento.
  • Usa il nodo Code per trasformazioni personalizzate dei dati.
  • Usa il nodo Switch per instradare ogni tipo di evento verso il proprio percorso.
  • Configura un workflow di errore in n8n per intercettare le esecuzioni non riuscite.

Risoluzione dei problemi

  • Verifica che l’endpoint utilizzi l’URL di produzione di n8n e che n8n sia raggiungibile da Internet.
  • Verifica che il workflow sia pubblicato in n8n.
  • Verifica che HTTP Method del nodo Webhook sia POST.
  • Controlla le richieste in arrivo nella scheda Executions del workflow.
  • Verifica che le impostazioni del firewall e della rete consentano i webhook in ingresso.
  • Se il nodo Webhook richiede l’autenticazione, aggiungi l’header corrispondente all’endpoint in Custom Headers.
  • Verifica i nomi dei campi nelle configurazioni dei nodi n8n.
  • Verifica che i tipi di dati corrispondano ai formati previsti dai tuoi nodi.
  • Usa l’URL di test di n8n per esaminare i dati in arrivo.
  • Verifica che il codice di trasformazione restituisca JSON valido.
  • Controlla le impostazioni della risposta del nodo Webhook.
  • Usa il nodo Edit Fields (Set) per rinominare o ristrutturare i campi.
  • Esamina i log delle esecuzioni in n8n per visualizzare messaggi di errore dettagliati.
  • Controlla le impostazioni di connessione dei nodi e le credenziali.
  • Verifica che nel payload siano presenti tutti i campi obbligatori.
  • Testa i singoli nodi con dati di esempio.
  • Abilita un workflow di errore per intercettare e gestire gli errori.
  • Controlla i rate limit e le quote API dei servizi collegati.
Ultima modifica il 28 settembre 2026