DataFast

Introducción

DataFast es una herramienta de análisis centrada en los ingresos que te ayuda a descubrir qué canales de marketing generan clientes de pago. Al integrar Dodo Payments con DataFast, puedes atribuir ingresos a tus fuentes de tráfico, identificar segmentos de clientes de alto valor y tomar decisiones basadas en datos para hacer crecer tu negocio.

Esta integración requiere su clave API de DataFast, que puede obtener en su panel de DataFast.

Cómo Funciona

DataFast rastrea a los visitantes a través de un ID de visitante único almacenado en una cookie. Para atribuir ingresos a los canales de marketing, necesitas:

Capture el ID de visitante de DataFast de la cookie datafast_visitor_id al crear sesiones de pago
Almacene el ID de visitante en los metadatos de pago
Envíe los datos de pago a DataFast cuando los pagos se completen con éxito utilizando su API de pagos

Esto permite que DataFast asocie los pagos exitosos con la fuente de tráfico original, dándote una atribución de ingresos completa.

Comenzando

Install DataFast Script

Primero, instale el script de seguimiento de DataFast en su sitio web. Esto crea la cookie datafast_visitor_id que rastrea a sus visitantes.Visite la documentación de DataFast para obtener instrucciones de instalación específicas para su plataforma.

Get Your API Key

Inicie sesión en su panel de DataFast y vaya a la configuración de su sitio web para obtener su clave API.

Mantenga su clave API segura y nunca la exponga en código del lado del cliente.

Capture Visitor ID in Checkout

Al crear una sesión de pago, capture el ID de visitante de DataFast de la cookie y agrégelo a los metadatos de su pago.

Send Payment Data via Webhook

Configure un webhook para enviar los datos de pago a la API de Pagos de DataFast cuando los pagos tengan éxito.

Done!

🎉 Los datos de ingresos ahora aparecerán en su panel de DataFast con atribución completa a los canales de marketing.

Guía de Implementación

Paso 1: Agregar ID de Visitante a los Metadatos del Pago

Al crear una sesión de pago, captura el ID de visitante de DataFast de la cookie e inclúyelo en tus metadatos de pago.

Los ejemplos a continuación utilizan POST /payments, que está obsoleto. Sigue funcionando para las integraciones existentes, pero las integraciones nuevas deben usar Checkout Sessions (POST /checkouts); metadata se pasa de la misma manera.

import { cookies } from 'next/headers';
import { dodopayments } from '@/lib/dodopayments';

export async function createCheckout(productId: string) {
  // Capture DataFast visitor ID from cookie
  const datafastVisitorId = cookies().get('datafast_visitor_id')?.value;

  const payment = await dodopayments.payments.create({
    product_cart: [{ product_id: productId, quantity: 1 }],
    // ... other payment configuration
    metadata: {
      datafast_visitor_id: datafastVisitorId, // Store visitor ID in metadata
    },
  });

  return payment;
}

const express = require('express');
const router = express.Router();

router.post('/create-checkout', async (req, res) => {
  // Capture DataFast visitor ID from cookie
  const datafastVisitorId = req.cookies?.datafast_visitor_id;

  const payment = await dodopayments.payments.create({
    product_cart: [{ product_id: req.body.productId, quantity: 1 }],
    // ... other payment configuration
    metadata: {
      datafast_visitor_id: datafastVisitorId, // Store visitor ID in metadata
    },
  });

  res.json({ payment });
});

// Capture DataFast visitor ID from cookie
const datafastVisitorId = getCookie('datafast_visitor_id'); // Use your framework's cookie method

const payment = await dodopayments.payments.create({
  product_cart: [{ product_id: productId, quantity: 1 }],
  // ... other payment configuration
  metadata: {
    datafast_visitor_id: datafastVisitorId, // Store visitor ID in metadata
  },
});

Paso 2: Envía los datos de pago a DataFast

Configura un endpoint de webhook para enviar los datos de pago a la Payment API de DataFast cuando los pagos se completen correctamente.

Open the Webhook Section

En tu panel de Dodo Payments, ve a Webhooks → + Add Endpoint y expande el menú desplegable de integraciones.

Select DataFast

Selecciona la tarjeta de integración de DataFast.

Enter API Key

Introduce tu API Key de DataFast en el campo de configuración.

Configure Transformation

Edita el código de transformación para dar formato a los datos de pago para la Payment API de DataFast.

Test & Create

Prueba con payloads de ejemplo y haz clic en Create para activar la integración.

Ejemplos de código de transformación

Atribución de pagos básica

basic_payment.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const payment = webhook.payload.data;
    
    // Only send to DataFast if visitor ID exists in metadata
    if (payment.metadata && payment.metadata.datafast_visitor_id) {
      webhook.payload = {
        amount: payment.total_amount / 100, // Convert from cents to dollars
        currency: payment.currency,
        transaction_id: payment.payment_id,
        datafast_visitor_id: payment.metadata.datafast_visitor_id,
      };
    } else {
      // Cancel dispatch if no visitor ID (prevents unnecessary API calls)
      webhook.cancel = true;
    }
  }
  return webhook;
}

Gestionar monedas sin decimales

Algunas monedas (como JPY) no utilizan posiciones decimales. Ajusta el cálculo del importe según corresponda:

