Akesia · Documentação

Cobrança automática

Envie a fatura com o PDF (e o link de pagamento, com o Stripe) e deixe a régua lembrar sozinha.

Funcionalidade nova

Este recurso faz parte das funcionalidades de mercado recém-lançadas.

WhatsApp, se a clínica ligar

As mensagens desta página podem sair por WhatsApp nas clínicas que ativaram o WhatsApp (saiba mais) e marcaram WhatsApp para cada uma em Configurações → Notificações. Desligado lá, a tela mostra "não enviado — desligado nas configurações de notificação", nunca "enviado". Documentos e NFS-e vão como link para baixar, válido por 7 dias; a fatura enviada ao paciente vai com o PDF. Faturas e cobranças por WhatsApp dependem de liberação da Akesia.

A cobrança automática começa pelo envio da fatura: você confere e envia a fatura ao paciente, com o PDF em anexo, e uma régua envia os lembretes sozinha nas datas em torno do vencimento. Isso funciona com ou sem o Stripe. Conectando a clínica ao Stripe, a fatura e os lembretes passam a levar um link de pagamento (cartão, e Pix se a clínica ativar), a fatura é baixada sozinha quando o paciente paga, e você acompanha cada cobrança pelo histórico da fatura.

Pré-requisitos

  • Envio da fatura: ligue Envio da fatura por E-mail (e/ou WhatsApp) em Configurações → Notificações. Não precisa de Stripe.
  • Link de pagamento: a clínica precisa concluir o onboarding do Stripe Connect e ficar com status Ativo. Sem isso, a fatura e os lembretes saem sem link.
  • Configuração da plataforma (feita uma única vez pelo operador do sistema): a chave STRIPE_SECRET_KEY precisa estar ativa. Sem ela, o botão Conectar com Stripe retorna uma mensagem clara ("Pagamento online indisponível: a integração Stripe da plataforma ainda não foi ativada…") e nenhuma cobrança é gerada.
  • Webhook do Stripe (STRIPE_CONNECT_WEBHOOK_SECRET) configurado — é o que marca a fatura como paga e dispara a página de "Pagamento confirmado". Sem ele o pagamento acontece no Stripe, mas a fatura não baixa automaticamente.
  • URL pública (NEXT_PUBLIC_APP_URL) apontando para o domínio real — é a base dos links enviados ao paciente.
  • Régua automática: depende da rotina /api/jobs/dunning (chave CRON_SECRET), que roda de hora em hora e envia os lembretes no horário de envio escolhido pela clínica. Com a assinatura da clínica cancelada, não paga ou com o período de teste vencido, a régua para até a assinatura ser reativada.
  • Permissões: o menu Configurações exige poder gerenciar permissões (users WRITE, padrão do ADMIN) e a seção em si exige clinic_settings. Gerar um link de pagamento exige finances WRITE (padrão de ADMIN e PROFESSIONAL). Enviar a fatura ao paciente — por Enviar fatura, Cobrar ou Reenviar — é só do administrador.

Para o administrador

Enviar as faturas

  1. Gere as faturas do mês em Financeiro → Faturas (ou crie uma em Nova fatura, que pergunta ao final se você quer enviá-la agora).
  2. Na linha de cada fatura, clique no ícone de avião de papel (Enviar fatura). Abre o Conferir e enviar: confira o valor, o vencimento, o PDF e, em Vai para, as pessoas marcadas em Cobrança no cadastro do paciente (ou o contato principal, se ninguém estiver), cada uma com uma caixa para WhatsApp e outra para e-mail. Se o contato de alguém estiver errado, clique em Corrigir contato no cartão dessa pessoa — a correção é gravada no contato dela — e em Salvar e enviar. Marque só o que quiser usar: por exemplo, só o pai, ou só o e-mail.
  3. Use Enviar e ir para a próxima para passar pelas faturas pendentes uma a uma. Para enviar várias sem conferir uma a uma, marque-as na lista e use Enviar faturas — a confirmação também deixa escolher os canais.
  4. A fatura passa a Enviado quando a mensagem sai. Detalhes em Enviar para o paciente.

Conectar a clínica para receber

  1. Abra o menu do usuário e clique em Configurações.
  2. Escolha Pagamentos online (grupo Financeiro).
  3. No card "Receba por Pix e cartão", clique em Conectar com Stripe (o botão vira Completar cadastro se o onboarding ficou pendente).
  4. Conclua o cadastro no site do Stripe; você volta automaticamente para Pagamentos online.
  5. Confirme que o selo do card mudou para Ativo. O card se atualiza sozinho enquanto o Stripe analisa — não é preciso recarregar a página. Se ficar em Restrito, ele diz exatamente o que falta (por exemplo, "A Stripe ainda precisa de uma foto do seu documento de identidade").

O Pix quem ativa é você, no painel da Stripe

