Slack

Introducción

La integración de Slack publica eventos de Dodo Payments, como pagos exitosos, cambios de suscripción y disputas, en el canal de Slack que elijas. Tu equipo puede seguir los pagos y actuar sobre las disputas desde Slack, sin tener que consultar el dashboard.

El conector de Slack convierte cada evento de Dodo Payments en un mensaje de Slack mediante una transformación: código JavaScript que se ejecuta en el evento antes de la entrega. El conector incluye código de transformación, por lo que no necesitas programar para comenzar. Necesitas acceso a Developer → Webhooks en el dashboard de Dodo Payments y permiso para añadir aplicaciones a tu espacio de trabajo de Slack.

Comenzando

Open the Webhook Section

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

Cuadro de diálogo Add endpoint con el menú desplegable Integration configurado como Custom webhook

Select Slack Integration

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

Cuadro de diálogo Add endpoint con Slack seleccionado y los pasos de How to connect Slack

Create a Slack Webhook URL

En Slack, crea una aplicación con un webhook entrante para el canal que debe recibir las notificaciones:

Abre api.slack.com/apps, haz clic en Create New App y selecciona From scratch.
Asigna un nombre a la aplicación, por ejemplo Dodo Payments Notifications, elige tu espacio de trabajo y haz clic en Create App.
En la barra lateral, abre Incoming Webhooks y activa Activate Incoming Webhooks.
Haz clic en Add New Webhook to Workspace, elige el canal y haz clic en Allow.
Copia la Webhook URL, que comienza con https://hooks.slack.com/services/.

Pantalla de permisos de Slack con un selector de canales y un botón Allow

Paste the Webhook URL

Pega la URL del webhook de Slack en Endpoint URL. Slack no necesita una API key.

Select Events

Subscribed events muestra los eventos compatibles con el conector de Slack. Si cambias la transformación, conserva solo los eventos que gestiona. Slack rechaza una solicitud que no sea un mensaje de Slack, por lo que un evento que la transformación deje sin cambios no se podrá entregar.

Customize Transformation Code

En Transformation code, edita el handler para elegir qué eventos publican un mensaje y qué aspecto tiene cada mensaje. Conserva el código del conector o empieza con los ejemplos.

Editor de código de transformación con el handler de Slack para eventos de pago

Test and Create

En Test this code, selecciona un tipo de evento y haz clic en Simulate. En Result se muestra el mensaje que recibiría Slack. Después, haz clic en Create endpoint.

Panel Test this code con payment.succeeded seleccionado, un botón Simulate y el botón Create endpoint

Integration Complete!

Dodo Payments ahora publica cada evento suscrito en tu canal de Slack. Para publicar un mensaje de prueba, abre la pestaña Testing del endpoint, selecciona un tipo de evento y haz clic en Send example.

Ejemplos de código de transformación

Cada handler reemplaza webhook.payload con un mensaje de Slack y conserva webhook.url, tu URL de webhook entrante. Los importes de Dodo Payments están en la unidad monetaria más pequeña, por lo que los ejemplos los dividen entre 100 y muestran el código de moneda. Para monedas sin decimales, como JPY y KRW, usa el importe tal cual.

Notificaciones básicas de pagos

Publica un mensaje de texto sin formato cuando un pago se completa correctamente, falla o está en proceso:

payment_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "payment.succeeded":
      webhook.payload = {
        text: `✅ Payment Successful\nAmount: ${(webhook.payload.data.total_amount / 100).toFixed(2)} ${webhook.payload.data.currency}\nCustomer: ${webhook.payload.data.customer.email}\nPayment ID: ${webhook.payload.data.payment_id}`
      };
      break;
      
    case "payment.failed":
      webhook.payload = {
        text: `❌ Payment Failed\nAmount: ${(webhook.payload.data.total_amount / 100).toFixed(2)} ${webhook.payload.data.currency}\nCustomer: ${webhook.payload.data.customer.email}\nReason: ${webhook.payload.data.error_message || 'Unknown'}`
      };
      break;
      
    case "payment.processing":
      webhook.payload = {
        text: `⏳ Payment Processing\nAmount: ${(webhook.payload.data.total_amount / 100).toFixed(2)} ${webhook.payload.data.currency}\nCustomer: ${webhook.payload.data.customer.email}`
      };
      break;
  }

  return webhook;
}

Notificaciones detalladas de suscripciones

Publica un mensaje codificado por colores con campos adjuntos cuando una suscripción se activa, se cancela o se renueva:

