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
Los pagos con otros métodos de pago no tienen redirección automática para pagos aprobados, pero 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"
}