Integração Bancária Asaas
Este documento apresenta instruções detalhadas sobre a integração e utilização do Gateway do Asaas, incluindo a configuração do Webhook para notificações em tempo real.
O Gateway facilita a automação de processos bancários, enquanto o Webhook garante atualizações instantâneas sobre transações e eventos.
Requisitos Importantes
- Sistema operacional Debian 10.
- Para a homologação de uma carteira Gateway o indicado é abrir um novo convênio de conta bancária. Caso deseje utilizar um que já esteja em uso no IXC e/ou que já tenha boletos emitidos por ele, deve estar ciente de que podem ocorrer divergências nos relatórios provenientes de arquivos de retorno.
Entre as divergências estão: Informação de Título não encontrado nos processamentos de retorno (quem se referem a títulos da carteira de Gateway), liquidações atreladas a boletos divergentes, etc.
Objetivos da Integração
- Ampliar a variedade de integrações disponíveis no sistema.
- Atender à demanda dos clientes da Asaas que buscam compatibilidade com o sistema.
- Implementar a geração automática de boletos híbridos e otimizar o processamento de baixas de pagamentos de forma integrada e eficiente.
- Oferecer mais uma opção de integração, proporcionando maior flexibilidade na escolha de soluções financeiras.
Benefícios da Integração
1. Automação de Processos
- Baixa automática de pagamentos: Pagamentos realizados serão baixados automaticamente no sistema, garantindo maior precisão e economia de tempo.
2. Economia e Eficiência
- Redução de custos: Com as tarifas competitivas da Asaas, os clientes economizam em transações financeiras enquanto utilizam uma solução integrada.
- Centralização de operações: Os clientes poderão gerenciar boletos e pagamentos em uma única plataforma, eliminando a necessidade de múltiplos sistemas e fornecedores.
3. Melhor Experiência para o Cliente
- Solicitação atendida: Atende à demanda dos clientes que já utilizam a Asaas e desejam continuar com seus serviços de forma integrada ao sistema.
- Facilidade de adoção: A integração foi desenvolvida para ser intuitiva e de fácil implementação, permitindo que os clientes comecem a utilizá-la imediatamente.
4. Vantagem Competitiva
- Maior atratividade do sistema: A disponibilização dessa integração torna a plataforma mais atraente para novos clientes que possuem ou desejam utilizar contas na Asaas.
- Retenção de clientes: Ao oferecer soluções alinhadas às necessidades dos usuários, o sistema contribui para aumento da satisfação e retenção de clientes.
Processo de Integração e Homologação
Para realizar a integração e homologação da Gateway Asaas no sistema, siga estes passos:
Homologação
Dados bancários necessários para a integração:
461 - Asaas (Gateway)
- 1 - Número da agência com dígito?
- 2 - Número da conta com dígito?
- 3 - Wallet ID?
- 4 - Chave de Gateway?
Dica!
Caso tenha dúvida sobre algum dos dados bancários, consulte o(a) Gerente de sua Conta Bancária.
Passo a passo para obter as Credenciais da Gateway
Informação!
Para a homologação da carteira de Gateway do Asaas, você também precisa gerar o Wallet ID e a Chave da Gateway, que são as credenciais da aplicação da Gateway geradas no Internet Banking da Asaas.
- Acesse o Internet Banking Asaas
- Faça login com sua Conta
- No canto superior direito, clique no menu de conta e acesse o botão Integrações
- Clique em Gerar nova chave de Gateway
- Logo abaixo, na sessão Wallet ID, copie a chave do identificador de carteira da conta Asaas
- Anote estas duas credenciais geradas para a criação da carteira
Credenciais Gateway Finalizadas!
Feito isso, junto com os seus outros dados bancários, o atendente da IXC Soft poderá prosseguir com a homologação da sua carteira de cobrança de Gateway.
Criando a Carteira
- Acesse o menu Sistema
- Pasta Financeiro
- E clique em Carteira de cobrança
- Clique em Novo
- Na primeira aba chamada Carteira de cobrança, você fará as seguintes configurações:
- Descrição: Aqui você irá definir a nomeação da carteira.
- Conta: Aqui você irá criar a conta, responsável por armazenar seus dados bancários.
- Tipo de recebimento: Neste campo você deve selecionar a opção **Gateway
- Enviar e-mail para cliente ao gerar: Marcar como Não, pois torna obrigatório o e-mail de cadastro do cliente e envia automaticamente a fatura do cliente, fazendo assim o registro da mesma no banco (sendo assim, não é recomendado o uso)
- Validar filial na venda: Marcar como Sim
- Planejamento analítico: utilize o padrão 240, ou cadastre um novo
Criando a Conta
- Conta: Defina o nome para a conta
- Tipo da Conta: Marque a opção Banco
- Data de abertura: Informe o dia em que está configurando a conta para esta carteira.
- Planejamento analítico: Para mais informações, acesse: Formulário Planejamento Analítico
- Filial: Selecione o ID da filial para a qual será criada esta Conta e a Carteira
Na aba seguinte Banco:
- Banco: Como a Asaas não é associada ao Banco Central, não precisa preencher este campo
- Agência: Número da sua agência bancária
- Dígito verificador da agência: Insira o dígito verificador que fica após o número da agência
- Número da conta: Número da sua conta bancária
- Dígito verificador da conta: Informe o dígito verificador de sua conta bancária
Configurações Gateway
- Gateway: Selecione o Asaas
- Ambiente gateway: Selecione Produção
- Wallet ID: Insira o código gerado anteriormente em sua conta Asaas
- Chave de Gateway: Insira o código gerado anteriormente em sua conta Asaas
- Envia e-mail Gateways: Marque como Não
- Gera pix: Marque como Sim, ser for utilizar o Pix no boleto
- Tarifas Gateway: aqui você define o lançamento das tarifas gateway, pois o banco não faz isso de forma automática. Acesse Tarifas Bancárias - Gateway, API e Pix para mais informações
Dica!
Após clicar em Salvar a carteira, os campos Webhook ID e Webhook serão preenchidos automaticamente pelo sistema.
Juros/Multas/Desconto
- Juros %: Valor padrão (máximo permitido por lei, acima é caracterizado juro abusivo), configure 0.033%
- Multa %: Valor padrão (máximo permitido por lei, acima é caracterizado multa abusiva), configure 2%
- Desconto até o vencimento R$: Insira um valor em Reais para conceder desconto na fatura, se paga até a data do vencimento
- Desconto até o vencimento %: Insira um valor em Porcentagem para conceder desconto na fatura, se paga até a data do vencimento
Para mais informações, acesse: Juros, Multas e Desconto.
Aviso!
A Gateway Asaas não tem valor mínimo para que seja possível registrar uma cobrança.
Instruções
Informação!
- Asaas Gateway permite o uso de no máximo 500 caracteres totais para serem inseridos como linha de instrução na impressão do boleto.
- Não tem limite de linhas.
Remova as aspas antes e depois das hashtags abaixo:
- Instrução 1:
Após vencimento juros R$ #juro# ao dia.
- Instrução 2:
Após vencimento multa R$ #multa#.
Aviso!
Caso adicione mais linhas, também deve inserir a variável de leitura da linha de instrução, nos parâmetros **Imprimir instruções quando..
Para mais informações, acesse: Instruções da Carteira de Cobrança.
Impressão
- Layout de impressão: Utilize o padrão 3 por página
Para mais informações, acesse: Layouts de Impressão.
Fluxo de Funcionamento
sequenceDiagram participant S as Sistema participant Gateway as Gateway Asaas participant W as Webhook S->>Gateway: Envia requisição (ex: gerar boleto) Gateway->>S: Responde com dados do boleto Note over Gateway,W: Evento ocorre (ex: pagamento) W->>S: Notifica sobre o evento S->>Gateway: Confirma recebimento da notificação
Tarefa de Consulta de Retorno
Dica:
Caso queira uma garantia adicional de baixa de pagamentos, além do webhook, também é possível configurar uma tarefa que consulta os pagamentos.
Esta tarefa deve ser configurada para executar somente 1x no dia, pela manhã, e com isso sempre irá consultar os pagamentos dos títulos que vencem no dia anterior.
Para realizar a configuração, acesse:
- Menu Ferramentas
- Clique em Ferramentas
- Agenda de tarefas
- Botão Novo
- Tarefa: Selecione Processamento retorno Asaas Gateway*
- Minuto (0-59): Coloque o valor dos minutos, entre 0 e 59 min
- Hora (0-23): Coloque o valor da hora, entre 0 e 23
Ativação
Finalizado!
Concluídos todos os passos anteriores, a carteira e as tarefas de consulta estão finalizadas. Com isso, o boleto teste já pode ser gerado para efetuar o pagamento e validar a baixa da fatura no Sistema. Após efetuada a baixa da fatura de forma automática, a homologação estará finalizada.
Considerações Finais
A integração entre a Asaas e o IXC Provedor representa um avanço significativo na otimização da gestão financeira para provedores de serviço.
Com automação de processos, redução de custos e suporte às demandas dos clientes, essa parceria fortalece a eficiência financeira, proporcionando um ambiente de negócios mais ágil e simplificado.
Etiquetas
IntegracaoBancaria GatewayBancaria Asaas