Conectar sua conta Asaas (chave de API)

Para cobrar por PIX, boleto e cartão de crédito pelo Coconut, você precisa conectar a sua conta Asaas uma única vez. A conexão é feita por uma chave de API: um código que você gera no painel do Asaas e cola no Coconut. A partir daí, as cobranças saem do app e os pagamentos voltam automaticamente.

Este guia cobre só a conexão. Para entender tudo o que a integração faz depois de conectada (cobranças, importação, assinaturas, NFS-e), veja Integração com o Asaas.

Antes de começar

• Você precisa de uma conta no Asaas já ativa (cadastro aprovado e dados bancários configurados lá). O Asaas exige verificação de identidade própria. O Coconut não cria nem aprova a conta, apenas se conecta a uma que já existe.
• Só o dono da organização e usuários administradores podem conectar a conta no Coconut. Visualizadores têm acesso somente de leitura.

Ainda não tem conta no Asaas?

Crie a sua pelo link da parceria Coconut + Asaas, na própria tela de conexão em Configurações Asaas . Criar por ali garante as condições especiais da parceria. É gratuito e rápido.

Passo 1: Gerar a chave de API no Asaas

1. 1
   Faça login no painel do Asaas (web ou app).
2. 2
   Abra o menu da sua conta e vá em Integrações (em algumas contas: Minha conta → Integrações → API).
3. 3
   Na seção Chave de API (API Key), clique em Gerar chave de API. Se já existir uma chave, você pode reaproveitá-la.
4. 4
   O Asaas pode pedir uma confirmação de segurança (código por e-mail ou token) antes de exibir a chave. Confirme.
5. 5
   Copie a chave inteira, sem espaços. Ela começa com $aact_ e é bem longa.

Passo 2: Conectar no Coconut

1. 1
   No Coconut, vá em Configurações Asaas .
2. 2
   Cole a chave no campo Chave de API. Ela fica criptografada no servidor: ninguém vê a chave depois de salva.
3. 3
   Clique em Conectar conta. O Coconut valida a chave com o Asaas na hora.
4. 4
   Se a chave for válida, a tela passa a mostrar o nome da conta conectada, o e-mail, o ambiente (produção ou sandbox) e a data de ativação.

Ao conectar, o Coconut faz dois ajustes sozinho: registra o webhook na sua conta Asaas (o canal por onde o Asaas avisa sobre pagamentos, para o status atualizar automaticamente) e detecta se a NFS-e está habilitada na conta.

Passo 3: Definir a categoria padrão das cobranças

Logo após conectar, defina a categoria de receita padrão que as cobranças do Asaas vão usar no seu financeiro. Isso evita que os lançamentos entrem sem categoria.

1. 1
   Ainda em Configurações Asaas , encontre o card Categoria padrão das cobranças.
2. 2
   Escolha uma categoria de receita (ex.: “Receita de serviços”, “Mensalidades”).
3. 3
   Clique em Salvar.

Pronto. E agora?

Conta conectada, você já pode:

• Criar cobranças por PIX, boleto ou cartão.
• Importar clientes e cobranças que já existem no Asaas (sempre com prévia e confirmação).
• Configurar e emitir NFS-e sem abrir o painel do Asaas.

Tudo isso está detalhado em Integração com o Asaas.

Desconectar ou trocar a chave

Na mesma tela Configurações Asaas você pode desconectar a conta a qualquer momento. Para trocar a conta ou usar uma nova chave (por exemplo, ao migrar de sandbox para produção), desconecte e conecte de novo com a chave certa.

Deu erro ao conectar?

Perguntas frequentes