Zapier

Introduzione

Collega Dodo Payments a migliaia di app tramite Zapier. Ogni evento di Dodo Payments può avviare uno Zap che invia un’email, aggiunge una riga a un foglio di calcolo, crea un’attività o aggiorna un record CRM.

Il connettore Zapier invia ogni evento all’URL webhook di uno Zap che inizia con Webhooks by Zapier. Webhooks by Zapier non è disponibile nel piano gratuito di Zapier, quindi è necessario un piano Zapier a pagamento. È inoltre necessario avere accesso a Developer → Webhooks nella dashboard di Dodo Payments.

Iniziare

Open the Webhook Section

Nel dashboard di Dodo Payments, vai a Developer → Webhooks e fai clic su Add endpoint.

Add endpoint dialog with Zapier selected in the Integration dropdown and the How to connect Zapier steps

Select Zapier

In Integration, seleziona Zapier. La dashboard carica il codice di trasformazione di Zapier e mostra i passaggi di configurazione nel pannello How to connect Zapier.

Create Zap in Zapier

In Zapier, crea uno Zap. Per il trigger, seleziona Webhooks by Zapier, scegli l’evento Catch Hook e fai clic su Continue. Nella scheda Test del trigger, copia l’URL webhook.

Paste Webhook URL

Incolla l’URL webhook di Zapier in Endpoint URL. Il connettore Zapier non dispone di un campo per la chiave API.

Select Events

Subscribed events elenca gli eventi supportati dal connettore Zapier. Mantieni solo gli eventi gestiti dalla tua trasformazione. Zapier accetta qualsiasi JSON, quindi un evento che la trasformazione lascia invariato avvia comunque lo Zap, con il payload originale di Dodo Payments.

Configure Transformation

In Transformation code, modifica l’handler per inviare i campi utilizzati dal tuo Zap. Inizia dagli esempi.

Test & Create

In Test this code, seleziona un tipo di evento e fai clic su Simulate per visualizzare in anteprima il payload. Poi fai clic su Create endpoint.

Done

Gli eventi sottoscritti ora raggiungono il tuo Zap. Per caricare campi di esempio in Zapier, apri la scheda Testing dell’endpoint, seleziona un tipo di evento e fai clic su Send example. In Zapier, fai clic su Test trigger, mappa i campi nei passaggi dell’azione e pubblica lo Zap.

Esempi di codice di trasformazione

Ogni handler sostituisce webhook.payload con un oggetto semplice e mantiene webhook.url, l’URL webhook di Zapier. Gli importi di Dodo Payments sono espressi nell’unità monetaria più piccola, quindi gli esempi li dividono per 100 e inviano il risultato come stringa, ad esempio "25.00". Per le valute senza decimali, come JPY e KRW, usa l’importo così com’è.

Payload webhook di base

Invia i dettagli di un pagamento completato correttamente:

basic_webhook.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      event_type: webhook.eventType,
      payment_id: p.payment_id,
      amount: (p.total_amount / 100).toFixed(2),
      currency: p.currency,
      customer_email: p.customer.email,
      customer_name: p.customer.name,
      payment_method: p.payment_method || "unknown",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

Handler per gli eventi degli abbonamenti

Invia un evento subscription_started o subscription_cancelled quando un abbonamento diventa attivo o viene annullato:

subscription_webhook.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        event_type: "subscription_started",
        subscription_id: s.subscription_id,
        customer_email: s.customer.email,
        customer_name: s.customer.name,
        product_id: s.product_id,
        amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
        currency: s.currency,
        frequency: s.payment_frequency_interval,
        next_billing: s.next_billing_date,
        timestamp: webhook.payload.timestamp
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        event_type: "subscription_cancelled",
        subscription_id: s.subscription_id,
        customer_email: s.customer.email,
        cancelled_at: s.cancelled_at,
        cancel_at_next_billing: s.cancel_at_next_billing_date,
        timestamp: webhook.payload.timestamp
      };
      break;
  }
  return webhook;
}

