Inicio
Documentação
Recursos
Parcerias
Comunidade

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

URLs de retorno - Interface de usuário - Mercado Pago Developers

Busca inteligente powered by OpenAI 

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.

Redirecionamento automático
Caso queira que o redirecionamento para os pagamentos aprovados com cartão de crédito seja automático, é preciso adicionar também o atributo auto_return com valor approved. Por padrão, também será exibido um botão de "Voltar ao site". O tempo de redirecionamento será de até 40 segundos..

Pagamentos com outros meios de pagamento não possuem o redirecionamento automático para pagamentos aprovados, mas o atributo back_urls poderá ser configurado e utilizado a partir do botão de "Voltar ao site".

Na tabela a seguir você encontra o detalhe de cada um dos possíveis parâmetros de requisição e de resposta.

AtributoDescrição
auto_returnOs 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_urlsURL 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âmetroDescrição
payment_idID (identificador) do pagamento do Mercado Pago.
statusStatus do pagamento. Ex.: approved para um pagamento aprovado ou pending para um pagamento pendente.
external_referenceReferência que pode sincronizar com seu sistema de pagamentos.
merchant_order_idID (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"
}