O checkout oferece cartão desde o primeiro dia. O Pix só entra depois que a clínica o ativa na própria conta Stripe, em Configurações → Métodos de pagamento. A Akesia não tem como ativar por você: para contas brasileiras, o Stripe só aceita esse pedido vindo do titular. Até lá, os links funcionam normalmente — apenas sem a opção Pix. O card "Receba por Pix e cartão", em Configurações → Pagamentos online, avisa quando é o caso e leva direto à tela certa do Stripe.

Configurar a régua de cobrança automática

  1. Em Configurações → Notificações, abra Lembrete de cobrança: o bloco "Régua de cobrança" fica no topo da página. (Em Configurações → Pagamentos online há um atalho para lá.)
  2. No bloco, em Enviar lembretes automaticamente, ligue Automático e E-mail (e/ou WhatsApp). É isso que liga a régua — e escolhe o canal; são os mesmos botões da linha Lembrete de cobrança na lista de Notificações, e cada clique já salva. A linha embaixo diz o que a régua vai fazer.
  3. Em "Dias de envio (relativos ao vencimento)" informe, por exemplo, -3, 0, 3, 7 (negativo = antes, 0 = no dia, positivo = após o vencimento).
  4. Ajuste "Máx. de tentativas por fatura", "Validade do link (dias)" e, se quiser, o "Horário de envio" (de 06:00 a 21:00, no fuso horário da clínica; o padrão é 08:00).
  5. Clique em Salvar configurações (aparece o aviso "Configurações de cobrança salvas").

A partir daí o envio automático roda uma vez por dia, no horário escolhido, e lembra só as faturas já enviadas ao paciente (Enviado ou Parcial): uma fatura Pendente não recebe lembrete. Sem o Stripe, o lembrete sai sem link (e o campo Validade do link não tem efeito); com o Stripe Ativo, as cobranças geradas pela régua aparecem no histórico da fatura com o rótulo "· via régua".

O lembrete só para quando a fatura vira Pago

Sem o Stripe, quem marca a fatura como paga é a clínica — pelo botão Pagar ou pela conciliação do extrato. Uma fatura paga que não foi marcada continua recebendo lembretes.

Cobrar uma fatura específica

  1. No menu, abra Financeiro → Faturas.
  2. Clique na fatura (ícone de olho) para abrir o detalhe.
  3. Na seção "Cobranças", clique em Cobrar (só o administrador vê o botão).
  4. Abre o Conferir e enviar da fatura: confira as pessoas em Cobrança e os canais de cada uma (dá para corrigir o contato de uma pessoa ali mesmo) e clique em Enviar. A mensagem é a do envio da fatura, com o PDF e, com o Stripe Ativo, o link de pagamento. O e-mail só sai com Envio da fatura ligado em Configurações → Notificações.
  5. Para mandar o link você mesmo, use Gerar link: ele cria o link para Copiar, sem enviar nada ao paciente. A cobrança aparece logo abaixo no histórico com o seu status.

Para o profissional

  1. Abra Financeiro → Faturas e clique na fatura desejada para abrir o detalhe.
  2. Na seção "Cobranças" veja a linha do tempo. Cada cobrança mostra um selo de estado — enviada (Ativo), visualizada (quando o paciente abriu o link) e paga (com o meio usado: cartão ou Pix) — além da data de criação, se veio "via régua", a data de pagamento e a taxa.

Cobrança por WhatsApp (em breve)

O envio da fatura pelo WhatsApp — com o PDF na própria mensagem e, com o Stripe, um botão Pagar fatura —, os lembretes e o aviso de pagamento recebido já estão prontos, mas ainda não foram liberados: aguardamos a confirmação da Meta sobre as regras para mensagens de cobrança e a aprovação dos modelos. Até lá, a fatura e os lembretes saem por e-mail. Os detalhes estão em Cobrança integrada.

Para o paciente

  1. Você recebe por e-mail uma mensagem da clínica com a fatura em PDF em anexo, o valor e o vencimento. Quando a fatura é de um serviço cobrado à parte, a mensagem começa identificando o serviço — para não confundir duas faturas do mesmo mês.
  2. Se a clínica usa o Stripe, a mensagem traz também o link para pagamento: toque nele e você é levado direto ao checkout seguro do Stripe. Sem o link, pague pelos dados de pagamento que estão no PDF.
  3. Escolha o meio de pagamento oferecido — cartão sempre, e Pix quando a clínica o tiver ativado na conta dela — e conclua o pagamento.
  4. Ao final aparece a página "Pagamento confirmado!" — pode fechar a página.
  5. No portal do paciente, na aba Financeiro, a fatura passa a exibir o status atualizado (paga).

Links usados ou expirados

Se o link já tiver sido usado ou tiver expirado, o paciente vê uma página explicando o motivo (por exemplo, "Fatura já paga" ou "Link de pagamento expirado"). Nesse caso, gere uma nova cobrança pela fatura para enviar um link válido.

Nesta página