Pular para o conteúdo principal

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!).

Vendas Manuais vs. Vendas Online Automáticas

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.

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:

  1. Acesse o painel do Asaas e faça o login com as suas credenciais.
  2. No canto superior direito da tela, clique no ícone do seu perfil (ou vá no menu lateral em "Minha Conta").
  3. Selecione a opção Integrações.
  4. Acesse a aba Chaves de API (sinalizada por um ícone de chave).
  5. Clique no botão azul "Gerar chave de API".
  6. 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.
  7. 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).
  8. 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.

Atenção à Segurança

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.

Múltiplas Chaves

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. Permissões e Parcelamento​

Abaixo dos dados principais, você pode habilitar formas de pagamento específicas:

  • Permitir pagamentos em cartão de crédito: Ative para liberar compras no cartão. (Lembre-se de verificar as taxas de cartão aplicadas pelo Asaas na sua conta).
  • Permitir parcelamento: Ao ativar essa chave, uma nova seção de Configurações de parcelamento será aberta com os seguintes controles:
    • Valor mínimo por parcela: Defina qual é o valor mínimo que uma parcela pode ter (Ex: R$ 50,00).
    • Quantidade de parcelamentos sem juros: Defina até quantas vezes o seu cliente pode parcelar sem que o sistema adicione juros.
    • Quantidade máxima de parcelas: Defina o limite máximo de meses que o cliente pode dividir o pagamento (Ex: 12x).
    • 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.

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 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.