URLs de retorno
Ao final do processo de pagamento, é possível redirecionar o comprador novamente para o seu site através do atributo back_urls. Este atributo permite definir as URLs para onde o comprador deverá ser redirecionado segundo o status do pagamento.
Redirecionamento automático
Caso queira que o redirecionamento para os pagamentos aprovados seja automático, sem a renderização de um botão de retorno, é preciso adicionar também o atributo
auto_return com valor approved. O tempo de redirecionamento será de 40 segundos.Nas tabelas a seguir você encontra o detalhe de cada um dos possíveis parâmetros de requisição e de resposta.
| Atributo | Descrição |
auto_return | Os compradores são redirecionados automaticamente para o site quando o pagamento é aprovado. O valor padrão é approved. O tempo de redirecionamento é de 40 segundos e não pode ser personalizado. |
back_urls | URL de retorno ao site. Possíveis cenários são:success: URL de retorno perante pagamento aprovado.pending: URL de retorno perante pagamento pendente.failure: URL de retorno perante pagamento rejeitado. |
Importante
Não utilize domínios locais no valor
back_urls, como 'localhost/' ou '127.0.0.1' com ou sem porta especificada. Recomendamos usar um servidor com um domínio nomeado (DNS) ou IPs de desenvolvimento para poder retornar ao site após o pagamento. Caso contrário, aparecerá a mensagem "Alguma coisa deu errado" ao finalizar o processo de compra.Através das back_urls, serão retornados os seguintes parâmetros:
| Parâmetro | Descrição |
payment_id | ID (identificador) do pagamento do Mercado Pago. |
status | Status do pagamento. Ex.: approved para um pagamento aprovado ou pending para um pagamento pendente. |
external_reference | Valor enviado no momento da criação da preferência de pagamento. |
merchant_order_id | ID (identificador) da ordem de pagamento gerada no Mercado Pago. |
Para definir as back_urls, utilize um dos SDKs abaixo informando as URLs para onde o comprador deverá ser direcionado quando finalizar o pagamento.
Além dos SDKs, também é possível definir as
back_urlsatravés da API de preferências. Para isso, envie um POST com o atributo back_urls informando as URLs para onde o comprador deverá ser direcionado quando finalizar o pagamento ao endpoint
/checkout/preferences
e execute a requisição.
<?php
$preference = new MercadoPago\Preference();
//...
$preference->back_urls = array(
"success" => "https://www.seu-site/success",
"failure" => "http://www.seu-site/failure",
"pending" => "http://www.seu-site/pending"
);
$preference->auto_return = "approved";
// ...
?>
var preference = {}
preference = {
// ...
"back_urls": {
"success": "https://www.seu-site/success",
"failure": "http://www.seu-site/failure",
"pending": "http://www.seu-site/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"
}