Conectar Dodo Payments
Apunta Dodo Payments a Clakta con un webhook para que tus pagos, reembolsos y contracargos lleguen automáticamente, y cada venta se asocie al visitante que la hizo.
Dodo Payments envía tus pagos, reembolsos y contracargos a Clakta mediante un webhook: Clakta te da una dirección y tú la pegas en Dodo.
Conectar
En Clakta:
- Abre tu proyecto y ve a Configuración del proyecto → Plataformas de venta.
- Busca Dodo Payments y haz clic en Conectar.
- Ponle a la conexión un nombre que vayas a reconocer después, como
Cuenta principal, y haz clic en Crear conexión. - Copia la URL del webhook que aparece. Deja esta ventana abierta.
En Dodo Payments:
- Ve a Developer → Webhooks → Add endpoint.
- Pega la URL que copiaste.
- Marca los eventos de pago, reembolso y disputa (la lista completa está abajo) y guarda.
| Evento | Por qué lo necesita Clakta |
|---|---|
payment.succeeded | Registra la venta. |
payment.processing | Muestra una venta pendiente. |
payment.failed | Registra un intento fallido. |
payment.cancelled | Registra un pago abandonado. |
refund.succeeded | Marca una venta como reembolsada. |
dispute.accepted | Contracargo que aceptaste. |
dispute.lost | Contracargo que perdiste. |
dispute.won | Contracargo que ganaste. |
Marcar eventos de más no hace ningún daño: Clakta ignora lo que no usa.
- Abre la pestaña Overview del endpoint y copia la clave de firma que Dodo
muestra ahí. Empieza por
whsec_.
De vuelta en Clakta:
- Pega la clave de firma y haz clic en Finalizar.
La tarjeta pasa a mostrar Añadida. Las ventas nuevas aparecen a los pocos segundos de pagarse. Las ventas anteriores a la conexión no se importan.
Mostrar los nombres y precios de los productos (opcional)
Por defecto, Clakta registra el dinero y el cliente, pero no qué se compró: los mensajes de Dodo llevan IDs de producto, no nombres.
Para completarlo, añade una clave de API. En Dodo, ve a Developer → API Keys, crea una y pégala en el campo Clave de API (opcional) de la conexión en Clakta. A partir de ahí, Clakta consulta los nombres y precios de los productos de cada venta.
Si te saltas este paso, todo lo demás sigue funcionando: los ingresos, el cliente y el origen se registran igualmente.
Asociar las ventas a los visitantes que las hicieron
Cuando tu código cree el enlace de pago o el checkout de Dodo, añade un campo de
metadata llamado clakta_session_id y pon en él la sesión de Clakta del
visitante:
Lee ese valor en el navegador con clakta.getSessionId() y envíalo a tu
servidor junto con el resto de la petición de checkout.
Modo de prueba y modo de producción
Dodo mantiene separados la prueba y la producción, y Clakta también. Un webhook que crees en modo de prueba solo recibe ventas de prueba.
No pasa nada por tener dos conexiones, una para prueba y otra para producción. Ponles nombres que dejen claro cuál es cuál, porque las dos aparecen en la tarjeta.
Preguntas habituales
Artículos relacionados
Conectar Shopify
Instala la app de Clakta en tu tienda de Shopify. Configura el seguimiento del checkout, importa tus pedidos recientes y asocia cada venta al anuncio que la produjo.
Conectar Lemon Squeezy
Envía a Clakta tus pedidos, renovaciones y reembolsos de Lemon Squeezy mediante un webhook, y acredita cada venta al visitante que la hizo.
Conectar Paddle
Envía a Clakta tus ventas, renovaciones y reembolsos de Paddle mediante un webhook, y acredita cada venta al visitante que la hizo.