Back URLs - User interface - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps

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.

Important
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. Also, the auto_return attribute only works for Checkout Pro's redirect and mobile mode. The same does not work in modal mode, since the buyer remains on the site during the entire payment process.

In the following tables you will find the details of each of the possible request and response parameters.

AttributeDescription
auto_returnBuyers are automatically redirected to site when payment is approved. The default value is approved.
back_urlsReturn 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.

Through the back_urls, the following parameters will be returned:

ParameterDescription
payment_idID (identifier) of the Mercado Pago payment.
statusPayment status. Eg: approved for an approved payment or pending for a pending payment.
external_referenceAmount sent when creating the payment preference.
merchant_order_idID (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"
}