Bucles

Introducción

La integración de Loops convierte los eventos de Dodo Payments en eventos de Loops, de modo que las confirmaciones de pago, las actualizaciones de suscripciones y los avisos de pagos fallidos se envían como correos de Loops. Una transformación asigna cada evento de pago a un evento de Loops, y ese evento activa el flujo de trabajo correspondiente en Loops.

Necesitas una clave de API de Loops. En Loops, ve a Settings → API y genera una clave.

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 Loops selected in the Integration dropdown

Select Loops

En la lista de Integration, selecciona Loops.

Enter API Key

Pega tu clave de API de Loops en el campo API key. Dodo Payments la envía como un encabezado Authorization en cada entrega. La integración establece la URL de destino, por lo que la clave es el único valor que debes proporcionar.

Configure Transformation

Edita el código en Transformation code para que cada evento se convierta en un evento de Loops. Comienza con los ejemplos siguientes. En Subscribed events, selecciona los eventos que gestiona tu código.

Test & Create

En Test this code, ejecuta la transformación con un payload de ejemplo y, a continuación, haz clic en Create endpoint.

Done

Los eventos de pago ahora activan correos electrónicos a través de Loops.

Ejemplos de Código de Transformación

Cada ejemplo reescribe un tipo de evento en el cuerpo de la API de Loops Send an Event: un eventName, el email del contacto y eventProperties que tus correos de Loops pueden usar.

Correo de confirmación de pago

Este ejemplo envía un evento payment_confirmation cuando un pago se completa correctamente.

payment_confirmation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "payment_confirmation",
      email: p.customer.email,
      eventProperties: {
        customer_name: p.customer.name,
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        currency: p.currency || "USD",
        payment_method: p.payment_method || "unknown",
        payment_date: new Date(webhook.payload.timestamp).toLocaleDateString()
      }
    };
  }
  return webhook;
}

Correo de bienvenida de suscripción

Este ejemplo envía un evento subscription_welcome cuando una suscripción se activa.

subscription_welcome.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "subscription_welcome",
      email: s.customer.email,
      eventProperties: {
        customer_name: s.customer.name,
        subscription_id: s.subscription_id,
        product_id: s.product_id,
        amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
        frequency: s.payment_frequency_interval,
        next_billing: s.next_billing_date
      }
    };
  }
  return webhook;
}

Notificación de pago fallido

Este ejemplo envía un evento payment_failed con el mensaje de error y un enlace para volver a intentar el pago. Reemplaza yourdomain.com por tu propio dominio.

payment_failure.js

function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "payment_failed",
      email: p.customer.email,
      eventProperties: {
        customer_name: p.customer.name,
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        error_message: p.error_message || "Payment processing failed",
        retry_link: `https://yourdomain.com/retry-payment/${p.payment_id}`
      }
    };
  }
  return webhook;
}

Consejos

Asigna a cada evento un nombre descriptivo, como payment_confirmation, para mantener organizados tus correos de Loops.
Incluye las propiedades del cliente que tus correos usan para la personalización.
En Loops, configura un flujo de trabajo y un correo electrónico para cada nombre de evento que envíes.
Usa los mismos nombres de propiedades en todos los eventos.
Prueba la entrega de correos electrónicos antes de ponerlo en producción.

Solución de problemas

Emails Not Being Sent

Comprueba que la clave de API sea correcta y esté activa.
Comprueba que cada nombre de evento coincida con el evento que activa tu flujo de trabajo de Loops.
Comprueba que las direcciones de correo electrónico de los destinatarios sean válidas.
Revisa los límites y las cuotas de envío de Loops.

Transformation Errors

Comprueba que el payload coincida con el formato de la API de Loops: un eventName, además de un email o userId.
Comprueba que todos los campos obligatorios estén presentes.
Comprueba que los nombres de los eventos tengan el formato correcto.
Asigna a cada propiedad del evento un valor de tipo string, number, boolean o date.
Comprueba los permisos de la clave de API.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introducción

Comenzando

Ejemplos de Código de Transformación

Correo de confirmación de pago

Correo de bienvenida de suscripción

Notificación de pago fallido

Consejos

Solución de problemas

​Introducción

​Comenzando

​Ejemplos de Código de Transformación

​Correo de confirmación de pago

​Correo de bienvenida de suscripción

​Notificación de pago fallido

​Consejos

​Solución de problemas

Introducción

Comenzando

Ejemplos de Código de Transformación

Correo de confirmación de pago

Correo de bienvenida de suscripción

Notificación de pago fallido

Consejos

Solución de problemas