Skip to main content

​
Introducción

El plugin Dodo Payments for WooCommerce añade Dodo Payments como método de pago al checkout de tu tienda. Los clientes pagan en la página de checkout de Dodo Payments, que muestra los métodos de pago disponibles según su ubicación, moneda y dispositivo, como tarjetas, billeteras digitales y UPI. A continuación, los webhook de Dodo Payments actualizan el estado del pedido en WooCommerce.
El plugin requiere WordPress 6.1 o posterior, PHP 7.4 o posterior y WooCommerce 7.9 o posterior. Para vender suscripciones, también necesitas la extensión WooCommerce Subscriptions.
El plugin funciona con el checkout clásico de WooCommerce. No admite el checkout basado en bloques ni el envío de productos físicos, y solo acepta un código de descuento porcentual por pedido.

​
Guía de instalación paso a paso

  1. Descarga dodo-payments-for-woocommerce.zip de la versión más reciente en GitHub.

    Download Plugin

    Obtén la versión más reciente del plugin Dodo Payments para WooCommerce
    También puedes instalar el plugin desde el directorio de plugins de WordPress. En la página Add Plugins, busca Dodo Payments for WooCommerce, haz clic en Install Now, luego en Activate y continúa con la guía de configuración.

    WordPress Plugin Directory

    Instala Dodo Payments for WooCommerce desde WordPress.org
  2. Inicia sesión en tu sitio de WordPress como administrador. WooCommerce debe estar instalado y activo.
  3. Ve a Plugins → Add New Plugin.
    Barra lateral de administración de WordPress con el menú Plugins abierto
  4. Haz clic en Upload Plugin. Aparecerá un formulario de carga.
    Página Add Plugins con el botón Upload Plugin
    Formulario de carga de plugins con un botón Browse y un botón Install Now
  5. Haz clic en Browse… y selecciona el archivo zip que descargaste.
  6. Haz clic en Install Now.
    Formulario de carga de plugins con el archivo zip del plugin seleccionado y el botón Install Now
  7. Cuando termine la instalación, haz clic en Activate Plugin. También puedes activar el plugin más tarde desde Plugins → Installed Plugins.
    Mensaje de instalación correcta del plugin con el botón Activate Plugin
  8. El plugin está instalado, pero aún no está configurado. Continúa con la guía de configuración que aparece a continuación.

​
Guía de configuración

​
Configuración de API Keys y webhook

El plugin necesita dos valores de cada modo de Dodo Payments: una API key para crear checkouts y una webhook signing key para verificar los webhook que actualizan tus pedidos. Estos pasos configuran el modo live.
  1. Ve a WooCommerce → Settings → Payments, o haz clic en Payments dentro de WooCommerce en la barra lateral.
    Configuración de pagos de WooCommerce con Dodo Payments activo y un botón Manage
    Menú de la barra lateral de WooCommerce con Payments resaltado
  2. Activa Dodo Payments si no está activo y, después, haz clic en Manage.
  3. Se abrirá la configuración del plugin, con una descripción debajo de cada opción. Comprueba que Enable Dodo Payments esté seleccionado y empieza con Live API Key.
    Configuración del plugin Dodo Payments con los campos Enable/Disable, Title, Description, Instructions, Test Mode y Live API Key
  4. En el dashboard de Dodo Payments, activa el interruptor Live Mode en la barra lateral. Ve a Developer → API Keys, o usa este enlace directo, y haz clic en Add API key.
    Página API Keys de Dodo Payments sin claves y con un botón Add API key
  5. Introduce un nombre para la clave, como WooCommerce Plugin, y haz clic en Create.
    Diálogo Create New API con el nombre de clave WooCommerce Plugin y un botón Create
  6. Haz clic en Copy API Key. El dashboard muestra la clave una sola vez. Pégala en Live API Key, dentro de la configuración del plugin.
    Diálogo New API key con los botones Copy API Key y Close
    Campo Live API Key en la configuración del plugin
  7. A continuación, configura la clave de firma del webhook. Dodo Payments envía actualizaciones de pagos a tu tienda mediante un webhook, y el plugin usa la clave para verificar que cada webhook proviene de Dodo Payments.
  8. En la parte inferior de la configuración del plugin, debajo de Webhook Endpoint, copia la URL. Tiene el formato https://your-store.com/?wc-api=dodo_payments.
    URL de Webhook Endpoint en la parte inferior de la configuración del plugin, encima del botón Save changes
  9. En el dashboard de Dodo Payments, todavía en modo live, ve a Developer → Webhooks y haz clic en Add endpoint.
    Página Webhooks en modo live, sin endpoints y con un botón Add endpoint
  10. Pega la URL del paso 8 en Endpoint URL. Deja Subscribed events vacío para recibir todos los eventos, o selecciona solo los eventos de pagos, reembolsos y suscripciones, que son los eventos que gestiona el plugin. Después, haz clic en Create endpoint.
    Diálogo Add endpoint con la URL del webhook de WooCommerce en Endpoint URL
  11. Se abrirá la pestaña Overview del endpoint. En Signing secret, haz clic en el icono del ojo para mostrar el secreto y, después, haz clic en el icono de copia.
    Pestaña Overview del endpoint con el secreto de firma oculto, los iconos para mostrar y copiar, y Rotate secret
  12. Pega el secreto en Live Webhook Signing Key, dentro de la configuración del plugin, y haz clic en Save changes.
    Campo Live Webhook Signing Key en la configuración del plugin
  13. Revisa Global Tax Category y All Prices are Tax Inclusive. El plugin las aplica cuando crea un producto en Dodo Payments, lo que ocurre la primera vez que un cliente realiza el checkout con el producto. Después, el producto conserva la configuración de impuestos que tiene en el dashboard de Dodo Payments, donde puedes cambiarla por producto. Test API Key y Test Webhook Signing Key solo son necesarias para Test Mode.
    Configuración de Test API Key, Test Webhook Signing Key, Global Tax Category y All Prices are Tax Inclusive
