Cobrança automática

Gere links de pagamento pela fatura e deixe a régua enviar as cobranças sozinha.

Envio por WhatsApp ainda não está ativo

As mensagens descritas nesta página saem por e-mail. A opção de WhatsApp e o consentimento correspondente existem nas telas, mas ainda não há provedor de envio ligado — nada é entregue por WhatsApp hoje. Ao configurar um aviso que o paciente precise receber, garanta que ele tenha e-mail no cadastro.

A cobrança automática conecta a sua clínica ao Stripe e permite gerar links de pagamento direto da fatura. Você pode cobrar uma fatura na hora, ativar uma régua que envia os lembretes sozinha nas datas em torno do vencimento, e acompanhar o status de cada cobrança pelo histórico da fatura.

Pré-requisitos

Conta conectada: a clínica precisa concluir o onboarding do Stripe Connect e ficar com status Ativo antes de qualquer cobrança funcionar.
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 do cron diário /api/jobs/dunning (chave CRON_SECRET).
Permissões: o menu Configurações exige poder gerenciar permissões (users WRITE, padrão do ADMIN) e a aba em si exige clinic_settings. Cobrar faturas exige finances WRITE (padrão de ADMIN e PROFESSIONAL).

Para o administrador

Conectar a clínica para receber

Abra o menu do usuário e clique em Configurações.
Selecione a aba Pagamentos.
No card "Receba por Pix e cartão", clique em Conectar com Stripe (o botão vira Completar cadastro se o onboarding ficou pendente).
Conclua o cadastro no site do Stripe; você volta automaticamente para a aba Pagamentos.
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, avisa quando é o caso e leva direto à tela certa do Stripe.

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

Ainda em Configurações → Pagamentos, vá ao bloco "Régua de cobrança".
Marque "Ativar régua de cobrança automática".
Em "Dias de envio (relativos ao vencimento)" informe, por exemplo, -3, 0, 3, 7 (negativo = antes, 0 = no dia, positivo = após o vencimento).
Marque "Enviar por WhatsApp" e/ou "Enviar por e-mail".
Ajuste "Máx. de tentativas por fatura" e "Validade do link (dias)".
Clique em Salvar configurações (aparece o aviso "Configurações de cobrança salvas").

A partir daí o envio automático roda diariamente. Cobranças geradas pela régua aparecem no histórico da fatura com o rótulo "· via régua".

Cobrar uma fatura específica

No menu, abra Financeiro → Faturas.
Clique na fatura (ícone de olho) para abrir o detalhe.
Na seção "Cobranças", clique em Cobrar.
Confira o Valor, marque WhatsApp e/ou E-mail (ou desmarque ambos para apenas copiar o link) e clique em Gerar link de cobrança.
Use Copiar para enviar o link manualmente, se quiser. A cobrança recém-criada aparece logo abaixo no histórico com o seu status.

Para o profissional

Abra Financeiro → Faturas e clique na fatura desejada para abrir o detalhe.
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.

Para o paciente

Você recebe por WhatsApp ou e-mail uma mensagem da clínica com o link para pagamento da fatura (valor e vencimento vêm na mensagem). Quando a fatura é de um serviço cobrado à parte, a mensagem começa identificando o serviço — para não confundir duas cobranças do mesmo mês.
Toque no link: você é levado direto ao checkout seguro do Stripe.
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.
Ao final aparece a página "Pagamento confirmado!" — pode fechar a página.
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.