Pagamentos (Asaas)

Conectando sua conta Asaas pra cobrar Pix e cartão

Como gerar API key no Asaas, testar a integração e o que o PetShop Flow guarda criptografado.

Atualizado em 17 de maio de 20262 min de leitura

O PetShop Flow usa Asaas como gateway pra cobrança Pix, cartão e boleto, tanto pra clientes do agendamento online quanto pra repasses de comissão.

Antes de começar

  • Você precisa ter conta na Asaas (sandbox ou produção).
  • A API key fica em Integrações → API no painel Asaas.
  • Quem mexe: usuários com permissão manage_payments (administrador).

Passo a passo

  1. Acesse /configuracoes/pagamento no PetShop Flow.
  2. Cole sua API key (mínimo 10 caracteres).
  3. Escolha o ambiente: sandbox (testes) ou production.
  4. (Opcional) Defina um token de webhook próprio — usado pra autenticar callbacks do Asaas.
  5. Clique em Salvar e testar.

[SCREENSHOT: Formulário de credenciais Asaas]

O teste automático

Quando você salva, o PetShop Flow chama GET /myAccount na API Asaas (sandbox ou produção). Se a chave estiver inválida ou sem permissão:

  • HTTP 401/403 → mensagem: "Chave inválida ou sem permissão. Verifique a API key no painel Asaas."
  • Outros erros → mostra o status HTTP e os primeiros 200 caracteres da resposta.
  • Falha de rede → "Não foi possível conectar ao Asaas."

Só salva se o teste passar.

Como o PetShop Flow guarda sua chave

  • Criptografada com chave do servidor (AES) antes de gravar no banco.
  • Nunca devolvida em texto plano — quando você abrir a página de novo, vê só uma máscara tipo ••••••1234.
  • A data da conexão e do último teste ficam visíveis pra você saber se já validou.

Verificar status depois

A tela mostra:

  • Se está conectado.
  • Ambiente (sandbox/produção).
  • Chave mascarada.
  • Conectado em / último teste em.

Pra trocar a chave, basta colar a nova e salvar — o PetShop Flow testa antes.

Permissões e segurança

  • Apenas administrador altera credenciais.
  • O webhook do Asaas chega em /api/webhooks/asaas?t=<token> — se o token não bater, o callback é rejeitado.

Perguntas frequentes

Posso trocar de sandbox pra produção sem perder histórico?

Sim. O histórico de vendas, comissões e pagamentos não se mistura com Asaas — só as chamadas de cobrança mudam de ambiente. Cuidado: clientes cadastrados no Asaas sandbox não migram pra produção.

Aceita gateway diferente do Asaas?

Hoje, não. O PetShop Flow foi desenhado em torno de provider configurável, mas só a implementação Asaas está pronta.

A chave fica visível pra outros funcionários?

Não. Mesmo na tela, mostra mascarada. Só o servidor descriptografa pra fazer chamadas.

Artigos relacionados