Back URLs
At the end of the payment process, it is possible to redirect the buyer back to your website via the back_urls attribute. This attribute allows you to define the URLs where the buyer should be redirected according to the payment status.
Automatic redirection
If you want the redirection for approved payments to be automatic, without rendering a return button, you must also add the
auto_return attribute with the value approved. The redirect time will be 40 seconds.In the following tables you will find the details of each of the possible request and response parameters.
| Attribute | Description |
auto_return | Buyers are automatically redirected to site when payment is approved. The default value is approved. The redirect time is 40 seconds and this cannot be customized. |
back_urls | Return URL to the site. Possible scenarios are:success: Return URL when payment is approved.pending: Return URL when payment is pending.failure: Return URL when payment is rejected. |
Important
Do not use local domains in the
back_urls value, such as 'localhost/' or '127.0.0.1' with or without a specified port. We recommend using a server with a named domain (DNS) or development IPs to be able to return to the site after payment. Otherwise, the "Something went wrong" message will appear when the purchase process is completed.Through the back_urls, the following parameters will be returned:
| Parameter | Description |
payment_id | ID (identifier) of the Mercado Pago payment. |
status | Payment status. Eg: approved for an approved payment or pending for a pending payment. |
external_reference | Amount sent when creating the payment preference. |
merchant_order_id | ID (identifier) of the payment order generated in Mercado Pago. |
To define the back_urls, use one of the SDKs below informing the URLs where the buyer should be directed when finalizing the payment.
In addition to the SDKs, it is also possible to set the
back_urls through the preferences API. To do so, send a POST with the back_urls attribute informing the URLs where the buyer should be directed when finalizing the payment to the endpoint
/checkout/preferences
and execute the request.
<?php
$preference = new MercadoPago\Preference();
//...
$preference->back_urls = array(
"success" => "https://www.your-website/success",
"failure" => "http://www.your-website/failure",
"pending" => "http://www.your-website/pending"
);
$preference->auto_return = "approved";
// ...
?>
var preference = {}
preference = {
// ...
"back_urls": {
"success": "https://www.your-website/success",
"failure": "http://www.your-website/failure",
"pending": "http://www.your-website/pending"
},
"auto_return": "approved",
// ...
}
PreferenceBackUrlsRequest backUrls =
// ...
PreferenceBackUrlsRequest.builder()
.success("https://www.your-website/success")
.pending("https://www.your-website/pending")
.failure("https://www.your-website/failure")
.build();
PreferenceRequest request = PreferenceRequest.builder().backUrls(backUrls).build();
// ...
# ...
preference_data = {
# ...
back_urls = {
success: 'https://www.your-website/success',
failure: 'https://www.your-website/failure',
pending: 'https://www.your-website/pendings'
},
auto_return: 'approved'
# ...
}
# ...
var request = new PreferenceRequest
{
// ...
BackUrls = new PreferenceBackUrlsRequest
{
Success = "https://www.your-website/success",
Failure = "http://www.your-website/failure",
Pending = "http://www.your-website/pendings",
},
AutoReturn = "approved",
};
preference_data = {
"back_urls": {
"success": "https://www.your-website/success",
"failure": "https://www.your-website/failure",
"pending": "https://www.your-website/pendings"
},
"auto_return": "approved"
}