Integração de Pagamentos (Gateway)
Para que seus clientes possam comprar pacotes e realizar o pagamento de forma totalmente automática diretamente pelo seu site, é fundamental configurar um Gateway de Pagamento.
No momento, o Avoei possui integração direta e exclusiva com o Asaas, uma das plataformas de cobrança mais práticas e seguras do mercado. (Já estamos trabalhando para disponibilizar novas opções de integração no futuro!).
E se eu não quiser configurar o Asaas agora? Não tem problema. Caso você não tenha um gateway configurado, o sistema funcionará no modo de venda manual. Na página da sua viagem, o botão de compra redirecionará o cliente para o WhatsApp da sua empresa, onde você poderá fechar a venda e registrar o pagamento manualmente no painel.
Com o gateway configurado: O cliente escolhe a viagem, preenche os dados e realiza o pagamento diretamente pelo seu site, e a reserva é confirmada automaticamente no sistema.
Esta página configura como os seus clientes pagam você. Se você está procurando informações sobre a cobrança da sua própria mensalidade do sistema Avoei, veja a página Assinatura.
Como configurar o seu Gateway (Asaas)
Para adicionar a integração, acesse o menu de configurações financeiras, vá até Pagamentos Gateway e clique no botão azul "Criar Pagamento Gateway".
Se você ainda não tem uma conta no Asaas, você encontrará um link no aviso amarelo no topo da tela para criar o seu cadastro rapidamente.
Preencha os campos da seguinte forma:
1. Configurações Gerais
- Modo Sandbox (Ambiente de Teste): Ative essa opção apenas se você estiver usando um token de teste do Asaas para simular pagamentos sem gerar cobranças reais. Para vendas reais, deixe desativado.
- Ativo: Define se essa integração está ligada e pronta para uso.
- Padrão: Se você tiver mais de um gateway cadastrado (ex: um de teste e um oficial), marque esta opção no gateway que deve ser usado como o principal nas suas vendas.
- Gateway: Selecione "Asaas".
- Nome: Dê um nome para identificar essa integração no seu painel (Ex: "Asaas Oficial").
- Token: Cole aqui a sua chave de API (API Key) gerada dentro do painel do Asaas. É essa chave que conecta o Avoei à sua conta bancária.
Onde encontrar o Token (Chave de API) no Asaas?
O Token (ou Chave de API) é o código de segurança que permite ao Avoei se comunicar com a sua conta bancária no Asaas para gerar as cobranças e identificar pagamentos.
Para gerar esse token, você precisará acessar o painel da sua conta diretamente no site do Asaas e seguir os passos abaixo:
- Acesse o painel do Asaas e faça o login com as suas credenciais.
- No canto superior direito da tela, clique no ícone do seu perfil (ou vá no menu lateral em "Minha Conta").
- Selecione a opção Integrações.
- Acesse a aba Chaves de API (sinalizada por um ícone de chave).
- Clique no botão azul "Gerar chave de API".
- Dê um nome para identificar a chave (exemplo: "Integração Avoei"). Recomendamos deixar o campo de "Data de expiração" em branco para que o token não pare de funcionar no futuro.
- Clique em Avançar. O Asaas pedirá uma validação de segurança (geralmente enviando um código via SMS ou pedindo o token do App).
- Após a validação, a sua Chave de API será gerada. Clique em Copiar.
Com o Token copiado, volte para a tela do sistema Avoei, cole esse código longo no campo "Token" da configuração do Gateway e clique em "Criar" para salvar.
Por questões de segurança, o Asaas exibe o código do token completo apenas no momento em que ele é gerado. Depois disso, não é possível visualizá-lo novamente. Se você perder esse código, será necessário excluir a chave antiga no Asaas e gerar um novo token.
O Asaas permite que você crie múltiplas chaves de API. Portanto, se você for usar o Avoei simultaneamente com outro sistema, não há problema: basta gerar uma chave exclusiva para o Avoei, garantindo mais organização e segurança.
2. Formas de pagamento aceitas
Diferente do que você pode imaginar, Cartão, Pix e Boleto não vêm todos juntos numa única chave. Cada forma de pagamento tem seu próprio interruptor (Permitir pagamentos em cartão de crédito, Permitir pagamentos em Pix, Permitir pagamentos em Boleto), então você decide exatamente quais opções o seu cliente vê na hora de fechar a compra. Pelo menos uma precisa estar ativa para que a venda automática funcione.
Cartão de crédito
Ative Permitir pagamentos em cartão de crédito para que o cliente possa pagar com cartão diretamente no site. Com essa opção ligada, você também pode ativar Permitir parcelamento, o que abre a seção Configurações de parcelamento:
- Valor mínimo por parcela: Defina qual é o valor mínimo que uma parcela pode ter (o sistema já vem com um mínimo sugerido de R$ 10,00).
- Quantidade de parcelamentos sem juros: Defina até quantas vezes o seu cliente pode parcelar sem que o sistema adicione juros (por padrão, nenhuma parcela é isenta de juros).
- Quantidade máxima de parcelas: Defina o limite máximo de meses que o cliente pode dividir o pagamento (Ex: 12x). Por padrão, o sistema vem configurado para não parcelar (1x) até que você ajuste esse número.
- Taxa de juros (%) (ao mês): Caso o cliente ultrapasse o limite de parcelas sem juros, o sistema aplicará automaticamente essa taxa mensal ao valor final da compra.
Se você desativar "Permitir parcelamento", todas as vendas no cartão serão cobradas à vista (em uma parcela só).
Pix
Ative Permitir pagamentos em Pix para liberar essa opção no checkout. A seção Configurações de Pix abre um único campo:
- Expiração da cobrança (minutos): Por quanto tempo o QR Code/código Pix gerado para o cliente continua válido, a contar do momento da compra.
Cobranças avulsas no Asaas só aceitam data de vencimento com granularidade de dia, não de horário. Na prática, qualquer valor abaixo de 1440 minutos (24h) vence ainda no mesmo dia em que a cobrança foi gerada — o campo não garante uma expiração no minuto exato informado.
Boleto
Ative Permitir pagamentos em Boleto para liberar essa opção no checkout. A seção Configurações de Boleto abre um único campo:
- Prazo de vencimento (dias): Quantos dias o cliente tem, a partir da compra, para pagar o boleto antes que ele vença (padrão: 5 dias).
Como funciona para o cliente
Na tela de pagamento, o cliente só vê as formas de pagamento que você deixou ativas no gateway padrão. O comportamento muda um pouco para cada uma:
- Cartão de crédito: o pagamento é processado na hora. Se for aprovado, a reserva é confirmada imediatamente e o cliente é redirecionado para a área de reservas dele.
- Pix: o sistema gera um QR Code e um código "copia e cola" na própria tela. Enquanto o cliente não paga, a página fica verificando automaticamente (a cada poucos segundos) se o pagamento já caiu — assim que o Asaas confirma o recebimento, a tela muda sozinha para "pagamento confirmado", sem precisar recarregar a página.
- Boleto: o sistema gera o boleto e mostra o link para o cliente visualizar/baixar. Como a compensação de boleto é mais lenta (pode levar até alguns dias úteis), essa tela não fica verificando automaticamente — a reserva é confirmada assim que o Asaas notificar o pagamento, e o cliente recebe um e-mail avisando.
Em todos os casos, a confirmação real (o que efetivamente libera a vaga do cliente na viagem) acontece via webhook: o Asaas avisa o Avoei quando o pagamento muda de status, e é esse aviso — não a ação do cliente na tela — que confirma a reserva. Por isso o Token configurado no passo 1 e a conectividade do seu site são essenciais: sem eles, os pagamentos em Pix e Boleto nunca seriam confirmados automaticamente.
Gerenciando seus Gateways
Após preencher tudo, clique no botão azul "Criar" no final da página.
Você será redirecionado para a tela de Listar Pagamentos Gateway. Nela, você verá uma tabela com todas as suas integrações, mostrando quais formas de pagamento (Cartão, Pix, Boleto) cada uma aceita, qual está ativa e qual é a padrão. Se precisar alterar alguma taxa ou configuração no futuro, basta clicar no botão Editar ao lado do gateway correspondente.