URLs de retorno

Al final del proceso de pago con tarjeta de crédito, es posible redirigir al comprador a otro entorno del sitio a través del atributo back_urls. Este atributo permite definir las URLs a las que el comprador será redirigido, ya sea automáticamente (auto_return) o a través del botón "Volver al sitio", según el estado del pago.

Redirección automática

Si deseas que la redirección para los pagos aprobados con tarjeta de crédito 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 hasta 40 segundos.

Los pagos con otros métodos de pago no tienen redirección automática para pagos aprobados, pero el atributo back_urls se podrá configurar y utilizar a través del botón de "Volver al sitio".

E la siguiente tabla encontrarás el detalle de cada uno de los posibles parámetros de request y respuesta.

Atributo	Descripción
`auto_return`	Los compradores son redirigidos automáticamente al site cuando se aprueba el pago. El valor predeterminado es `approved`. El tiempo de redireccionamiento será de hasta 40 segundos y no podrá ser personalizado.
`back_urls`	URL 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ámetro	Descripción
`payment_id`	ID (identificador) del pago de Mercado Pago.
`status`	Status del pago. Por ejemplo: `approved` para un pago aprobado o `pending` para un pago pendiente.
`external_reference`	Referencia que puedes sincronizar con tu sistema de pagos.
`merchant_order_id`	ID (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"
}

Cambiar estilo de color

Aprende a personalizar el estilo de color de su interfaz y personaliza la forma en que se mostrará al usuario.

Callbacks auxiliares

Vea cómo agregar callbacks que se ejecutarán en momentos específicos en el flujo de pago.

Documentación

¿Comenzando ahora?

Recursos

Soporte

Comunidad

URLs de retorno

Navegación

Recursos y Comunidad

Mercado Pago

País e idioma