Passo a passo para o gestor # Conectar sua conta Asaas ao Locarë O Asaas é quem emite o boleto e o Pix e recebe o dinheiro — **na sua conta**. O Locarë só dá as ordens (gerar, cancelar, dividir) 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 Locarë nunca fica com o dinheiro nem com a sua chave. O que você faz aqui é só entregar ao Locarë a **chave de API** (para ele cobrar em seu nome) e configurar o **webhook** (para o Asaas avisar o Locarë 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 **Locarë** Cobrança → campo «Chave de API» | | URL do webhook | No **Locarë** tem botão «Copiar» | No **Asaas** campo «URL do Webhook» | | Token do webhook (secreto) | O **Locarë 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 Locarë *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). Aqui embaixo também mora o **Wallet ID**, usado no repasse automático (passo 6).* ## Passo 4 — Gerar a Chave de API e colar no Locarë *A chave de API é o que permite ao Locarë 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.: *Locare*). A expiração é opcional. > **Obrigatório — marque a permissão de saque:** — **«Permitir que esta chave execute operações de saque via API (Pix, Ted…)»**. O repasse ao proprietário (e à imobiliária) é uma transferência Pix — um *saque* —, e o Locarë faz isso sozinho quando o inquilino paga. **Sem essa caixa, a cobrança é recebida mas o repasse NUNCA sai**: o dinheiro fica parado na sua conta Asaas. Se a sua chave foi criada sem ela, gere uma nova com a caixa marcada e troque no Locarë. **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 Locarë). A antiga pode ser removida. **4.5 — Conferir.** A chave passa a aparecer na lista, como **Habilitado**. **4.6 — Colar no Locarë.** Vá em **Configurações → Serviços → Cobrança**, 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 Locarë, 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 Locarë** na hora em que alguém paga — é o que faz a cobrança baixar sozinha **e o repasse sair**. Sem ele, o dinheiro entra no Asaas e o Locarë nunca fica sabendo.* **5.1 — Um clique no Locarë.** Em **Configurações → Cobrança → Asaas**, depois de salvar a chave (passo 4.6), clique em **«Configurar o webhook no Asaas»**. O Locarë 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 Locarë, uma cobrança paga vira «Recebido» sozinha (sem F5). No Asaas, a aba **Logs de Webhooks** mostra cada aviso e a resposta. > **Se as baixas não chegarem:** — no Locarë, 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. **5.3 — Repasse sem token por SMS (validação de saque) — obrigatório.** Por segurança, o Asaas **segura** cada transferência feita pela API — o repasse fica «aguardando autorização» até alguém digitar o token no painel. Para os repasses saírem sozinhos: 1. No Locarë (Configurações → Cobrança → Asaas), logo abaixo da URL do webhook, na linha **«🔐 URL de validação de saque»**, clique em **Copiar**. (Ela é quase igual à do webhook — muda `/pagamento/` para `/saque/`. Cole a certa!) 2. No Asaas: Integrações → aba **Segurança** → «Validação de saque via Webhook» → **Habilitar validação**. 3. Cole a URL (inteira), ponha o seu e-mail e deixe o **token em branco** (a chave já está na URL). Deixe **desmarcadas** as duas opções abaixo da URL — «Validar também saques via interface» e «Ativar autorização de saque para estornos Pix» —, para o que você fizer à mão no app do Asaas continuar pelo token de sempre. 4. Salve. A partir daí o Asaas pergunta ao Locarë a cada repasse, e o Locarë aprova **só o que ele mesmo pediu** (valor e chave conferidos) — qualquer outra transferência é recusada. > **Não habilite a validação com outra URL.** — Se a URL não for a do Locarë, o Asaas não recebe resposta e **cancela** o repasse depois de três tentativas. ## Passo 6 — Repasse ao proprietário — dois caminhos *O Locarë repassa a parte de cada proprietário sozinho, por um de dois caminhos, escolhido na **ficha de cada pessoa**:* 1. **Na origem (split do Asaas).** Se o proprietário tem conta Asaas, peça a ele o **Wallet ID** da conta dele (Integrações → Wallet ID, como no passo 3) e cole no Locarë em **Pessoas → ficha dele → «Conta Asaas desta pessoa (opcional — para receber direto)»**. A parte dele é dividida no próprio pagamento e **nunca passa pela sua conta**. 2. **Por Pix, depois do recebimento.** Sem conta Asaas, a parte sai por Pix para a **chave Pix** da ficha, assim que o pagamento cai. Para isso são precisas duas coisas: a permissão de **saque** na chave de API (passo 4.2) e a **validação de saque** (passo 5.3) — sem ela, o Asaas segura cada Pix esperando o token por SMS. > **Chave Pix de celular:** — pode digitar só o DDD e o número (ex.: 21998092744). O Locarë reconhece que é celular — mostra «✓ celular — +55…» embaixo do campo — e completa com **+55** sozinho ao sair do campo. Embaixo de todo campo de chave aparece o tipo reconhecido (e-mail, CPF, CNPJ, celular, aleatória) ou um aviso se algo estiver errado. > **Não cole o seu Wallet ID na ficha do proprietário.** — O Wallet ID que aparece na sua tela de Integrações é o da **sua** conta. O que vai na ficha é o da conta **dele**. ## Passo 7 — Testar o repasse com dinheiro de verdade *Antes de cobrar o primeiro aluguel, prove que o caminho inteiro funciona — com R$ 5, na sua conta, sem cadastrar inquilino, imóvel ou contrato de mentira.* 1. No Locarë: Configurações → Cobrança → Asaas → **«🧪 Testar o repasse com dinheiro de verdade»**. 2. Valor (mínimo **R$ 5,00**) e **uma ou duas chaves Pix** de OUTRAS contas suas (não a chave desta conta Asaas), com o percentual de cada uma. 3. **Gerar cobrança de teste** → pague pelo QR Code ou pelo Pix copia e cola, de qualquer banco. 4. Acompanhe na tela, etapa por etapa (ela se atualiza sozinha): ✓ **Pagamento recebido** — com a etiqueta *«aviso do webhook chegou»* (o webhook está certo) ou *«o webhook NÃO avisou»* (volte ao passo 5); ✓ **Pix enviado** para cada chave — ou ✕ com a **frase exata do Asaas** explicando por quê. > **Não precisa de saldo.** — O repasse do teste é sobre o valor **líquido** — o que caiu depois da tarifa do Asaas (de R$ 5,00 caem cerca de R$ 4,01). > **Se um Pix falhar, a frase diz o que fazer:** — - *«…não possui permissão para realizar saques»* → a chave de API foi criada sem a permissão de saque: gere outra com a caixa marcada (passo 4.2) e troque no Locarë. > - *«aguardando AUTORIZAÇÃO no painel do Asaas»* → falta a validação de saque (passo 5.3). Os que já estão parados, autorize no alerta «eventos críticos pendentes» do Asaas. > - *«Necessário informar uma chave Pix válida»* → confira a chave (o tipo aparece embaixo do campo). > - *«Saque … já solicitado»* → o Asaas bloqueia a MESMA transferência (mesmo valor, mesma chave) repetida em pouco tempo — use outro valor no próximo teste. Deu errado? Corrija e clique em **«↻ Tentar os Pix de novo»** — o dinheiro já está na conta, não precisa pagar outro teste. Terminado, **🗑 Apagar** tira o teste da lista (o Registro do sistema guarda o que aconteceu). Pix recusado também aparece no **Registro do sistema** e nos **avisos do Painel**. ## Passo 8 — 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 Locarë. 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 Locarë. O webhook precisa ser configurado **em cada uma** (a URL do Locarë é a mesma; o token, de preferência, diferente). ## Está tudo funcionando? *Um passa-olho final antes de considerar pronto:* 1. **Chave de API** com a permissão de **saque**, colada no Locarë (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. **Validação de saque habilitada** no Asaas (Integrações → Segurança) com a **URL de validação** do Locarë (passo 5.3). 4. O **teste de repasse** (passo 7) com todas as etapas em ✓ — pagamento recebido *pelo webhook* e os Pix enviados *sem pedir código*. 5. **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) e faça o 5.3.* **A.1 — No Locarë, copie a URL.** Na tela de Cobrança (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 imobiliária.** — Ela termina com o identificador da sua conta e a chave que o Locarë gerou — por isso se **copia do Locarë**, 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.: «Locarë»). 2. **URL do Webhook:** cole a **URL** que você copiou do Locarë (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 Locarë usa os de pagamento (`PAYMENT_CONFIRMED`, `PAYMENT_RECEIVED`, `PAYMENT_OVERDUE`, `PAYMENT_REFUNDED`…). Depois clique em **Salvar**. Locarë · 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 Locarë · revisão de 23/10/2026 · versão para pessoas: https://app.locareapp.com/manual