Configuração do gateway de pagamento Asaas

Visao geral da integracao Asaas

O Asaas e o gateway de pagamento utilizado pela plataforma eSocial Brasil para gerenciar cobranças, boletos e pagamentos via PIX. A configuracao correta das chaves de API e webhooks e essencial para o funcionamento do faturamento automatizado.

Requisitos previos

• Possuir uma conta no Asaas (sandbox para testes ou producao).
• Ter acesso de administrador ou ser o responsavel pela consultoria no sistema.
• CNPJ da consultoria devidamente cadastrado no Asaas.

Configurando a API Key

1. Acesse o painel do Asaas e navegue ate Configuracoes > Integracao.
2. Copie a API Key de producao (ou sandbox para ambiente de testes).
3. No sistema eSocial Brasil, acesse Configuracoes > Gateway de Pagamento.
4. Cole a API Key no campo Chave de API Asaas.
5. Opcionalmente, informe o Wallet ID caso utilize subcontas (split de pagamento).
6. Ative a opcao Asaas Ativo para habilitar a integracao.
7. Clique em Salvar configuracoes.

Configurando Webhooks

Os webhooks permitem que o Asaas notifique o sistema automaticamente sobre eventos de pagamento (confirmacao, cancelamento, vencimento).

1. Ao salvar as configuracoes, o sistema cria automaticamente o webhook no Asaas com a URL correta.
2. Os eventos monitorados incluem: pagamento confirmado, pagamento vencido, cobranca cancelada, pagamento estornado, entre outros.
3. O webhook utiliza um token de autenticacao unico para validar as requisicoes recebidas.
4. Caso o webhook ja exista, o sistema atualiza a configuracao existente automaticamente.

Subcontas

Consultorias podem configurar subcontas no Asaas para receber pagamentos diretamente. Cada subconta esta vinculada a uma consultoria especifica e possui suas proprias credenciais de acesso.

Selecao de empresas para faturamento

Na tela de configuracao, voce pode selecionar quais empresas-cliente terao faturas geradas automaticamente pelo sistema. Marque as empresas desejadas no campo Empresas para gerar fatura.

Verificacao e testes

• Apos configurar, gere uma cobranca de teste para validar o fluxo completo.
• Verifique no painel Asaas se o webhook foi registrado corretamente em Configuracoes > Webhooks.
• Confirme que o status das faturas atualiza automaticamente apos o pagamento do boleto de teste.

Solucao de problemas

• Erro ao salvar: verifique se a API Key esta correta e se o CNPJ da consultoria esta validado no Asaas.
• Webhook nao dispara: confirme que a URL do webhook esta acessivel publicamente (sem bloqueio de firewall).
• Pagamento nao atualiza: verifique os logs do sistema em caso de falha no processamento do webhook.