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.
En las siguientes tablas 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 es de 40 segundos y esto no puede 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. |
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.
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"
}