Redirecionamento após o pagamento

Utilizando a URL de Retorno, é possível que o pagamento seja processado completamente na interface do Asaas, com seu cliente sendo redirecionado de volta para o seu site após a conclusão do pagamento.

A URL de Retorno funciona com cobranças, links de pagamento e assinaturas, sendo possível escolher entre redirecionamento automático autoRedirect ou não. Caso não seja escolhido o redirecionamento automático, após a conclusão do pagamento pelo seu cliente, um botão com o texto “Ir para o site” será mostrado.

O autoRedirect funciona para pagamentos via cartão de crédito, cartão de débito (somente na fatura) e Pix, pois são os meios de pagamentos que permitem confirmação de pagamento instantânea.

A URL informada deve ser obrigatoriamente do mesmo domínio cadastrado em seus dados comerciais, que você encontra em "Configurações da conta" na aba "Informações".

Criando uma fatura com redirecionamento automático

A forma de criação de cobrança é a mesma, sendo apenas necessário um atributo adicional, o callback. Caso ele seja informado, sua cobrança estará configurada para enviar o cliente de volta ao seu site após o pagamento.

POST /v3/payments
Confira a referência completa deste endpoint

{
  "customer": "cus_000005219613",
  "billingType": "PIX",
  "value": 2000.00,
  "dueDate": "2023-07-21",
  "callback":{
    "successUrl": "https://seusite.com/redirect",
    "autoRedirect": false // somente enviar em caso de desativação do redirect automatico
  }
}

📘
Caso você tenha definido o autoRedirect comofalse um botão com o texto "Ir para o site" será exibido para o seu cliente após a conclusão do pagamento.

Após criar uma cobrança com URL de Retorno, você pode redirecionar seu cliente para a URL no atributo invoiceUrl do JSON de resposta. No momento que o pagamento for concluído, ele será enviado para a URL que você definiu.

Caso o cliente acesse novamente o link da fatura (invoiceUrl) em outro momento, ele não será mais redirecionado para o seu site pois o pagamento já terá sido concluído anteriormente. Neste caso, ele verá apenas uma fatura paga.

📘
Você pode informar o parâmetro ?autoRedirect=true na URL da fatura caso queira que o usuário seja sempre redirecionado quando acessar o invoiceUrl.

Você também poderá atualizar uma Cobrança enviando os mesmos atributos no endpoint de atualização de cobrança.

Uma tela com um carregamento de 5 segundos é mosrada ao cliente ao realizar o pagamento com sucesso.

Criando um link de pagamento com redirecionamento automático

Da mesma forma, é possível criar um link de pagamento que, ao sucesso do pagamento, redireciona o cliente ao link informado.

POST /v3/paymentLinks
Confira a referência completa deste endpoint

{
  "name": "Meu link da pagamento",
  "billingType": "UNDEFINED",
  "value": 2000.00,
  "chargeType": "DETACHED",
  "callback":{
    "successUrl": "https://seusite.com/redirect",
    "autoRedirect": false // somente enviar em caso de desativação do redirect automatico
  }
}

📘
Da mesma forma que na fatura, caso você tenha definido o autoRedirect comofalse um botão com a mensagem "ir para o site" será mostrado na tela de pagamento aprovado.

Após criar o Link de Pagamento com URL de sucesso, você pode redirecionar seu cliente a url retornada. No momento que o pagamento for confirmado, ele será enviado para a URL que você definiu.

Exemplo de botão de retorno no link de pagamento quando o `autoRedirect `é desativado. — Exemplo de botão de retorno no link de pagamento quando o `autoRedirect` é desativado.

Você também poderá atualizar um Link de Pagamento enviando os mesmos atributos no endpoint de atualização de link de pagamento.