Antes de comenzar:
Debes tener una cuenta activa en dLocal Go (Sandbox o Producción) y acceso al Dashboard para obtener tus credenciales.
Requisitos técnicos
Antes de instalar el plugin, asegúrate de que tu tienda cumple con lo siguiente:
Requisito | Versión mínima |
WordPress | 5.8 |
WooCommerce | 5.0 |
PHP | 7.4 |
Instalación del plugin
Ingresá al panel de administración de tu sitio WordPress.
Navegá a Plugins > Añadir nuevo.
Descarga desde nuestro enlace oficial el plugin dLocal Go payments for WooCommerce.
Instalá y activá el plugin.
También podés instalarlo desde el enlace oficial de dLocal Go:
👉 https://wordpress.org/plugins/dlocal-go-payments-for-woocommerce/
Obtención de credenciales
Para integrar correctamente el Checkout Redirect, necesitas dos credenciales:
API Key
Secret Key
Estas credenciales son obligatorias y dependen del entorno donde quieras operar.
Entornos y dónde obtener las credenciales:
Sandbox (pruebas):
https://dashboard-sbx.dlocalgo.com/payment-integration
Copiá ambos valores para usarlos en la configuración del plugin.
Configuración del plugin
En el panel de WordPress, andá a WooCommerce > Ajustes > Pagos.
Buscá la opción de dLocal Go payments y entrá a su configuración.
Completá los campos obligatorios:
API Key
Secret Key
Entorno: seleccioná si es Sandbox o Producción según el caso.
Título en el checkout: texto que verán los usuarios al momento de seleccionar el método de pago (opcional).
Guardá los cambios.
Importante: Las credenciales de Sandbox y Producción no son intercambiables. Asegurate de que coincidan con el entorno seleccionado.
Activación del método de pago
Una vez configuradas las credenciales:
Volvé a WooCommerce > Ajustes > Pagos.
Activá el método dLocal Go payments si no está habilitado.
Ajustá el título o descripción según tu preferencia para que se vea en el checkout.
Realizar pruebas en Sandbox
Para verificar que todo está funcionando correctamente:
Asegurate de haber seleccionado el entorno Sandbox en la configuración.
Hacé una compra de prueba en tu tienda, completando el flujo hasta el pago.
Usá los siguientes datos de tarjeta de prueba:
Número: 4111 1111 1111 1111 Fecha de expiración: cualquier fecha futura CVV: cualquier 3 dígitos
Completá el checkout y confirmá que la transacción pasa correctamente por dLocal Go.
Consideraciones importantes
Este plugin solo soporta pagos, no suscripciones automáticas.
No es necesario configurar webhooks para que el checkout funcione.
El método de pago se presenta vía Checkout Redirect, lo que significa que el usuario es redirigido a la página de dLocal Go para completar el pago y luego vuelve a tu sitio. Puedes personalizar el tema del checkout ingresando a: - en el checkout.
Si necesitas ayuda con la integración o encontrás errores durante el proceso, podés contactarnos o revisar otros artículos del Help Center relacionados con WooCommerce y la integración de dLocal Go.