En Checkout Feature Flags, también puedes controlar opciones de la página de checkout de Dodo Payments, como Allow Currency Selection y Allow Discount Codes. Un indicador establecido en Default no se envía, por lo que Dodo Payments aplica su propio valor predeterminado.
Para realizar pagos de prueba, activa Test Mode en la configuración del plugin. El plugin usará Test API Key y Test Webhook Signing Key, y se conectará al entorno de pruebas de Dodo Payments. El modo de prueba tiene sus propias claves de API y endpoints de webhook. Para obtenerlas, desactiva el interruptor Live Mode en el dashboard, sigue los pasos del 4 al 12 en modo de prueba y pega los valores en los campos de prueba. Desactiva Test Mode antes de pasar al entorno live.

​
¡Ya está todo listo!

Los clientes ya pueden elegir Dodo Payments durante el checkout.
Página de checkout de WooCommerce con el formulario de facturación y el botón Place order
Cuando un cliente realiza un pedido, el plugin lo envía a la página de checkout de Dodo Payments para pagar. Después del pago, Dodo Payments envía un webhook y el plugin actualiza el estado del pedido.
Página de checkout de Dodo Payments con opciones de pago con tarjeta, código QR de UPI e ID de UPI

​
Funciones principales

  • Hosted Checkout: Los clientes pagan en una página de checkout de Dodo Payments y después vuelven a la página de confirmación del pedido de tu tienda.
  • Multiple Payment Methods: El checkout muestra los métodos de pago disponibles según la ubicación, la moneda y el dispositivo de cada cliente.
  • Order Status Sync: Los webhooks establecen el pedido como Completed, Processing, Failed o Cancelled a medida que cambia el estado del pago. Los pagos fallidos y cancelados devuelven los artículos al inventario.
  • Refunds: Emite reembolsos desde el dashboard de Dodo Payments. Cuando un reembolso se completa correctamente, el plugin establece el pedido como Refunded.
  • Subscriptions: Con WooCommerce Subscriptions, los cambios de estado se sincronizan en ambas direcciones, incluso cuando una suscripción se cancela, se suspende o se reactiva. Los cambios en las fechas de suscripción en WooCommerce no se sincronizan.
  • Order Notes: El plugin añade notas del pedido para cada sesión de checkout, cambio de estado y error, para que puedas seguir cada pago desde la página del pedido.
  • Multi-currency Support: Los productos se sincronizan con Dodo Payments en la moneda de tu tienda de WooCommerce. El indicador Allow Currency Selection controla si los clientes pueden cambiar la moneda durante el checkout.

​
Solución de problemas

​
Problemas comunes

  1. Payment Processing Failures
    • Comprueba que la API key coincida con el modo del plugin. Con Test Mode desactivado, el plugin usa Live API Key, que debe proceder del dashboard en modo live. Con Test Mode activado, usa Test API Key.
    • Comprueba las notas del pedido. Cuando el plugin no puede crear un checkout, añade una nota con el error, como una que comienza por Dodo Payments Error:.
    • Si Dodo Payments no aparece durante el checkout, comprueba que la página de checkout use el checkout clásico y no el bloque Checkout.
    • Si el pedido tiene un código de descuento, comprueba que sea un código de porcentaje único.
    • Los pagos live comienzan después de que tu cuenta supere la verificación de la cuenta.
  2. Webhook Synchronization Problems
    • Comprueba que Endpoint URL sea exactamente la URL que aparece debajo de Webhook Endpoint en la configuración del plugin.
    • Comprueba que la clave de firma del plugin coincida con Signing secret del endpoint y que ambas procedan del mismo modo.
    • Comprueba el registro de errores de PHP para ver las líneas que comienzan por Dodo Payments:, como Dodo Payments: Could not verify webhook event. En modo live, el plugin devuelve 200 incluso cuando la verificación falla, por lo que los registros de Dodo Payments muestran la entrega como correcta. En Test Mode, devuelve 401.
    • Comprueba que tu sitio tenga un certificado SSL válido. Endpoint URL solo acepta URLs HTTPS.
    • Comprueba que tu servidor, firewall y plugins de seguridad acepten solicitudes POST a la URL del webhook desde las direcciones IP de Dodo Payments.
    • Abre la pestaña Logs en Developer → Webhooks para ver cada entrega y la respuesta de tu sitio.

​
Recursos de soporte

Para obtener más ayuda:

​
Prácticas recomendadas de mantenimiento

  1. Actualiza el plugin cuando se publique una nueva versión para obtener correcciones de seguridad y nuevas funciones.
  2. Prueba todos los flujos de pago en Test Mode antes de aceptar pagos live.
  3. Mantén WordPress y WooCommerce actualizados.
  4. Haz copias de seguridad de tu sitio con regularidad.
  5. Supervisa tus pedidos y el dashboard de Dodo Payments para detectar actividad inusual.
  6. Guarda las API keys de forma segura y nunca las compartas públicamente.
Última modificación el 26 de septiembre de 2026