Pular para o conteúdo

Como ligar o PIX e o boleto automáticos

Passo a passo da integração com o Asaas: chave de API, webhook e envio das cobranças.

Atualizado em

Com o Asaas configurado, cada cobrança já sai com PIX e boleto. Quando o inquilino paga, a baixa é automática, sem conferir extrato. A configuração tem cinco etapas dentro do LugAqui (Conta Asaas, Webhook, Padrões de cobrança, Notificações e Revisão) e duas tarefas no painel do Asaas: gerar a chave de API e criar o webhook. É o webhook que avisa o LugAqui quando um pagamento é recebido.

Passo a passo

  1. No LugAqui, abra Configurações > Integração Asaas. Se ainda não tem conta no Asaas, o link "Criar conta no Asaas" leva até lá.
  2. No Asaas, gere a sua chave de API.
  3. De volta ao LugAqui, na etapa "Conta Asaas", escolha o ambiente (Produção para cobrar de verdade; Sandbox serve só para testes), cole a chave em "Chave de API do Asaas" e clique em "Próximo".
    Tela Configurações > Integração Asaas do LugAqui, na etapa Conta Asaas, com o ambiente de integração e o campo Chave de API do Asaas
    Etapa 1, Conta Asaas: ambiente e chave de API. O menu fica em Configurações > Integração Asaas.
  4. Na etapa "Webhook", clique em "Copiar" para copiar a URL do webhook do LugAqui.
    Etapa Webhook do LugAqui mostrando a URL do webhook e o botão Copiar
    Etapa 2, Webhook: a URL que você copia para o Asaas.
  5. No painel do Asaas, vá em Integrações > Webhooks > Adicionar Webhook e preencha como o LugAqui indica: webhook ativo "Sim", a URL que você copiou, versão da API "v3", tipo de envio "Sequencial", fila de sincronização "Sim" e um token de autenticação definido por você. Anote esse token.
    Lista de campos que o LugAqui indica para criar o webhook no painel do Asaas: ativo, nome, URL, e-mail, versão da API v3, tipo de envio sequencial, fila de sincronização e token de autenticação
    O LugAqui mostra como preencher cada campo do webhook no Asaas.
  6. Ainda no Asaas, em Adicionar Eventos > Cobranças, marque os cinco eventos obrigatórios: pagamento recebido, confirmado, vencido, estornado e removido. Salve o webhook.
    Lista dos eventos obrigatórios da categoria Cobranças no LugAqui: PAYMENT_RECEIVED, PAYMENT_CONFIRMED, PAYMENT_OVERDUE, PAYMENT_REFUNDED e PAYMENT_DELETED
    Os cinco eventos obrigatórios, com o que cada um faz no LugAqui.
  7. No LugAqui, cole o token no campo "Cole o token de autenticação aqui" e clique em "Próximo".
    Campo do LugAqui para colar o token de autenticação do webhook gerado no Asaas
    O campo onde você cola o token definido no Asaas.
  8. Na etapa "Padrões de cobrança", escreva, se quiser, a descrição padrão que vai nas cobranças enviadas ao Asaas.
    Etapa Padrões de cobrança do LugAqui, com o campo Descrição padrão da cobrança
    Etapa 3, Padrões de cobrança.
  9. Na etapa "Notificações", ligue o "Envio por WhatsApp" se o WhatsApp da sua empresa já estiver conectado.
    Etapa Notificações do LugAqui, com a opção Envio por WhatsApp
    Etapa 4, Notificações.
  10. Na etapa "Revisão", confira os dados e clique em "Salvar configuração do Asaas". A partir daí as novas cobranças já vão para o Asaas.
    Etapa Revisão do LugAqui, com o resumo da configuração e o botão Salvar configuração do Asaas
    Etapa 5, Revisão: confira e salve.
  11. Para uma cobrança que já existia, abra Financeiro > Cobranças, clique no botão da coluna Ações e use "Enviar Cobrança pro Asaas".
    Tela Financeiro > Cobranças do LugAqui com o menu de ações de uma cobrança aberto, mostrando Registrar pagamento e Enviar Cobrança pro Asaas
    O menu de ações da cobrança. Aqui a opção aparece desativada porque a cobrança está atrasada.

Dicas

  • O dinheiro cai direto na sua conta Asaas. O LugAqui não fica com nenhuma parte do aluguel.
  • O token colado no LugAqui precisa ser exatamente o mesmo definido no webhook do Asaas. Se forem diferentes, os avisos de pagamento não chegam e a baixa não é automática.
  • "Enviar Cobrança pro Asaas" fica desativado em cobranças já pagas, já enviadas ou com vencimento passado.
  • O Asaas não aceita cobranças abaixo de R$ 5,00; essas ficam como cobrança manual.
  • Depois de enviada, use "Ver link de pagamento" para mandar o link para o inquilino pelo WhatsApp.

Este tutorial é do LugAqui, plataforma de gestão de imóveis e aluguéis. Conheça o LugAqui ou entre no sistema.

Veja mais tutoriais em Cobranças e Pagamentos ou tire dúvidas sobre planos, teste grátis e cancelamento nas perguntas frequentes.

Artigos relacionados

Não encontrou o que precisava?

Fale com a equipe do LugAqui.