Handler per gli avvisi sulle contestazioni

Invia ogni evento di contestazione, impostando urgent su true quando si apre una contestazione:

dispute_webhook.js

function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    webhook.payload = {
      event_type: webhook.eventType,
      dispute_id: d.dispute_id,
      payment_id: d.payment_id,
      amount: (d.amount / 100).toFixed(2),
      currency: d.currency,
      status: d.dispute_status,
      stage: d.dispute_stage,
      remarks: d.remarks || "",
      urgent: webhook.eventType === "dispute.opened",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

Casi d’uso più comuni di Zapier

Email Notifications

Invia email da Gmail o Outlook per confermare i pagamenti
Aggiungi i clienti alle sequenze email in Mailchimp o ConvertKit
Invia notifiche Slack o Discord
Aggiungi righe a Google Sheets

CRM Updates

Aggiungi contatti a HubSpot o Salesforce
Crea trattative in Pipedrive o Close
Aggiorna i record dei clienti in Airtable
Registra attività in Monday.com

Task Management

Crea attività in Asana o Trello
Aggiungi elementi da completare in Notion
Crea eventi del calendario
Invia messaggi SMS tramite Twilio

Suggerimenti

Mantieni il payload semplice, in modo che ogni campo sia facile da trovare quando lo mappi in Zapier.
Usa gli stessi nomi dei campi per tutti gli eventi, così un unico Zap può gestire diversi tipi di evento.
Includi timestamp, così il tuo Zap può registrare quando si è verificato ogni evento.
Dopo aver modificato la trasformazione, invia un nuovo esempio e testa di nuovo il trigger in Zapier, in modo da caricare i nuovi campi.
Per eseguire i passaggi successivi solo per alcuni eventi, aggiungi un passaggio Filter by Zapier che verifichi event_type.
Per ignorare un evento nel codice, imposta webhook.cancel = true prima di restituire il webhook. I log registrano una consegna ignorata come completata.

Risoluzione dei problemi

Zap Not Triggering

Verifica che Endpoint URL corrisponda all’URL webhook nella scheda Test del trigger. L’URL cambia quando lo Zap viene trasferito a un altro utente Zapier.
Verifica che lo Zap sia pubblicato e attivo. Zapier restituisce 404 per uno Zap disattivato o eliminato, ma l’URL può continuare a restituire 200 fino a diverse ore dopo la modifica.
Apri la scheda Logs in Developer → Webhooks per visualizzare la risposta di Zapier a ogni consegna.
Verifica che l’evento sia selezionato in Subscribed events. Per modificare la selezione, apri l’endpoint e fai clic su Edit.

Data Not Mapping Correctly

Verifica che i nomi dei campi nei passaggi dell’azione corrispondano alle chiavi inviate dalla trasformazione.
Verifica che ogni valore abbia il tipo previsto dall’azione. Gli esempi inviano gli importi come stringhe.
Verifica che l’handler restituisca webhook e che webhook.payload sia un oggetto JSON. Se il payload è un array, Zapier esegue lo Zap una volta per ogni elemento.
Usa Test trigger in Zapier per visualizzare i campi dell’evento più recente.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduzione

Iniziare

Esempi di codice di trasformazione

Payload webhook di base

Handler per gli eventi degli abbonamenti

Handler per gli avvisi sulle contestazioni

Casi d’uso più comuni di Zapier

Suggerimenti

Risoluzione dei problemi

​Introduzione

​Iniziare

​Esempi di codice di trasformazione

​Payload webhook di base

​Handler per gli eventi degli abbonamenti

​Handler per gli avvisi sulle contestazioni

​Casi d’uso più comuni di Zapier

​Suggerimenti

​Risoluzione dei problemi

Introduzione

Iniziare

Esempi di codice di trasformazione

Payload webhook di base

Handler per gli eventi degli abbonamenti

Handler per gli avvisi sulle contestazioni

Casi d’uso più comuni di Zapier

Suggerimenti

Risoluzione dei problemi