Redirecionamento após o pagamento
Redirecione o cliente de volta para a sua aplicação depois de um pagamento bem sucedido em nossa fatura
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 oinvoiceUrl
.
Você também poderá atualizar uma Cobrança enviando os mesmos atributos no endpoint de atualização de cobrança.
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.
Você também poderá atualizar um Link de Pagamento enviando os mesmos atributos no endpoint de atualização de link de pagamento.
Updated 6 months ago