Lo que necesitas
| Campo | Que hace |
|---|---|
| API key | Nos permite llamar a Dodo para crear el checkout alojado. Secreto. |
| Webhook signing secret (whsec_…) | Confirma que un webhook realmente proviene de Dodo. Secreto. |
| Return URL | Donde el comprador llega después del checkout. |
Por que pedimos cada campo
API key
Autoriza la creación del checkout alojado, de modo que el cargo se ejecute a través de tu cuenta.
Webhook signing secret
Demuestra que un webhook entrante es genuinamente de Dodo, para que nadie pueda falsificar un evento "pagado". Es un valor separado de la API key.
Return URL
Configuración simple: donde el comprador llega después del checkout. No es secreto.
Configurar
- Abre Developer → Webhooks en Dodo
Inicia sesión en app.dodopayments.com. En la barra lateral izquierda, abre Developer — verás API Keys y Webhooks. Configuramos el webhook primero porque, como Stripe, su secreto de firma existe solo una vez que se crea el endpoint. Usa el alternador Test / Live en la esquina inferior izquierda para elegir el modo que estás configurando; los pasos son idénticos en cada uno.
Dodo → Developer → Webhooks / API Keys - Agrega un endpoint
Abre Webhooks → Endpoints y haz clic en Add Endpoint.
Dodo → Webhooks → Endpoints → Add Endpoint - Copia tu URL de webhook de Coin Moebius
En una pestaña separada, abre tu proyecto en el panel de Coin Moebius y copia el Project ID debajo del nombre del proyecto. Tu URL de webhook de Dodo es ese ID insertado en la dirección a continuación.
https://api.coinmoebius.com/webhook/dodopayments/<your project id>Coin Moebius → tu proyecto → Project ID - Pega la URL y elige tus eventos
De vuelta en Dodo, pega tu URL de webhook en Endpoint URL. En Subscribe to events, elige los eventos que Coin Moebius escucha (o déjalo recibiendo todos los eventos), luego haz clic en Create.
- Pagos únicos: payment.succeeded, payment.failed, payment.cancelled, refund.succeeded, dispute.opened.
- Solo si vendes suscripciones: los eventos subscription.* — subscription.active, subscription.renewed, subscription.failed, subscription.on_hold, subscription.plan_changed, subscription.cancelled, subscription.expired.
Dodo → New Endpoint → Subscribe to events Si no vendes suscripciones, deja sin marcar los eventos de suscripción — no los necesitas. Dejar "recibiendo todos los eventos" también está bien; ignoramos cualquier cosa que no usemos.
- Copia el secreto de firma del endpoint
El nuevo endpoint aparece en tu lista. Ábrelo y copia su Signing Secret (comienza con whsec_…) — lo pegarás en Coin Moebius a continuación.
Dodo → Webhooks → Endpoints (creado) Como Stripe, el secreto de firma existe solo una vez que se crea el endpoint — por eso el webhook vino primero. Agrega un endpoint separado (y copia su secreto) en Test y en Live.
- Abre API Keys
Ahora tu API key. De vuelta bajo Developer, abre API Keys y haz clic en Add API key.
Dodo → Developer → API Keys → Add API key - Nombra la clave (mantén el acceso de escritura activado)
Dale a la clave un nombre como "Coin Moebius", deja marcado Enable write access, y haz clic en Create.
Dodo → Create New API - Copia la API key
Dodo muestra la clave una vez. Cópiala ahora — no podrás verla de nuevo después de cerrar esta ventana.
Dodo → nueva API key (mostrada una vez) - Conecta en el panel de Coin Moebius
En Coin Moebius, abre Providers → Add provider → Dodo Payments, y configura tu Return URL. En la pestaña Live, pega tu API key Live y el secreto de firma de webhook Live, luego haz clic en Save. ¿Verificando primero? Usa la pestaña Test con tu clave de modo test de Dodo y un secreto de webhook de modo test — el grupo Test está emparejado (ambos, o ninguno). Live y test se verifican por separado.
Coin Moebius → Add provider → Dodo Payments - Estás conectado
Dodo Payments ahora aparece en tu pestaña Providers con la fecha en que se conectó y la URL del webhook que espera. Usa Edit para rotar claves o intercambiar live y test; Disconnect lo elimina.
Coin Moebius → Providers → Dodo Payments (conectado) - Venta de suscripciones con Dodo
El botón de compra crea pagos únicos de Dodo. Para facturación recurrente, configura un producto de suscripción en Dodo y usa el checkout de Dodo (un enlace de pago o tu integración de Dodo) para él — Dodo fija precios de planes recurrentes en un producto preconstruido en lugar de sobre la marcha. Siempre que el webhook anterior esté suscrito a los eventos subscription.*, Coin Moebius registra la suscripción y rastreará su ciclo de vida (creada, renovada, pago fallido, cancelada) en tu panel, de la misma manera que lo hace para Square y Authorize.Net.
Despues que conectes
Ejecuta un pago de prueba antes de ir en vivo:
- Crea un producto y configura su Environment en Testing. Eso ejecuta el producto en tus credenciales de prueba, para que puedas hacer un pedido completo sin mover dinero. (Si omitiste el conjunto de prueba, un producto Testing vuelve a live, así que agrégalo primero.)
- Coloca el botón de compra en una página (un archivo HTML local funciona) apuntando a tu proyecto.
- Completa el checkout en el modo de prueba de Dodo.
- Abre la pestaña Transactions. Aparece una nueva fila, etiquetada Testing. Cuando su estado llega a succeeded, tus credenciales y webhook funcionan correctamente de principio a fin.
Cambia el Environment del producto a Live cuando estés listo para pagos reales.
Resolucion de problemas
Comienza con Verify. En el panel, haz clic en Verify (o Verify test credentials) para verificar tu API key.
Verify test credentials dice que no hay credenciales de prueba guardadas.
Agrega una API key de prueba en la pestaña Test, guarda el proveedor, luego reabre el diálogo y verifica.
El pago se completa pero el pedido permanece pendiente.
Confirma que la URL del webhook coincida y que el secreto de firma coincida con el webhook en el mismo ambiente (secreto de prueba para prueba, live para live).
Guardar el grupo Test es rechazado.
El grupo Test está emparejado: agrega tanto una API key de prueba como un secreto de webhook de prueba, o deja ambos en blanco.
Una suscripción de Dodo no aparece o no se actualiza.
Los eventos de suscripción llegan solo si tu endpoint de Dodo está suscrito a los eventos subscription.*, en el mismo ambiente (prueba o live) que la suscripción. Recomprueba la lista de eventos del endpoint, luego reenvía un evento reciente de Dodo para confirmar.
Confirma que funcione de principio a fin.
Dodo Dashboard → Developer → Webhooks → Send Example (o el Dodo CLI) apuntando a tu URL de webhook, luego observa la actualización del pedido.
Bueno saber
Suscripciones. El botón de compra alojado es único. Para facturación recurrente, configura un producto de suscripción en Dodo y suscribe tu webhook a los eventos subscription.*; Coin Moebius normaliza el ciclo de vida de la misma manera que lo hace para Square y Authorize.Net.
Rotación de secretos. Rota la API key o el secreto de webhook en cualquier momento, luego pega el nuevo valor. Los campos secretos permanecen en blanco al editar.
Preguntas Join our Discord