Profesional trabajando en una laptop moderna con una pantalla que muestra una confirmación de pago exitosa en una interfaz de checkout limpia y minima
Configurar la redirección después del pago en Checkout de Mercado Pago permite que cada cliente regrese a tu sitio con un mensaje acorde al resultado de su transacción. Aquí encontrarás los pasos de configuración, la implementación técnica y las pruebas necesarias para lograrlo.
Para redireccionar al cliente después del pago en Checkout Pro de Mercado Pago, debes definir las URLs de retorno (conocidas como back_urls) dentro de la preferencia de pago, ya sea desde el panel de configuración del plugin o a través de la API. Existen tres URLs de retorno: una para pagos aprobados, otra para pagos rechazados y una más para pagos pendientes. Cada una lleva al comprador a una página diferente de tu sitio según el resultado de la transacción.
A lo largo de este artículo encontrarás los requisitos previos para empezar, la configuración paso a paso tanto desde WooCommerce como desde la API, cómo probar que la redirección funcione en los tres escenarios, qué contenido conviene incluir en cada página de destino y cómo resolver los errores más comunes que pueden aparecer en el proceso.
Espacio de trabajo organizado con una computadora de escritorio mostrando credenciales de API y documentación técnica en pantalla, documentos y una ta
Qué necesitas antes de configurar la redirección en Checkout de Mercado Pago
Antes de tocar cualquier configuración, es necesario contar con una cuenta de Mercado Pago activa y con credenciales de producción generadas desde el panel de desarrolladores. Sin estas credenciales, cualquier integración que realices solo funcionará en el entorno de pruebas.
También debes tener un sitio web donde alojar las páginas de destino. Estas páginas deben estar publicadas y accesibles antes de registrar sus URLs en la configuración, ya que Mercado Pago intentará redirigir al comprador a esas direcciones en cuanto termine el pago.
Por último, necesitas tener Checkout Pro habilitado en tu sitio. Esto puede hacerse a través de una integración propia con la API de Mercado Pago o mediante un plugin como WooCommerce. El método de configuración de las URLs de retorno varía según cuál de los dos caminos hayas elegido.
Cómo configurar las URLs de redirección en Checkout Pro de Mercado Pago
Existen dos caminos principales para definir a dónde regresa cada cliente después de pagar: desde el panel de un plugin como WooCommerce o desde la API de Mercado Pago al crear la preferencia de pago. El método depende de cómo se haya integrado el checkout en tu sitio.
Configuración desde el panel de WooCommerce
Si tu tienda usa el plugin oficial de Mercado Pago para WooCommerce, la configuración de las URLs de redirección se realiza desde el panel de administración sin necesidad de escribir código.
- Accede a tu panel de WordPress y ve a WooCommerce > Mercado Pago.
- Selecciona la opción Checkout Pro y haz clic en "Configurar".
- Desplázate hasta la sección Configuraciones avanzadas.
- Localiza los campos: URL de éxito, URL de pago rechazado y URL de pago pendiente.
- Ingresa en cada campo la dirección de la página correspondiente de tu sitio.
- Asegúrate de que la opción "Volver a la tienda" esté activada. Sin esta opción habilitada, la redirección no se ejecuta de forma automática y el comprador permanece en la pantalla de Mercado Pago.
- Guarda los cambios.
Esta opción es la más accesible para quienes administran su tienda sin conocimientos técnicos profundos. Sin embargo, su nivel de personalización es más limitado que el que ofrece la API.
Configuración desde la API al crear la preferencia de pago
Para quienes integran Checkout Pro con código propio, las URLs de retorno se definen dentro del objeto de preferencia que se envía a la API de Mercado Pago al momento de crear el pago.
- Al construir el cuerpo de la solicitud para crear la preferencia, incluye el objeto back_urls.
- Dentro de ese objeto, define tres propiedades: success (para pagos aprobados), failure (para pagos rechazados) y pending (para pagos en revisión). El valor de cada propiedad es la URL de la página correspondiente en tu sitio.
- Agrega también el parámetro auto_return con el valor "approved" si deseas que la redirección ocurra de forma automática solo para pagos aprobados. Si quieres que ocurra también en otros estados, usa el valor "all".
- Envía la solicitud a la API y usa el enlace de pago generado para redirigir al comprador al checkout.
El parámetro auto_return es el que activa la redirección sin que el comprador tenga que hacer clic en ningún botón. Si no se incluye, la persona verá un botón para regresar al sitio, pero no será llevada de forma automática.
Cómo probar que la redirección después del pago funcione
Antes de activar la integración en producción, conviene verificar cada flujo de redirección en el entorno sandbox de Mercado Pago. Para esto, debes usar las credenciales de prueba disponibles en el panel de desarrolladores y tarjetas de test que simulan distintos resultados de pago.
Cada escenario debe probarse por separado. Usa una tarjeta de test que genere un pago aprobado y verifica que la URL de éxito cargue de forma correcta. Luego repite el proceso con una tarjeta que simule un rechazo y otra que genere un pago pendiente. Si alguna de las páginas no carga, revisa que la URL esté bien escrita y que la página esté publicada.
Un detalle que vale la pena aprovechar durante las pruebas es revisar los parámetros que Mercado Pago agrega a la URL de retorno. Al redirigir al comprador, la app incluye datos como collection_status, payment_id y merchant_order_id en la dirección de la página. Con esa información, tu sitio puede mostrar un mensaje personalizado con el número de pedido o el estado del pago, sin necesidad de consultas adicionales.
Vista cercana de un monitor mostrando un panel de administración de configuración de pagos con campos de URL y opciones de redirección, interfaz limpi
Qué incluir en cada página de destino según el resultado del pago
Cada resultado de pago requiere una página de destino con información distinta. El contenido de esa página influye en la confianza de quien compra y puede reducir consultas al equipo de soporte.
Página de pago aprobado
Esta es la página que más impacto tiene en la percepción de la tienda. Un mensaje claro y completo genera confianza y reduce la incertidumbre del comprador.
Elementos recomendados para esta página:
- Mensaje de confirmación que indique que el pago fue procesado con éxito.
- Número de pedido o referencia de la transacción.
- Resumen del monto pagado y los productos o servicios adquiridos.
- Enlace para rastrear el envío o consultar el estado del pedido.
- Botón para volver a la tienda o explorar más productos.
Página de pago rechazado
Cuando un pago no se procesa, la experiencia post-pago puede marcar la diferencia entre perder a un comprador o recuperarlo. Una página bien diseñada para este escenario ofrece una salida clara.
Elementos recomendados para esta página:
- Mensaje que explique, sin tecnicismos, que el pago no se completó.
- Sugerencia de verificar los datos de la tarjeta o intentar con otro método de pago.
- Botón para reintentar el pago o regresar al carrito.
- Enlace de contacto o canal de atención para quienes necesiten ayuda.
Página de pago pendiente
Los pagos pendientes suelen generar más dudas que los rechazados, porque el comprador no sabe con certeza si su pedido quedó registrado. Una comunicación clara en este punto reduce la ansiedad y las consultas de soporte.
Elementos recomendados para esta página:
- Aviso de que el pago está en proceso de revisión y que el pedido fue recibido.
- Tiempo estimado de resolución según el método de pago utilizado.
- Instrucción sobre qué hacer si el pago no se confirma en ese plazo.
- Canal de comunicación (correo, chat o teléfono) para resolver dudas.
Más allá del contenido, las tres páginas de destino deben mantener coherencia visual con la tienda. El uso del mismo logotipo, colores y tipografía refuerza la sensación de que el comprador sigue dentro de un entorno seguro y conocido.
Errores comunes en la redirección de Checkout de Mercado Pago y cómo resolverlos
La mayoría de los problemas con la redirección tienen causas puntuales y soluciones concretas. Identificar el error con precisión ahorra tiempo y evita ajustes innecesarios en la configuración.
Los errores más frecuentes son:
- auto_return no configurado: La redirección no ocurre de forma automática porque falta este parámetro en la preferencia. La solución es agregarlo con el valor "approved" o "all" según el comportamiento deseado.
- URL de retorno con error 404: La página de destino no existe o la ruta está mal escrita. Conviene verificar que la página esté publicada y que la URL no tenga errores tipográficos ni barras faltantes.
- Credenciales de prueba en producción: La redirección funciona en sandbox pero no en el entorno real porque se siguen usando las credenciales de prueba. La solución es reemplazarlas por las credenciales de producción en la configuración del plugin o en el código de integración.
- Opción "Volver a la tienda" desactivada en WooCommerce: El comprador permanece en la pantalla de Mercado Pago porque esta opción no está habilitada. Basta con activarla desde las configuraciones avanzadas del plugin para que la redirección funcione.
Revisar estos cuatro puntos cubre la gran mayoría de los casos reportados. Si el problema persiste después de verificarlos, conviene consultar los registros de error del servidor y los logs del plugin para identificar si hay un problema de conectividad o de configuración en el servidor.
Preguntas frecuentes sobre la redirección en Checkout de Mercado Pago
¿Se puede usar una misma URL de redirección para los tres estados de pago?
Sí, es posible definir una sola URL para los tres estados y diferenciar el contenido de la página usando los parámetros que Mercado Pago agrega al retorno, como collection_status. Sin embargo, usar URLs separadas permite personalizar mejor la experiencia de cada escenario y hace más claro el mensaje para quien compra.
¿La redirección funciona en dispositivos móviles?
Sí, la redirección opera de la misma forma en navegadores móviles y de escritorio. Lo que sí conviene verificar es que las páginas de destino tengan diseño responsivo, para que la experiencia sea adecuada sin importar el dispositivo que use el comprador.
¿Qué pasa si no configuro las URLs de retorno?
Si no se definen las URLs de retorno, el comprador permanece en la pantalla de confirmación de Mercado Pago y no regresa a tu sitio de forma automática. Esto puede generar confusión sobre el estado del pedido y aumentar las consultas al equipo de soporte.
¿Puedo personalizar la información que aparece en la URL de retorno?
Mercado Pago agrega parámetros como payment_id, status y merchant_order_id a la URL de retorno. Con esos datos, tu sitio puede mostrar información personalizada del pedido en la página de destino, como el número de orden o el monto pagado, sin necesidad de hacer consultas adicionales a la API.
Quienes busquen profundizar en la integración de Checkout Pro pueden consultar la documentación oficial de Mercado Pago para desarrolladores, donde se detallan todas las propiedades disponibles en la preferencia de pago. Además, la app de Mercado Pago ofrece herramientas de cobro adicionales —como links de pago y transferencias— que pueden complementar la experiencia de venta en línea según las necesidades de cada negocio.
¡Aplican restricciones! Consulta más información sobre productos y promociones en: https://mpago.li/2MdeJDh