Como conectar e configurar o Asaas?

Question

Accepted Answer

O Asaas é um meio de recebimento que cobre PIX, cartão e boleto, com confirmação automática do pagamento. Para que serve - Exigir pagamento no agendamento público - Cobrar fotos extras nas galerias de seleção - Gerar cobranças para os seus clientes - Registrar automaticamente o recebimento no Financeiro Gerando a chave de API no Asaas A plataforma precisa de uma única informação: a chave de API da sua conta Asaas. 1. Entre na sua conta em asaas.com 2. Abra o menu do usuário e clique em Integrações 3. Vá até a aba Chaves API e clique em Gerar chave de API 4. Dê um nome para identificar a chave — use algo como "GOFOTÓGRAFO", para saber depois de onde ela veio 5. Se quiser, defina uma data de expiração (é opcional) e clique em Avançar 6. Informe o seu Token App ou SMS — o código de segurança da sua conta Asaas — e confirme em Gerar chave de API ⚠️ Copie a chave na hora. O Asaas mostra a chave uma única vez, no momento em que ela é gerada. Depois disso não há como vê-la de novo — se perder, é preciso gerar outra. 💡 Só quem é administrador da conta Asaas consegue gerar chave. E há um limite de 10 chaves por conta. Para alterar, desabilitar ou remover chaves depois, o caminho é o mesmo: Integrações → Chaves API. O passo a passo oficial fica em Chaves de API — Asaas. Conectando na plataforma 1. Abra Configurações → Integrações e Automações 2. No bloco Pagamentos, clique em Asaas 3. Cole a chave no campo API Key — ela começa com $aact 4. Salve O bloco passa a exibir o selo Ativo. Se você quiser testar antes O Asaas tem um ambiente de testes chamado Sandbox, onde você simula cobranças sem movimentar dinheiro de verdade. ⚠️ A conta de Sandbox é totalmente separada da sua conta real. Mesmo que você já tenha conta no Asaas, precisa criar outra em sandbox.asaas.com — e a chave de API do Sandbox é gerada lá dentro, pelo mesmo caminho. Na plataforma, ligue a chave Modo sandbox ao colar a chave de teste. Quando terminar os testes, troque pela chave de produção e desligue o Modo sandbox. ⚠️ Chave de sandbox em produção significa cobrança que nunca vai ser paga de verdade. Ao migrar, confira se trocou as duas coisas: a chave e a chave de modo. Sobre o ambiente de testes: Sandbox — Asaas. Importar o que já existe no Asaas Com o Asaas ativo, aparecem dois atalhos no mesmo bloco: - Importar histórico — traz para o Financeiro as cobranças que já existem na sua conta Asaas - Limpar dados importados — desfaz essa importação 💡 Vale importar logo depois de conectar, para não ficar com o histórico partido entre os dois lugares. Faça uma vez só: importar de novo recria os mesmos registros. Quando os dois gateways estão ativos Se você tiver Asaas e Mercado Pago ligados ao mesmo tempo, um deles fica marcado como Principal — é o que será usado para gerar as cobranças. O outro permanece configurado, mas em segundo plano. 💡 Não há ganho em manter os dois. Escolha um e desconecte o outro, para não ficar em dúvida sobre onde o dinheiro caiu. Depois de conectar Com o Asaas ativo, destrava o Exigir pagamento para reservar, nas Configurações da Agenda PRO — recurso que depende de checkout do gateway e não funciona com Pix manual. Ele também passa a aparecer como opção em Exigir pagamento ao selecionar fotos extras, nas galerias de seleção. Ali, porém, ele não é obrigatório: essa cobrança também funciona com Pagamento manual, com a diferença de que a baixa é feita por você. A carteira do Financeiro Quando o pagamento chega pelo Asaas, o lançamento é criado na carteira correspondente, e não na carteira genérica. Isso mantém o seu saldo condizente com o que está efetivamente na conta do gateway. Se der erro - Confira se copiou a chave inteira. Ela é longa e se corta com facilidade no copiar e colar - Confira se é a chave do ambiente certo — de produção para cobrar de verdade, de sandbox só para testes - Gerou uma chave nova? A antiga pode ter sido desabilitada. Atualize aqui também - Chave expirada — se você definiu data de expiração ao gerar, ela para de funcionar sozinha na data marcada ⚠️ A chave de API carrega todos os privilégios da sua conta Asaas: quem a tiver pode gerar cobranças e movimentar dados em seu nome. Não compartilhe, não mande por WhatsApp e nunca a envie para o suporte de ninguém — nem do Asaas, nem daqui. Em caso de dúvida, remova a chave no painel do Asaas e gere outra.