Inicio
Documentación
Recursos
Certificaciones
Comunidad
URLs de retorno - Interfaz de usuario - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

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 5 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"
}