zero_decimal.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const payment = webhook.payload.data;
    
    if (payment.metadata && payment.metadata.datafast_visitor_id) {
      // Zero decimal currencies: JPY, KRW, CLP, etc.
      const zeroDecimalCurrencies = ['JPY', 'KRW', 'CLP', 'VND', 'UGX', 'MGA'];
      const isZeroDecimal = zeroDecimalCurrencies.includes(payment.currency);
      
      webhook.payload = {
        amount: isZeroDecimal 
          ? payment.total_amount // Use amount as-is for zero decimal currencies
          : payment.total_amount / 100, // Convert from cents for other currencies
        currency: payment.currency,
        transaction_id: payment.payment_id,
        datafast_visitor_id: payment.metadata.datafast_visitor_id,
      };
    } else {
      // Cancel dispatch if no visitor ID (prevents unnecessary API calls)
      webhook.cancel = true;
    }
  }
  return webhook;
}

Pagos de suscripciones

Para los pagos de suscripciones recurrentes, puedes realizar un seguimiento de cada pago:

subscription_payment.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const payment = webhook.payload.data;
    
    // Check if this is a subscription payment
    const isSubscription = payment.subscription_id !== null;
    
    if (payment.metadata && payment.metadata.datafast_visitor_id) {
      webhook.payload = {
        amount: payment.total_amount / 100,
        currency: payment.currency,
        transaction_id: payment.payment_id,
        datafast_visitor_id: payment.metadata.datafast_visitor_id,
        // Optional: Add subscription context
        ...(isSubscription && {
          subscription_id: payment.subscription_id,
        }),
      };
    } else {
      // Cancel dispatch if no visitor ID (prevents unnecessary API calls)
      webhook.cancel = true;
    }
  }
  return webhook;
}

Prácticas recomendadas

Captura el ID del visitante con antelación: Almacena el ID del visitante de DataFast lo antes posible en tu flujo de checkout para garantizar una atribución precisa, incluso si el usuario abandona el sitio y vuelve más tarde.

Incluye siempre el ID del visitante en los metadatos: Sin el ID del visitante, DataFast no puede atribuir los ingresos a los canales de marketing
Gestiona las monedas sin decimales: Algunas monedas (JPY, KRW, etc.) no utilizan posiciones decimales; ajusta el cálculo del importe según corresponda
Prueba con pagos de ejemplo: Verifica que la integración funcione correctamente antes de pasar a producción
Supervisa tu panel de DataFast: Comprueba que los pagos aparezcan correctamente con la atribución adecuada
Utiliza reintentos de webhook: La Payment API de DataFast es idempotente, por lo que los reintentos son seguros si falla un webhook

Solución de problemas

Payments not appearing in DataFast

Verifica que tu API key de DataFast sea correcta y esté activa
Comprueba que datafast_visitor_id se esté capturando y almacenando en los metadatos del pago
Asegúrate de que la transformación del webhook dé el formato correcto al payload
Verifica que el webhook se active en los eventos payment.succeeded
Comprueba si hay mensajes de error o registros de API en el panel de DataFast

Revenue attribution not working

Confirma que el script de seguimiento de DataFast esté instalado y funcione en tu sitio web
Verifica que la cookie datafast_visitor_id se establezca correctamente
Comprueba que los ID de visitante coincidan entre la creación del checkout y la finalización del pago
Asegúrate de capturar el ID del visitante antes de crear la sesión de checkout
Consulta la documentación de la Payment API de DataFast para obtener más información

Transformation errors

Valida que la estructura JSON coincida con el formato de la Payment API de DataFast
Comprueba que todos los campos obligatorios (amount, currency, transaction_id, datafast_visitor_id) estén presentes
Asegúrate de que el importe se convierta correctamente (divídelo entre 100 para la mayoría de las monedas, excepto las monedas sin decimales)
Verifica que la URL del endpoint de la API sea correcta: https://datafa.st/api/v1/payments
Prueba la transformación con payloads de webhook de ejemplo

Currency conversion issues

Para las monedas sin decimales (JPY, KRW, CLP, VND, UGX, MGA), envía el importe tal cual, sin dividirlo entre 100
Para todas las demás monedas, divide el importe entre 100 para convertirlo de centavos a la unidad base
Comprueba que el código de moneda coincida con el formato ISO 4217 (por ejemplo, “USD”, “EUR”, “JPY”)

Recursos adicionales

DataFast Documentation

Obtén más información sobre la Payment API de DataFast y sus funciones de atribución de ingresos.

DataFast Dashboard

Accede a tu panel de DataFast para consultar los análisis de ingresos y los datos de atribución.

¿Necesitas ayuda? Ponte en contacto con el equipo de soporte de Dodo Payments en support@dodopayments.com para obtener asistencia con la integración.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Introducción

Cómo Funciona

Comenzando

Guía de Implementación

Paso 1: Agregar ID de Visitante a los Metadatos del Pago

Paso 2: Envía los datos de pago a DataFast

Ejemplos de código de transformación

Atribución de pagos básica

Gestionar monedas sin decimales

Pagos de suscripciones

Prácticas recomendadas

Solución de problemas

Recursos adicionales

DataFast Documentation

DataFast Dashboard

​Introducción

​Cómo Funciona

​Comenzando

​Guía de Implementación

​Paso 1: Agregar ID de Visitante a los Metadatos del Pago

​Paso 2: Envía los datos de pago a DataFast

​Ejemplos de código de transformación

​Atribución de pagos básica

​Gestionar monedas sin decimales

​Pagos de suscripciones

​Prácticas recomendadas

​Solución de problemas

​Recursos adicionales

DataFast Documentation

DataFast Dashboard

Introducción

Cómo Funciona

Comenzando

Guía de Implementación

Paso 1: Agregar ID de Visitante a los Metadatos del Pago

Paso 2: Envía los datos de pago a DataFast

Ejemplos de código de transformación

Atribución de pagos básica

Gestionar monedas sin decimales

Pagos de suscripciones

Prácticas recomendadas

Solución de problemas

Recursos adicionales