Zapier

Introducción

Conecta Dodo Payments con miles de aplicaciones mediante Zapier. Cada evento de Dodo Payments puede iniciar un Zap que envía un correo electrónico, añade una fila a una hoja de cálculo, crea una tarea o actualiza un registro de CRM.

El conector de Zapier envía cada evento a la URL de webhook de un Zap que comienza con Webhooks by Zapier. Webhooks by Zapier no está disponible en el plan gratuito de Zapier, por lo que necesitas un plan de pago de Zapier. También necesitas acceso a Developer → Webhooks en el dashboard de Dodo Payments.

Comenzando

Open the Webhook Section

En el dashboard de Dodo Payments, ve a Developer → Webhooks y haz clic en Add endpoint.

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

Select Zapier

En Integration, selecciona Zapier. El dashboard carga el código de transformación de Zapier y muestra los pasos de configuración en el panel How to connect Zapier.

Create Zap in Zapier

En Zapier, crea un Zap. Para el trigger, selecciona Webhooks by Zapier, elige el evento Catch Hook y haz clic en Continue. En la pestaña Test del trigger, copia la URL del webhook.

Paste Webhook URL

Pega la URL del webhook de Zapier en Endpoint URL. El conector de Zapier no tiene un campo de API key.

Select Events

Subscribed events muestra los eventos compatibles con el conector de Zapier. Conserva únicamente los eventos que gestiona tu transformación. Zapier acepta cualquier JSON, por lo que un evento que la transformación deja sin cambios sigue iniciando tu Zap con el payload original de Dodo Payments.

Configure Transformation

En Transformation code, edita el handler para enviar los campos que utiliza tu Zap. Comienza con los ejemplos.

Test & Create

En Test this code, selecciona un tipo de evento y haz clic en Simulate para previsualizar el payload. Después, haz clic en Create endpoint.

Done

Los eventos suscritos ahora llegan a tu Zap. Para cargar campos de ejemplo en Zapier, abre la pestaña Testing del endpoint, selecciona un tipo de evento y haz clic en Send example. En Zapier, haz clic en Test trigger, asigna los campos en los pasos de acción y publica el Zap.

Ejemplos de código de transformación

Cada handler reemplaza webhook.payload por un objeto plano y conserva webhook.url, la URL del webhook de Zapier. Los importes de Dodo Payments están expresados en la unidad monetaria más pequeña, por lo que los ejemplos dividen entre 100 y envían el resultado como una cadena, como "25.00". Para monedas sin decimales, como JPY y KRW, utiliza el importe tal cual.

Payload básico de webhook

Envía los detalles de un pago realizado correctamente:

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 de eventos de suscripción

Envía un evento subscription_started o subscription_cancelled cuando una suscripción se activa o se cancela:

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 de alertas de disputas

Envía cada evento de disputa, con urgent establecido en true cuando se abre una disputa:

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;
}

Casos de uso populares de Zapier

Email Notifications

Envía correos de Gmail o Outlook para confirmar pagos
Añade clientes a secuencias de correo electrónico en Mailchimp o ConvertKit
Envía notificaciones de Slack o Discord
Añade filas a Google Sheets

CRM Updates

Añade contactos a HubSpot o Salesforce
Crea acuerdos en Pipedrive o Close
Actualiza registros de clientes en Airtable
Registra actividades en Monday.com

Task Management

Crea tareas en Asana o Trello
Añade tareas pendientes en Notion
Crea eventos de calendario
Envía mensajes SMS mediante Twilio

Consejos

Mantén el payload plano para que cada campo sea fácil de encontrar al asignarlo en Zapier.
Usa los mismos nombres de campo en todos los eventos para que un Zap pueda gestionar varios tipos de evento.
Incluye timestamp para que tu Zap pueda registrar cuándo ocurrió cada evento.
Después de cambiar la transformación, envía un nuevo ejemplo y vuelve a probar el trigger en Zapier para que cargue los campos nuevos.
Para ejecutar pasos posteriores solo para algunos eventos, añade un paso Filter by Zapier que compruebe event_type.
Para omitir un evento en el código, establece webhook.cancel = true antes de devolver el webhook. Los logs registran una entrega omitida como correcta.

Solución de problemas

Zap Not Triggering

Comprueba que Endpoint URL coincida con la URL del webhook de la pestaña Test del trigger. La URL cambia cuando el Zap se transfiere a otro usuario de Zapier.
Comprueba que el Zap esté publicado y activado. Zapier devuelve 404 para un Zap desactivado o eliminado, pero la URL puede seguir devolviendo 200 durante varias horas después del cambio.
Abre la pestaña Logs en Developer → Webhooks para ver la respuesta de Zapier a cada entrega.
Comprueba que el evento esté seleccionado en Subscribed events. Para cambiar la selección, abre el endpoint y haz clic en Edit.

Data Not Mapping Correctly

Comprueba que los nombres de campo de tus pasos de acción coincidan con las claves que envía tu transformación.
Comprueba que cada valor tenga el tipo que espera tu acción. Los ejemplos envían los importes como cadenas.
Comprueba que el handler devuelva webhook y que webhook.payload sea un objeto JSON. Si el payload es un array, Zapier ejecuta el Zap una vez por cada elemento.
Usa Test trigger en Zapier para ver los campos del evento más reciente.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introducción

Comenzando

Ejemplos de código de transformación

Payload básico de webhook

Handler de eventos de suscripción

Handler de alertas de disputas

Casos de uso populares de Zapier

Consejos

Solución de problemas

​Introducción

​Comenzando

​Ejemplos de código de transformación

​Payload básico de webhook

​Handler de eventos de suscripción

​Handler de alertas de disputas

​Casos de uso populares de Zapier

​Consejos

​Solución de problemas

Introducción

Comenzando

Ejemplos de código de transformación

Payload básico de webhook

Handler de eventos de suscripción

Handler de alertas de disputas

Casos de uso populares de Zapier

Consejos

Solución de problemas