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, automaticamente (auto_return
) ou através do botão "Voltar ao site", segundo o status do pagamento.
Na tabela 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 com cartão de crédito é aprovado. O valor padrão é approved . O tempo de redirecionamento será de até 40 segundos e não poderá 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. |
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 | Referência que pode sincronizar com seu sistema de pagamentos. |
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.
back_urls
atravé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"
}