URLs de retorno - Interfaz de usuario - Mercado Pago Developers
¿Qué estás buscando?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos

URLs de retorno

Al final del proceso de pago, es posible redirigir al comprador a otro entorno del sitio a través del atributo back_urls. Este atributo te permite definir las URL a las que se debe redirigir el comprador al completar el pago.

Redirección automática
Si deseas que la redirección para los pagos aprobados sea automática, debes agregar también el atributo auto_return con el valor approved. Por defecto, también se mostrará un botón de "Volver al sitio". El tiempo de redireccionamiento será de 40 segundos.

En las siguientes tablas encontrarás el detalle de cada uno de los posibles parámetros de request y respuesta.

AtributoDescripción
auto_returnLos compradores son redirigidos automáticamente al site cuando se aprueba el pago. El valor predeterminado es approved. El tiempo de redireccionamiento es de 40 segundos y esto no puede ser personalizado.
back_urlsURL de retorno al sitio. Los escenarios posibles son:

success: URL de retorno cuando se aprueba el pago.

pending: URL de retorno cuando el pago está pendiente.

failure: URL de retorno cuando se rechaza el pago.
Importante
No utilices dominios locales en el valor back_urls, tales como 'localhost/' o '127.0.0.1' con o sin puerto especificado. Recomendamos usar un servidor con dominio nombrado (DNS) o IPs de desarrollo para poder regresar al sitio después del pago. De lo contrario, aparecerá el mensaje de "Algo ha salido mal" al finalizar el proceso de compra.

A través de back_urls, se devolverán los siguientes parámetros:

ParámetroDescripción
payment_idID (identificador) del pago de Mercado Pago.
statusStatus del pago. Por ejemplo: approved para un pago aprobado o pending para un pago pendiente.
external_referenceReferencia que puedes sincronizar con tu sistema de pagos.
merchant_order_idID (identificador) de la orden de pago generada en Mercado Pago.

Para definir las back_urls, usa uno de las SDK a continuación que informa las URL a las que se debe dirigir al comprador al finalizar el pago.

Además de los SDK, también es posible configurar back_urls a través de la API de preferencias. Para esto, envía un POST con el atributo back_urls informando las URLs a las que se debe dirigir al comprador al finalizar el pago al endpoint /checkout/preferences y ejecuta el request.
          
<?php
$preference = new MercadoPago\Preference();
//...
$preference->back_urls = array(
    "success" => "https://www.tu-sitio/success",
    "failure" => "http://www.tu-sitio/failure",
    "pending" => "http://www.tu-sitio/pending"
);
$preference->auto_return = "approved";
// ...
?>

        
          
var preference = {}
preference = {
  // ...
  "back_urls": {
        "success": "https://www.tu-sitio/success",
        "failure": "http://www.tu-sitio/failure",
        "pending": "http://www.tu-sitio/pending"
    },
    "auto_return": "approved",
  // ...
}

        
          
PreferenceBackUrlsRequest backUrls =
// ...
   PreferenceBackUrlsRequest.builder()
       .success("https://www.seu-site/success")
       .pending("https://www.seu-site/pending")
       .failure("https://www.seu-site/failure")
       .build();

PreferenceRequest request = PreferenceRequest.builder().backUrls(backUrls).build();
// ...

        
          
# ...
preference_data = {
  # ...
  back_urls = {
    success: 'https://www.tu-sitio/success',
    failure: 'https://www.tu-sitio/failure',
    pending: 'https://www.tu-sitio/pendings'
  },
  auto_return: 'approved'
  # ...
}
# ...

        
          
var request = new PreferenceRequest
{
    // ...
    BackUrls = new PreferenceBackUrlsRequest
    {
        Success = "https://www.tu-sitio/success",
        Failure = "http://www.tu-sitio/failure",
        Pending = "http://www.tu-sitio/pendings",
    },
    AutoReturn = "approved",
};

        
          
preference_data = {
    "back_urls": {
        "success": "https://www.tu-sitio/success",
        "failure": "https://www.tu-sitio/failure",
        "pending": "https://www.tu-sitio/pendings"
    },
    "auto_return": "approved"
}