Integração com o Asaas
Conecte o Asaas para pagar vários faturamentos com uma cobrança só, com baixa automática.
Em resumo
- O Asaas permite pagar vários faturamentos com uma cobrança só: a organização quita um PIX ou boleto e o Asaas repassa a cada fornecedor.
- Nenhuma integração é obrigatória. Sem o Asaas, o pagamento continua manual, com comprovante.
- A conexão tem duas partes: a chave de API (o Afflux fala com o Asaas) e o webhook (o Asaas avisa o Afflux que o dinheiro entrou). As duas são necessárias para a baixa automática.
- Antes de conectar, cadastre o CNPJ da organização.
- Ver exige Ver contas a pagar e pagamentos; conectar, trocar e remover exige Editar dados da organização.
O que a integração habilita
ConfiguraçõesIntegrações — "Serviços externos que esta organização usa. Nenhum é obrigatório."
- Cada conta a pagar é paga por fora e recebe a baixa à mão, com comprovante.
- Lotes de pagamento não podem ser criados.
- A equipe reúne contas aprovadas num lote e emite uma cobrança consolidada (PIX ou boleto).
- A organização paga uma vez; o Asaas reparte o valor entre os fornecedores.
- A baixa das contas é automática, quando o Asaas confirma o pagamento.
Como usar os lotes no dia a dia está em Lotes de pagamento.
Conectar o Asaas
Cadastre o CNPJ da organização
O Asaas emite a cobrança em nome da organização, por isso o CNPJ é obrigatório. Preencha-o em Organização. Sem ele, a conexão é recusada com "Cadastre o CNPJ da organização antes de conectar o Asaas."
Copie a chave de API no Asaas
No painel do Asaas, a chave fica em Configurações → Integrações. O campo do Afflux mostra o exemplo "$aact_…".
Conecte
No cartão Asaas, preencha:
- Chave de APIobrigatório
- Cole a chave do Asaas. Ela é cifrada no servidor e não volta para esta tela — nem para você.
- Ambienteobrigatório
- Produção, para pagamentos reais, ou Sandbox (testes), para experimentar com uma conta de testes do Asaas.
Clique em Conectar Asaas. Enquanto o Afflux confere a chave com o Asaas, o botão mostra "Validando…". Deu certo: "Asaas conectado."
Gere o token do webhook
Na seção Webhook, clique em Gerar token do webhook. A confirmação avisa que o token é exibido uma única vez.
Copie o token na hora
O token aparece uma vez só, com o botão de copiar. O Afflux não guarda o valor legível, e ele não volta a ser exibido. Perdeu? Gere outro — o anterior deixa de valer.
Copie também a URL do webhook, que fica num campo copiável na mesma seção.
Cadastre o webhook no Asaas
A seção tem o expansível Como cadastrar no Asaas. No painel do Asaas:
- Vá em Integrações → Webhooks → Adicionar.
- Dê o nome afflux-pagamentos e escolha a versão da API V3.
- Em URL e token, cole os dois valores copiados do Afflux.
- Fila de sincronização ativa: Sim.
- Tipo de envio: Sequencial.
- Ative os eventos de cobrança (incluindo PAYMENT_RECEIVED) e de transferência, e salve.
- Volte ao Afflux.
Confira o selo
O selo do webhook vira Ativo quando o primeiro evento do Asaas chega, com "Último evento recebido em" e a data. A partir daí, o cartão mostra Integração ativa.
Os selos
Da integração
| Selo | Quando aparece |
|---|---|
| Não conectada | Nenhuma chave conectada. |
| Configuração incompleta | A conta do Asaas está aprovada, mas o webhook ainda não recebeu nenhum evento. |
| Situação da conta no Asaas | A conta tem pendência no Asaas; o selo mostra a situação informada por ele. |
| Integração ativa | Chave conectada e webhook já recebeu evento. |
No ambiente de testes, o selo ganha "· Sandbox".
Com a conta aprovada, o cartão confirma "Chave de API conectada e pagador da organização configurado." Com pendências, avisa: "A conta Asaas está com pendências. A cobrança pode ser recusada até que sejam resolvidas no painel do Asaas."
Do webhook
Nenhum token gerado. Gere o token e cadastre o webhook no Asaas para concluir a integração.
Token gerado, mas nenhum evento chegou ainda. Confira se o webhook foi criado no painel do Asaas com a URL e o token.
O Asaas já mandou eventos. Mostra quando chegou o último.
Como muda
- PendenteAguardando evento— Gerar token do webhook
- Aguardando eventoAtivo— primeiro evento recebido do Asaas
Por que o webhook importa
É pelo webhook que o Asaas avisa que o dinheiro entrou. Sem ele, a cobrança é emitida e paga normalmente, mas o Afflux não fica sabendo: o lote fica parado em "processando" e as contas não recebem baixa.
Trocar, gerar de novo e remover
- Trocar chave
- Abre o formulário da chave de novo, agora com o botão Substituir chave.
- Gerar novo token
- O token atual deixa de valer imediatamente. Até você colar o novo no painel do Asaas, os eventos do Asaas são recusados e os lotes pagos ficam presos em processando.
- Remover integração
- Pede confirmação: a organização deixa de emitir cobrança consolidada e o webhook para de ser aceito. Lotes já emitidos continuam no Asaas, mas a baixa automática deles não chega mais. Confirmado: Integração removida.
Gerou um token novo? Atualize o Asaas no mesmo momento
Entre gerar o token novo e colá-lo no webhook do Asaas, nenhum pagamento é confirmado no Afflux. Faça as duas coisas em sequência.
A carteira de cada fornecedor
Para o Asaas repassar o dinheiro, cada fornecedor precisa ter a carteira Asaas cadastrada na ficha dele. Só entram num lote as contas de fornecedores com carteira; na emissão, quem não tem aparece com o alerta "sem carteira Asaas". Veja Dados bancários e carteira.
Solução de problemas
Quem pode o quê
| Ação | Permissão |
|---|---|
| Ver a tela de Integrações e os selos | Ver contas a pagar e pagamentos |
| Conectar, trocar a chave, gerar token e remover | Editar dados da organização, além do acesso à tela |