Passo a passo para o gestor # Conectar sua conta Asaas ao Vetcarë O Asaas é quem emite o boleto e o Pix e recebe o dinheiro — **na sua conta**. O Vetcarë só dá as ordens (gerar o Pix do balcão e o link de pagamento do tutor, cancelar) e mostra a baixa automática. Este guia liga uma coisa na outra, em poucos passos. > **A conta é sua, o dinheiro é seu.** — Você abre a conta no Asaas com o seu CPF/CNPJ; o Vetcarë nunca fica com o dinheiro nem com a sua chave. O que você faz aqui é só entregar ao Vetcarë a **chave de API** (para ele cobrar em seu nome) e configurar o **webhook** (para o Asaas avisar o Vetcarë quando alguém paga). Antes de começar: não confunda as 3 informações | O quê | Onde NASCE | Onde você COLA | | --- | --- | --- | | Chave de API (secreta) | No **Asaas** Integrações → Chaves de API | No **Vetcarë** Pagamento online → campo «Chave de API» | | URL do webhook | No **Vetcarë** tem botão «Copiar» | No **Asaas** campo «URL do Webhook» | | Token do webhook (secreto) | O **Vetcarë gera** e guarda botão «Copiar» (e «Gerar novo») | No **Asaas** campo «Token de autenticação» | A **Chave de API** e o **Token do webhook** são coisas **diferentes**: a chave deixa o Vetcarë *cobrar* pela sua conta; o token só *prova* que o aviso de pagamento veio mesmo do Asaas. Não troque um pelo outro. ## Passo 1 — Criar e ativar a conta no Asaas *Em `asaas.com`, abra a conta com CPF ou CNPJ. O Asaas pede alguns dados e o **envio de documentos** para liberar a conta.* 1. Preencha os dados da conta e os **dados comerciais**. 2. Na etapa **Documentos**, aponte a câmera do celular para o QR Code (ou use «Copiar link») e envie os documentos de identificação. 3. Aguarde a **Análise de conta** — é o Asaas liberando você para cobrar de verdade. > **Enquanto a conta está em análise**, use o **Sandbox** (passo 6) para testar sem mexer em dinheiro real. ## Passo 2 — Abrir as «Integrações» *É onde ficam a chave de API e os webhooks.* 1. No canto superior direito, clique no **ícone da sua conta** (avatar). 2. No menu, clique em **Integrações**. ## Passo 3 — A tela de Integrações — onde está tudo *No topo, as abas que importam: **Chaves de API** (passo 4) e **Webhooks** (passo 5).* ## Passo 4 — Gerar a Chave de API e colar no Vetcarë *A chave de API é o que permite ao Vetcarë cobrar em seu nome, pela sua conta. Ela é **secreta** — trate como uma senha.* **4.1 — Abrir a aba.** Em **Chaves de API**, clique em **Gerar chave de API**. **4.2 — Nomear a chave.** Dê um nome (ex.: *Vetcare*). A expiração é opcional. > **Permissão de saque: não precisa.** — A clínica só *recebe* pelo Vetcarë (o Pix do balcão e o link de pagamento do tutor) — deixe a caixa «Permitir que esta chave execute operações de saque via API» **desmarcada**. **4.3 — Autorizar por SMS.** O Asaas pede um código por SMS para liberar a criação da chave. Clique em «Enviar código», digite o que chegar e confirme. **4.4 — Copiar a chave AGORA.** A chave aparece **uma única vez**. Clique em **Copiar** e guarde num lugar seguro — o Asaas **não** mostra ela de novo. > **Se você perder a chave**, não tem como recuperá-la — é só gerar uma nova (e trocar no Vetcarë). A antiga pode ser removida. **4.5 — Conferir.** A chave passa a aparecer na lista, como **Habilitado**. **4.6 — Colar no Vetcarë.** Vá em **Configurações → E-mail, pagamento e arquivos → Pagamento online**, escolha **Asaas**, cole a chave no campo **Chave de API** e escolha o **ambiente** (Sandbox para testar, Produção para valer). No fim, clique em **Salvar**. > **A chave nunca reaparece depois de salva.** — No Vetcarë, o campo mostra «guardado — deixe em branco para manter»; você só digita de novo se for trocar. > **Confirme na hora:** — depois de salvar, clique em **«Testar conexão»** (ao lado de Salvar). Se a chave estiver certa, aparece o selo **«Testado»** em verde. É o «deu certo?» da chave de API. ## Passo 5 — Ligar o webhook (a baixa automática) *O webhook é o Asaas **avisando o Vetcarë** na hora em que alguém paga — é o que faz a venda do balcão fechar sozinha e os serviços do tutor virarem «pagos». Sem ele, o dinheiro entra no Asaas e o Vetcarë nunca fica sabendo.* **5.1 — Um clique no Vetcarë.** Em **Configurações → E-mail, pagamento e arquivos → Pagamento online → Asaas**, depois de salvar a chave (passo 4.6), clique em **«Configurar o webhook no Asaas»**. O Vetcarë cria (ou corrige) o webhook na sua conta com tudo certo — URL com a chave, token, **ativo**, envio **sequencial** e os eventos de pagamento. Não precisa abrir o painel do Asaas. **5.2 — Confira.** Clique em **«Testar conexão»**. Tem que aparecer em verde: *«Webhook ativo, sequencial e com todos os eventos; chave Pix ativa»*. Se o botão acusar algum erro, crie o webhook à mão pelo **Apêndice A**, no fim deste guia. > **Como saber que funcionou:** — no Vetcarë, o Pix do balcão pago fecha a venda sozinho, com a tela aberta ou não. No Asaas, a aba **Logs de Webhooks** mostra cada aviso e a resposta. > **Se as baixas não chegarem:** — no Vetcarë, clique em **«Testar conexão»** — ele confere o webhook (ativo, fila não interrompida, sequencial, eventos, token) e a chave Pix, e diz o que falta. No **Registro do sistema**, a linha «webhook recusado» indica que o Asaas está chamando com o token errado. No Asaas, a **«Fila de sincronização»** interrompida faz os eventos serem gerados mas **não enviados** — reative e veja os **Logs de Webhooks**. Na dúvida, **«Configurar o webhook no Asaas»** conserta tudo de uma vez. ## Passo 6 — Sandbox × Produção *Duas contas separadas, para não misturar teste com dinheiro real.* 1. **Sandbox** (teste): crie a conta Sandbox pela tela de Integrações, use a **chave de sandbox** e escolha o ambiente **Sandbox** no Vetcarë. Boletos e Pix são de mentira — perfeito para ensaiar. 2. **Produção** (valer): com a conta aprovada, use a **chave de produção** e o ambiente **Produção** no Vetcarë. O webhook precisa ser configurado **em cada uma** (a URL do Vetcarë é a mesma; o token, de preferência, diferente). ## Está tudo funcionando? *Um passa-olho final antes de considerar pronto:* 1. **Chave de API** colada no Vetcarë (passo 4). 2. **«Testar conexão»** em verde: *«Webhook ativo, sequencial e com todos os eventos; chave Pix ativa»* (use «Configurar o webhook no Asaas» se faltar algo). 3. **Ambiente** certo: *Sandbox* enquanto ensaia, *Produção* quando for valer. ## Apêndice — criar o webhook à mão *Só se o botão «Configurar o webhook no Asaas» (passo 5.1) acusar erro. É o mesmo webhook, criado no painel do Asaas. Depois, confira com «Testar conexão» (passo 5.2).* **A.1 — No Vetcarë, copie a URL.** Na tela de Pagamento online (passo 4.6), na caixa **«Baixa automática (webhook)»**, a **URL do webhook** já vem pronta, com a chave de autenticação embutida no fim (`?chave=…`). Clique em **Copiar** — você não inventa nem digita nada. > **A URL é só desta clínica.** — Ela termina com o identificador da sua conta e a chave que o Vetcarë gerou — por isso se **copia do Vetcarë**, inteira. **A.2 — No Asaas, abra o formulário.** Integrações → aba **Webhooks** → **+ Adicionar Webhook**. **A.3 — Preencha:** 1. **Nome do Webhook:** qualquer nome (ex.: «Vetcarë»). 2. **URL do Webhook:** cole a **URL** que você copiou do Vetcarë (passo A.1). 3. **Token de autenticação:** deixe **em branco** — a chave já está na URL. **Não use «Gerar Token» do Asaas.** 4. **Versão da API: v3.** Deixe «Este Webhook ficará ativo?» e «Fila de sincronização ativada?» **ligados**. 5. **Tipo de envio: Sequencial** — escolha na lista (ela vem vazia). No envio sequencial os avisos chegam na ordem certa (confirmado antes de recebido). 6. **E-mail:** o seu — o Asaas avisa ali se o webhook começar a falhar. **A.4 — Marque os eventos e salve.** Em «Adicionar Eventos → Cobranças», marque os eventos. **Pode marcar todos** — o Vetcarë usa os de pagamento (`PAYMENT_CONFIRMED`, `PAYMENT_RECEIVED`, `PAYMENT_OVERDUE`, `PAYMENT_REFUNDED`…). Depois clique em **Salvar**. Vetcarë · Guia da integração Asaas · 19/08/2026, atualizado em 27/09/2026. As telas do Asaas podem mudar com o tempo; o passo a passo segue o mesmo. --- Central de Ajuda Vetcarë · revisão de 25/10/2026 · versão para pessoas: https://app.vetcareapp.com.br/manual