# Provedores: quando algo não funciona *A mensagem que aparece na tela, o que ela quer dizer e o que fazer — Asaas, Mercado Pago, boleto do seu banco, e-mail, arquivos e backup.* > **Onde os problemas aparecem** — • No alto de toda tela: **«O sistema ainda não está pronto para operar»** ou **«Falta terminar a configuração»**, com **Resolver agora** (leva ao cartão do serviço). > • Em **Configurações → Serviços**, cada cartão tem uma etiqueta: **Não configurado**, **Sem teste**, **Testado**, **via Locarë (padrão)** ou **Demonstração**. A lista «Para operar de verdade, falta:» diz o que resta; um provedor que falhou aparece como «… foi testado e FALHOU», com a mensagem do próprio provedor. > • No Painel, a faixa **«Precisam de você»**; e o histórico completo no **Registro do sistema** (o relógio ao lado do «?»). > • Cada cartão tem **Testar conexão** (no Gmail, **Testar envio**). Sempre teste depois de mudar algo. Em modo Demonstração o teste falha de propósito. ## Situação de cada provedor (outubro de 2026) Para quem está escolhendo como receber os aluguéis — o que já está em uso real, com dinheiro de verdade: | Provedor | Situação | | --- | --- | | **Asaas** | **Em produção, com dinheiro real, desde setembro de 2026**: boleto e Pix, baixa automática quando o inquilino paga e repasse ao proprietário por Pix. É o recomendado. | | **Boleto do meu banco** | **Em uso real**: o Locarë gera as cobranças, você emite o boleto no banco e dá baixa à mão ou pelo arquivo de retorno (CNAB 400/240, testado com a Unicred). | | **Mercado Pago** | **Disponível**: conecta à sua conta com um clique; boleto e Pix, sem split (o repasse ao proprietário sai por Pix). | Em todos, o dinheiro fica na **conta do gestor no provedor**: o Locarë não tem conta que receba aluguel. Quem cancela o Locarë continua com a conta e o saldo no provedor — e deve apagar a chave de API do Locarë no painel do provedor. Passo a passo completo, com as telas do provedor: [guia do Asaas](https://app.locareapp.com/ajuda/guia-asaas.md) e [guia do Cloudinary](https://app.locareapp.com/ajuda/guia-cloudinary.md). ## Asaas (boleto, Pix e repasse) - **«Chave de API recusada»** — a chave está errada, revogada, ou é de outro ambiente. *Faça:* no Asaas, Integrações → Chaves de API → gere uma nova; no Locarë, **Configurações → Serviços → Cobrança → Asaas**, cole, escolha o **Ambiente** certo (Testes ou Produção), Salvar e **Testar conexão**. - **Paguei e não deu baixa / cobranças falham sem motivo claro** — quase sempre a chave é de uma conta (sandbox) e o webhook de outra (produção). São contas separadas. *Faça:* chave, ambiente e webhook na MESMA conta. - **«A chave funciona (…), mas falta ajustar: …»** — o teste encontrou um problema no webhook: «não há webhook apontando para o Locarë», «o webhook está DESATIVADO», «a fila do webhook está INTERROMPIDA (o Asaas pausou por erros)», «o envio não está SEQUENCIAL», «faltam eventos», «o webhook está sem o token de autenticação». *Faça:* clique em **⚙ Configurar o webhook no Asaas** — ele cria ou corrige tudo (ativo, sequencial, eventos, token) e testa de novo. - **«a conta não tem CHAVE PIX ativa»** ou o Pix copia-e-cola vem vazio — *Faça:* cadastre uma chave Pix na própria conta do Asaas. - **«webhook recusado»** no Registro do sistema, e o Asaas mostra **401** — a chave dentro da URL está errada ou velha (por exemplo, depois de clicar **Gerar novo** no token). **404** = a URL foi colada cortada. *Faça:* **Configurar o webhook no Asaas**, ou cole de novo a URL INTEIRA (com o `?chave=…` do final). - **A cobrança ficou «Aguardando» depois de paga** — além do webhook, a rotina diária pergunta ao Asaas o que foi pago e dá a baixa. *Faça:* corrija o webhook e espere a rotina do dia seguinte antes de registrar à mão. - **Repasse recusado: «…não possui permissão para realizar saques»** — a chave de API foi criada sem a permissão de saque. *Faça:* no Asaas, crie uma chave nova marcando **«Permitir que esta chave execute operações de saque via API»** e substitua no Locarë. (O Locarë não consegue conferir essa permissão sozinho.) - **Repasse «processando», «aguardando AUTORIZAÇÃO no painel do Asaas»** — falta a **validação de saque**. *Faça:* copie a **🔐 URL de validação de saque** no cartão do Asaas; no Asaas, Integrações → aba **Segurança** → «Validação de saque via Webhook» → Habilitar; cole a URL inteira, ponha o seu e-mail, deixe o token em branco e as duas caixas desmarcadas. Depois autorize no Asaas as transferências que já estavam paradas («eventos críticos pendentes»). - **«o Asaas NÃO pediu a AUTORIZAÇÃO ao Locarë… (Aguardando autorização externa)»** — *Faça:* cancele a transferência no Asaas (Pix → Transferências, lixeira) e mande o repasse de novo; se repetir, fale com o suporte do Asaas. - **«aguardando o limite diário de transferências do provedor»** / «esperando o limite diário de Pix do Asaas (saem sozinhos amanhã)» — o limite diário (ou noturno) de Pix da sua conta foi atingido; não é chave errada. Os proprietários recebem antes da parte da imobiliária, e o Locarë tenta de novo às 6h, 10h e 15h. *Faça:* peça ao Asaas para aumentar o limite; depois, **Repassar** em Repasses em atraso. - **Split recusado** (no Registro: «O provedor recusou o split na origem…») — a cobrança sai sem split e a parte vai por Pix depois. Causa: Wallet ID errado — por exemplo, o SEU colado na ficha do proprietário. *Faça:* em Pessoas → ficha do proprietário, campo **Conta Asaas desta pessoa**, cole o Wallet ID DELE (Asaas dele: Integrações → Wallet ID). - **Chave Pix de celular dá «chave não encontrada»** — sem o `+55`, o número pode ser lido como CPF. O Locarë já acrescenta o +55 em celulares, e o campo avisa («se for celular, digite com +55 na frente»). *Faça:* digite a chave de telefone como `+5521999999999`. - **«⏳ R$ X a caminho — pago, mas o provedor ainda não liberou o dinheiro»** — boleto pago leva 1 a 2 dias úteis para o Asaas liberar. *Nada a fazer:* o repasse sai sozinho quando liberar. No portal do proprietário aparece «Pago — aguardando repasse». - **«💸 R$ X parados no gateway»** — cobranças pagas e liberadas sem repasse. *Faça:* **Repassar** (por Pix); se você já pagou o proprietário por outro meio, **Já repassei por fora** (definitivo). A parte da imobiliária: **Transferir para a minha conta** ou **Deixar no Asaas**. - **Repasse «falhou»** («o provedor recusou a transferência») — chave Pix errada ou sem saldo. *Faça:* corrija a chave na ficha da pessoa (a da imobiliária fica em Configurações → Identidade) e, na cobrança paga, **Repasses → Reenviar os que falharam** — pode repetir. - **«aguardando chave Pix»** — quem recebe não tem chave. *Faça:* Pessoas → ficha → Chave Pix (ou Configurações → Identidade → Chave Pix da imobiliária). - **Testar o repasse antes de usar com cliente:** no cartão do Asaas, **🧪 Testar o repasse com dinheiro de verdade** (mínimo R$ 5, com chaves de OUTRAS contas). «o webhook NÃO avisou» = problema no webhook; «não possui permissão» = chave sem saque; «aguardando AUTORIZAÇÃO» = falta a validação de saque; «Saque … já solicitado» = mesmo valor e chave repetidos, use outro valor. ## Mercado Pago - **Conectar:** Configurações → Serviços → Cobrança → Mercado Pago → **Conectar Mercado Pago** (há a opção de conectar em modo de testes). «Conectou, mas o teste de conexão não passou» → use **Testar conexão** no cartão; «demorou demais» / «Não foi possível conectar» → tente de novo. Sem o botão disponível, use **Prefiro colar o Access Token**. - **«Access token recusado»** ou autorização expirada — a conexão vale 180 dias e se renova sozinha; se expirou ou foi revogada, **Reconectar**. - **Repasse não sai: «o repasse pelo Mercado Pago ainda não está liberado nesta conta»** — as transferências por API dependem de liberação COMERCIAL do Mercado Pago. *Faça*, no cartão, em «Repasse automático por Pix»: **🔑 Gerar a chave das transferências** → **📋 Copiar a mensagem para o Mercado Pago** → envie pelo «Ajuda → Fale conosco» do Mercado Pago → quando confirmarem, marque **«O Mercado Pago liberou as transferências da minha conta»**, Salvar, e **Reenviar os que falharam**. Até lá, pague o proprietário por fora e use **Já repassei por fora**. - **Recusas do Mercado Pago:** «saldo insuficiente», «bloqueada pela análise de risco», «recusada pelo banco de quem recebe» e «limite de transferência atingido» (este último espera e tenta de novo). - O Mercado Pago **não divide na origem**: o valor inteiro cai na sua conta e as partes saem por Pix. Multa e juros são os do painel do Mercado Pago (2% e 1% ao mês), não por cobrança. ## Boleto do meu banco e arquivo de retorno - **Configurar:** Configurações → Serviços → Cobrança → **Boleto do meu banco** → Salvar. Não há o que testar. Para anexar o PDF do boleto é preciso ter onde guardar arquivos (ver Arquivos, abaixo). - **«a linha digitável tem N dígitos — o boleto tem 47»** / «isto não parece um Pix copia e cola» — confira o que foi colado. - **Importar pagamentos:** Cobranças → **🏦 Importar pagamentos do banco**, com o arquivo de RETORNO da cobrança (CNAB 400 ou 240). Extrato (OFX/PDF) não serve: «este não é o arquivo de retorno da cobrança». Até 60 arquivos de uma vez. - **Linha «conferir» (vem desmarcada)** — o pagamento foi reconhecido só pelo valor e vencimento; dois inquilinos podem ter o mesmo aluguel e dia. *Faça:* confira o nome no extrato do banco antes de marcar. Para não acontecer mais, anexe a linha digitável ou use um «Seu número» por inquilino. «De quem é este pagamento?» ensina o Locarë a reconhecer daí em diante. - **«…menos que a cobrança»** — use **Registrar pagamento** na cobrança, com o valor recebido. - **Desfazer registro** (na cobrança paga, com motivo) — não vale se o pagamento foi parcial ou se o repasse já foi registrado. ## E-mail - **Faixa vermelha «A conexão com o Google expirou…»** — os e-mails e o backup no Drive param até reconectar. *Faça:* **Reconectar agora** (ou Configurações → Serviços → E-mail → Conectar com o Google). - **«Testar envio» do Gmail falhou** — «A conexão com o Google falhou» → reconecte; «O Google recusou o envio: …» → leia o motivo. Se o Conectar não passar de jeito nenhum, fale com o suporte (às vezes a conta precisa ser liberada pela plataforma). - **«via Locarë (padrão)»** — sem e-mail próprio, saem até 30 por mês pelo Locarë. Esgotou: «Cota de e-mails pelo Locarë esgotada — só as cobranças continuam saindo». *Faça:* **Conectar o meu e-mail**. - **SMTP próprio:** «Usuário ou senha recusados pelo servidor» ou «Não foi possível conectar» — confira servidor, porta (587 com STARTTLS ou 465 com SSL), usuário e senha (muitos provedores exigem senha de app). - **Resend:** «o domínio não está verificado» → verifique em Domains; «Chave de API inválida ou revogada»; «A chave é de ENVIO APENAS» → informe um endereço para o teste. - **«… foi testado e FALHOU»** — o e-mail segue pelo próximo provedor (ou via Locarë); a marca some sozinha quando ele volta a funcionar. - **«📬 N cobranças antigas não foram avisadas por e-mail»** — o e-mail esteve parado, e o Locarë não manda sozinho aviso de cobrança vencida há mais de 3 dias. *Faça:* registre antes o que já foi pago por fora, depois **Enviar todas agora** ou **Descartar os avisos**. ## Arquivos (fotos e documentos) - **«Nenhum provedor de armazenamento escolhido»** / «Anexar arquivos ainda não está disponível» — *Faça:* Configurações → Serviços → Arquivos, escolha onde guardar. - **Cloudinary:** digite o **Cloud name** e **☁ Conectar Cloudinary** → «Accept access». «Digite o Cloud name antes de conectar»; «Conectou, mas o teste não passou» → o Cloud name tem de ser o da conta que você autorizou; expirou → Reconectar. Com API Key e API Secret, a chave precisa do papel **Master Admin** (com «Media Library User» o primeiro anexo falha). - **R2 / S3:** «Falha ao acessar o bucket: …» — no Cloudflare R2, o endpoint é `https://.r2.cloudflarestorage.com` (não o r2.dev) e a região `auto`; no Backblaze, use uma chave de aplicação, não a Master Application Key («Malformed Access Key Id»). ## Backup no Google Drive - Em **Configurações → Cópia de segurança**, «Enviar sozinho para o Drive conectado» só liga depois de definir a **senha de backup** e conectar uma conta Google (a do e-mail ou outra, em «Usar outra conta do Google»). - **«o Google conectado não tem acesso ao Drive»** — reconecte concedendo o acesso ao Drive. «a conexão com o Google expirou» → reconecte. O histórico mostra ✓ sucesso, ⚠ falha (com o motivo) e ↓ baixar. ## Quando pedir ajuda ao suporte Se mesmo assim não funcionar: em **Configurações → Ajuda do suporte na configuração → Abrir ao suporte…**, libere só a área (Pagamento, E-mail ou Fotos) por 4, 24, 48 ou 72 horas. O suporte consegue **gravar** a configuração, mas não lê as suas chaves nem a sua carteira, e você fecha quando quiser (**Fechar o acesso agora**). Depois avise pelo **Novidades → Sugerir melhoria**, com a mensagem que apareceu. --- Central de Ajuda Locarë · revisão de 23/10/2026 · versão para pessoas: https://app.locareapp.com/manual