subscription_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "🎉 Subscription Activated",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.recurring_pre_tax_amount / 100).toFixed(2)} ${webhook.payload.data.currency}/${webhook.payload.data.payment_frequency_interval}`,
              short: true
            },
            {
              title: "Next Billing",
              value: new Date(webhook.payload.data.next_billing_date).toLocaleDateString(),
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "subscription.cancelled":
      webhook.payload = {
        attachments: [{
          color: "warning",
          title: "⚠️ Subscription Cancelled",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Cancellation Date",
              value: new Date(webhook.payload.data.cancelled_at).toLocaleDateString(),
              short: true
            },
            {
              title: "Cancel at Next Billing",
              value: webhook.payload.data.cancel_at_next_billing_date ? "Yes" : "No",
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "subscription.renewed":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "🔄 Subscription Renewed",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.recurring_pre_tax_amount / 100).toFixed(2)} ${webhook.payload.data.currency}`,
              short: true
            },
            {
              title: "Next Billing",
              value: new Date(webhook.payload.data.next_billing_date).toLocaleDateString(),
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
  }

  return webhook;
}

Notificaciones de gestión de disputas

Publica un mensaje rojo cuando se abre una disputa o se pierde, y uno verde cuando se gana:

dispute_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "dispute.opened":
      webhook.payload = {
        attachments: [{
          color: "danger",
          title: "🚨 New Dispute Opened",
          fields: [
            {
              title: "Payment ID",
              value: webhook.payload.data.payment_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.amount / 100).toFixed(2)} ${webhook.payload.data.currency}`,
              short: true
            },
            {
              title: "Status",
              value: webhook.payload.data.dispute_status,
              short: true
            },
            {
              title: "Stage",
              value: webhook.payload.data.dispute_stage,
              short: true
            },
            {
              title: "Remarks",
              value: webhook.payload.data.remarks || "No remarks",
              short: false
            }
          ],
          footer: "Dodo Payments - Action Required",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "dispute.won":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "✅ Dispute Won",
          fields: [
            {
              title: "Payment ID",
              value: webhook.payload.data.payment_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.amount / 100).toFixed(2)} ${webhook.payload.data.currency}`,
              short: true
            },
            {
              title: "Status",
              value: webhook.payload.data.dispute_status,
              short: true
            },
            {
              title: "Resolution",
              value: "Dispute resolved in your favor",
              short: false
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "dispute.lost":
      webhook.payload = {
        attachments: [{
          color: "danger",
          title: "❌ Dispute Lost",
          fields: [
            {
              title: "Payment ID",
              value: webhook.payload.data.payment_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.amount / 100).toFixed(2)} ${webhook.payload.data.currency}`,
              short: true
            },
            {
              title: "Status",
              value: webhook.payload.data.dispute_status,
              short: true
            },
            {
              title: "Impact",
              value: "The disputed amount stays deducted from your balance",
              short: false
            }
          ],
          footer: "Dodo Payments - Review Required",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
  }

  return webhook;
}

Handler completo para todos los eventos

Publica un mensaje con el mismo formato para cada tipo de evento. Los eventos sin su propio case reciben un mensaje genérico con el tipo de evento y la hora:

all_events_notifs.js

function handler(webhook) {
  const event = webhook.payload.data;
  const timestamp = new Date(webhook.payload.timestamp).toLocaleString();
  
  let color, emoji, title, fields = [];
  
  switch (webhook.eventType) {
    case "payment.succeeded":
      color = "good";
      emoji = "✅";
      title = "Payment Successful";
      fields = [
        { title: "Amount", value: `${(event.total_amount / 100).toFixed(2)} ${event.currency}`, short: true },
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Method", value: event.payment_method || "Unknown", short: true }
      ];
      break;
      
    case "payment.failed":
      color = "danger";
      emoji = "❌";
      title = "Payment Failed";
      fields = [
        { title: "Amount", value: `${(event.total_amount / 100).toFixed(2)} ${event.currency}`, short: true },
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Reason", value: event.error_message || "Unknown", short: false }
      ];
      break;
      
    case "subscription.active":
      color = "good";
      emoji = "🎉";
      title = "Subscription Activated";
      fields = [
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "Amount", value: `${(event.recurring_pre_tax_amount / 100).toFixed(2)} ${event.currency}/${event.payment_frequency_interval}`, short: true },
        { title: "Next Billing", value: new Date(event.next_billing_date).toLocaleDateString(), short: true }
      ];
      break;
      
    case "subscription.cancelled":
      color = "warning";
      emoji = "⚠️";
      title = "Subscription Cancelled";
      fields = [
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "Cancellation Date", value: new Date(event.cancelled_at).toLocaleDateString(), short: true },
        { title: "Cancel at Next Billing", value: event.cancel_at_next_billing_date ? "Yes" : "No", short: true }
      ];
      break;
      
    case "refund.succeeded":
      color = "good";
      emoji = "💰";
      title = "Refund Processed";
      fields = [
        { title: "Amount", value: `${(event.amount / 100).toFixed(2)} ${event.currency || ""}`, short: true },
        { title: "Refund ID", value: event.refund_id, short: true },
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Reason", value: event.reason || "Not specified", short: true }
      ];
      break;
      
    case "dispute.opened":
      color = "danger";
      emoji = "🚨";
      title = "New Dispute Opened";
      fields = [
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Amount", value: `${(event.amount / 100).toFixed(2)} ${event.currency}`, short: true },
        { title: "Status", value: event.dispute_status, short: true },
        { title: "Stage", value: event.dispute_stage, short: true },
        { title: "Remarks", value: event.remarks || "No remarks", short: false }
      ];
      break;
      
    case "license_key.created":
      color = "good";
      emoji = "🔑";
      title = "License Key Created";
      fields = [
        { title: "License ID", value: event.id, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "License Key", value: event.key.substring(0, 8) + "****", short: true },
        { title: "Expires", value: event.expires_at ? new Date(event.expires_at).toLocaleDateString() : "Never", short: true }
      ];
      break;
      
    default:
      // Handle any other events with a generic format
      color = "#3aa3e3";
      emoji = "ℹ️";
      title = webhook.eventType.replace(/_/g, ' ').replace(/\b\w/g, l => l.toUpperCase());
      fields = [
        { title: "Event Type", value: webhook.eventType, short: true },
        { title: "Timestamp", value: timestamp, short: true }
      ];
  }
  
  webhook.payload = {
    attachments: [{
      color: color,
      title: `${emoji} ${title}`,
      fields: fields,
      footer: "Dodo Payments",
      ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
    }]
  };

  return webhook;
}

Prácticas recomendadas

Sigue estas prácticas para que las notificaciones de Slack sean útiles:

Usa archivos adjuntos en los mensajes con colores y campos, para que cada evento sea claro y permita actuar fácilmente.
Incluye datos clave, como el importe, el correo electrónico del cliente y los ID, para que tu equipo pueda encontrar rápidamente el registro.
Asocia el color con el tipo de evento: verde (good) para los eventos completados correctamente, rojo (danger) para disputas o fallos, amarillo (warning) para cancelaciones y azul (#3aa3e3) para eventos informativos.
Añade una marca de tiempo (ts), para que cada mensaje muestre cuándo ocurrió el evento.

Gestiona los datos confidenciales: No publiques en Slack valores confidenciales, como claves de licencia completas o datos personales. Trúncalos u ocúltalos parcialmente, como hace el campo de clave de licencia del ejemplo para todos los eventos.

Solución de problemas

Notifications Not Appearing in Slack

Comprueba que la URL del webhook de Slack sea correcta y que su aplicación de Slack siga instalada.
Comprueba que el código de transformación sea JavaScript válido.
Comprueba que se estén produciendo los eventos suscritos. Para enviar uno, usa Send example en la pestaña Testing del endpoint.
Comprueba que tu aplicación de Slack tenga activados los Incoming Webhooks y pueda publicar en el canal.

Transformation Errors

Abre la pestaña Logs en Developer → Webhooks y comprueba la respuesta de la entrega fallida.
Comprueba que los campos del payload que lee tu código coincidan con el payload del evento para ese tipo de evento.
Prueba tu código con Simulate y un payload de ejemplo.
Comprueba que cada campo que lee tu código esté presente. Los campos opcionales, como error_message, pueden ser null.

Missing Event Types

Comprueba que el evento esté seleccionado en Subscribed events. Para cambiar la selección, abre el endpoint y haz clic en Edit.
Comprueba que el conector de Slack admita el evento. Subscribed events solo muestra los eventos compatibles con el conector.
Comprueba que tu transformación tenga un case para el evento. Los ejemplos dejan sin cambios los demás eventos, y Slack los rechaza.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introducción

Comenzando

Ejemplos de código de transformación

Notificaciones básicas de pagos

Notificaciones detalladas de suscripciones

Notificaciones de gestión de disputas

Handler completo para todos los eventos

Prácticas recomendadas

Solución de problemas

​Introducción

​Comenzando

​Ejemplos de código de transformación

​Notificaciones básicas de pagos

​Notificaciones detalladas de suscripciones

​Notificaciones de gestión de disputas

​Handler completo para todos los eventos

​Prácticas recomendadas

​Solución de problemas

Introducción

Comenzando

Ejemplos de código de transformación

Notificaciones básicas de pagos

Notificaciones detalladas de suscripciones

Notificaciones de gestión de disputas

Handler completo para todos los eventos

Prácticas recomendadas

Solución de problemas