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
- Menu Configurações › Asaas (cobrança) (ou o botão Asaas no topo de Assinaturas).
- 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. - 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.
- 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
.envdo servidor (ASAAS_*), campo a campo. Remover › Remover credenciais apaga o que foi cadastrado aqui: se o servidor tiverASAAS_*, 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.
