Pular para o conteúdo

Para equipe ilarika

Asaas: cadastrar a chave do gateway de cobrança

  • Super AdminConfiguraçõesAsaas (cobrança)
  • Super AdminAssinaturas (botão "Asaas" e painel Cobrança automática)

Aqui quem tem a área Chaves de pagamento cadastra a chave de API do Asaas, escolhe o ambiente (produção ou sandbox) e o token do webhook, sem mexer no .env nem reiniciar a API. O Asaas cobra a assinatura das lojas; o dinheiro que o cliente paga à loja (Pix e cartão online) é outro caminho: veja Recebimento online das lojas.

Antes de começar

  • Ver esta tela pede a área Chaves de pagamento; alterar pede ver e mudar. Nenhum modelo pronto (Operações, Suporte) tem essa área: o superadmin dá pessoa por pessoa (Time iLarika).
  • Tenha a chave de API do Asaas (Integrações › Chave de API). Produção e sandbox têm chaves diferentes.

Passo a passo

  1. Menu Configurações › Asaas (cobrança) (ou o botão Asaas no topo de Assinaturas).
  2. Em Credenciais, cole a Chave de API do Asaas, escolha o Ambiente e informe o Token do webhook (ao menos 16 caracteres; gere com openssl rand -hex 24). Deixe em branco o que não quer trocar. Salvar.
  3. No quadro Situação (que mostra “Pronto para cobrar” ou “Não configurado” e de onde vem cada campo), Testar conexão: mostra o nome, o e-mail, o documento (só os 4 últimos dígitos) e a situação da conta no Asaas. “Chave recusada” quase sempre é chave de um ambiente com o outro ambiente escolhido.
  4. Em URL do webhook, Copiar URL e cadastre no Asaas (Integrações › Webhooks) com o mesmo token, os eventos PAYMENT_* e os de Pix Automático, e a fila de sincronização ligada.

O que acontece depois

  • Vale na hora: a próxima cobrança já usa a chave nova (outras instâncias da API pegam a troca em até 30 s).
  • Chave e token ficam cifrados no banco e nunca voltam para a tela; ela mostra “cadastrada · termina em …abcd”.
  • O que está aqui ganha do .env do servidor (ASAAS_*), campo a campo. Remover › Remover credenciais apaga o que foi cadastrado aqui: se o servidor tiver ASAAS_*, volta a valer o .env; senão, as cobranças passam para o provedor manual.
  • Salvar, testar e remover ficam na auditoria com quem fez e quando (sem o valor da chave).

Perguntas comuns

A tela diz “do servidor (.env)”. Preciso cadastrar aqui? Não: continua funcionando. Cadastrar aqui só serve para trocar sem acesso ao servidor.

Troquei a APP_MASTER_KEY e o Asaas parou. A chave cifrada com a antiga não abre mais: cadastre de novo aqui.

Formas de pagamento, Pix Automático e o que fazer com cada fatura estão em assinaturas e fatura e pagamento.