Akesia · Documentação

Cobrança integrada (Stripe)

Links de pagamento por cartão (e Pix, se a clínica ativar) via Stripe Connect, régua de dunning e histórico de cobrança.

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 integrada conecta a sua clínica ao Stripe e põe um link de pagamento na fatura que o paciente recebe. O paciente abre o link, paga, e a fatura é baixada automaticamente — sem você lançar nada à mão. Você também pode deixar uma régua de cobrança enviando os lembretes sozinha e acompanhar tudo pelo histórico de cobranças de cada fatura.

Enviar a fatura e lembrar não dependem do Stripe

Enviar a fatura ao paciente, com o PDF, e a régua de cobrança funcionam com ou sem o Stripe. Sem ele, as mensagens saem sem link e o paciente paga pelos dados de pagamento do PDF. Com o Stripe Ativo, as mesmas mensagens levam o link de pagamento.

Funcionalidade recente

A cobrança integrada com Stripe é uma adição recente ao módulo financeiro. Antes de cobrar qualquer fatura você precisa conectar a clínica ao Stripe uma única vez (passo abaixo). Pagamentos, taxas e repasses são processados pela sua própria conta Stripe — a clínica recebe direto, sem intermediação.

Como funciona

O fluxo tem três partes, e esta página cobre as três:

Conectar a clínica ao Stripe

A conexão é feita uma única vez por um administrador.

Abra Configurações → Pagamentos online

No menu, vá em Configurações e escolha Pagamentos online (grupo Financeiro). Você verá o cartão "Receba por Pix e cartão".

Clique em "Conectar com Stripe"

O botão Conectar com Stripe leva você ao cadastro (onboarding) do Stripe, onde a conta da sua clínica é criada e os dados bancários são informados. Conclua o cadastro no site do Stripe e volte para a clínica.

Enquanto o cadastro estiver incompleto, o cartão mostra o status Onboarding pendente e exibe o botão Completar cadastro para você retomar de onde parou.

Confira o status

O selo ao lado de "Receba por Pix e cartão" indica em que ponto está a conexão:

SeloO que significa
DesconectadoNenhuma conta conectada. Use Conectar com Stripe.
Onboarding pendenteCadastro iniciado, mas ainda não finalizado. Use Completar cadastro.
AtivoTudo pronto. A clínica já pode gerar links de cobrança.
RestritoO Stripe está esperando alguma informação sobre a conta. O cartão diz qual — por exemplo "A Stripe ainda precisa de uma foto do seu documento de identidade". Use Completar cadastro para enviar o que falta.

Só com o status Ativo é possível gerar cobranças. Tentar cobrar antes disso retorna o aviso "Conecte a clínica ao Stripe para cobrar".

Espere a liberação (você não precisa recarregar)

A análise do Stripe termina depois que você volta do cadastro — às vezes em segundos, às vezes em um minuto. O cartão se atualiza sozinho: ele volta a consultar o Stripe por alguns instantes e também sempre que você retorna para a aba da clínica. Assim que a conta é liberada, o selo passa a Ativo e o botão Gerar link, nas telas de faturas, deixa de ficar desabilitado — sem recarregar a página.

Desconectar não apaga o histórico

O botão Desconectar desativa novas cobranças, mas mantém a conta e todo o histórico de pagamentos. Você pode reconectar depois sem perder nada.

Cobrar uma fatura

Com o Stripe Ativo, o link de pagamento chega ao paciente de três formas.

Junto com a fatura

O envio da fatura — Enviar fatura no Conferir e enviar, ou Enviar faturas para várias da lista — reaproveita a cobrança aberta da fatura, ou cria uma, e manda o link na mesma mensagem que leva o PDF. É o caminho do dia a dia. Se a cobrança não puder ser criada naquele momento, o envio é tentado de novo, em vez de sair sem o link.

As faturas agrupadas de um paciente cobrado por sessão saem numa mensagem só, com um PDF de todas — e, por enquanto, sem link de pagamento, mesmo com o Stripe Ativo. Se do grupo sobrar uma única fatura em aberto, ela sai como uma fatura comum, com o link.

Cobrança individual

  1. Abra a fatura (clique nela na lista de faturas).
  2. Na seção Cobranças, clique em Cobrar.
  3. Abre o Conferir e enviar da fatura — o mesmo do Enviar fatura. Confira as pessoas marcadas em Cobrança e os canais de cada uma e clique em Enviar. A mensagem é a Envio da fatura, com o PDF e o link de pagamento — o mesmo link para todos que recebem.

Quem recebe as mensagens de cobrança — o envio da fatura, os lembretes da régua e o aviso de pagamento recebido — são as pessoas marcadas em Cobrança no cadastro do paciente (o pai e a mãe, por exemplo), cada uma com o próprio consentimento por canal. Se ninguém estiver marcado em Cobrança, elas vão para o contato principal. O responsável financeiro da fatura e da NFS-e é outra informação e não muda com isso.

O Cobrar não manda nada sozinho: toda mensagem ao paciente passa pelo Conferir e enviar e sai pela fila de envio, que tenta de novo quando um canal falha. Por isso o Cobrar (e o Reenviar do histórico) só aparecem para o administrador, como o Enviar fatura, e somem quando a fatura está paga ou cancelada.

Para mandar o link por conta própria, ou cobrar só uma parte do saldo:

  1. Na seção Cobranças da fatura, clique em Gerar link.
  2. No modal Gerar link de pagamento, confira o Valor — ele já vem preenchido com o saldo em aberto, que aparece entre parênteses (ex.: Valor (saldo em aberto: R$ 200,00)). Você pode reduzir o valor para fazer uma cobrança parcial, mas não pode ultrapassar o saldo em aberto (o sistema rejeita valores acima dele).
  3. Clique em Gerar link.

O modal mostra o link de pagamento com um botão Copiar. Nada é enviado ao paciente: copie o link e mande como preferir. O paciente abre esse link e paga no checkout do Stripe. Um envio da fatura feito depois reaproveita esse link aberto.

Fatura de serviço é identificada na mensagem

Quando a fatura é de um serviço com fatura própria, a mensagem enviada começa com "Fatura de <serviço>" (e o assunto do e-mail traz o nome entre parênteses). Sem isso, duas cobranças do mesmo mês chegariam como "sua fatura de 08/2026" com valores diferentes, e o pagador não teria como saber qual é qual — nem qual Pix usar. Se você quiser o nome em outro lugar do texto, use a variável {{serviceName}} no template de cobrança; nesse caso o sistema não acrescenta a linha automática. Faturas normais, sem serviço, continuam com o texto de sempre.

Cartão sempre; Pix só se a sua conta Stripe aceitar

O link de pagamento oferece os meios que a sua conta Stripe realmente aceita. Cartão de crédito está sempre disponível — é o que a conta precisa ter ativo para o selo chegar a Ativo. O Pix, não: ele só aparece no checkout se a sua clínica tiver ativado o Pix na própria conta Stripe.

Quem ativa o Pix é você, no painel da Stripe — em Configurações → Métodos de pagamento (dashboard.stripe.com). A Akesia não consegue ativar por você: para contas brasileiras, o Stripe só aceita esse pedido vindo do titular da conta. Enquanto o Pix não estiver ativo, o link continua funcionando normalmente, apenas com cartão.

Em Configurações → Pagamentos online, o cartão "Receba por Pix e cartão" avisa quando é esse o caso, com o link direto para a tela do Stripe onde a ativação é feita.

Em lote

O antigo Cobrar selecionadas virou Enviar faturas: selecione as faturas na lista e envie todas de uma vez (veja como). Com o Stripe Ativo, cada fatura vai com o PDF e o link de pagamento dela; sem o Stripe, só com o PDF.

O que acontece quando o paciente paga

  • A fatura é baixada conforme o valor recebido (quitação total ou parcial — o status passa a PAGO quando o saldo zera).
  • O pagamento entra na conciliação como um lançamento de origem Stripe, sem digitação manual.
  • Se a clínica usa NFS-e com emissão automática ao receber, a nota é colocada na fila assim que a fatura é quitada.

O valor que cai na conta tem desconto da taxa do Stripe

O Stripe cobra uma taxa por transação. No histórico, cada cobrança paga mostra a taxa descontada e o sistema guarda o valor líquido — útil para conferir o repasse (payout) que cai na conta bancária da clínica.

Régua de cobrança (dunning)

A régua de cobrança envia lembretes de pagamento automaticamente, em datas relativas ao vencimento da fatura. Ela roda uma vez por dia, no horário de envio da clínica (padrão: 08:00, no fuso horário da clínica), e lembra só as faturas que já foram enviadas ao paciente.

A régua funciona sem o Stripe: o lembrete sai com o valor, o mês de referência e o vencimento, sem link. Com o Stripe Ativo, ele reaproveita (ou cria) o link de pagamento da fatura e o leva na mensagem. O lembrete nunca leva o PDF — o PDF vai no envio da fatura.

Configurar a régua

Em Configurações → Notificações, abra Lembrete de cobrança. O bloco Régua de cobrança fica no topo da página, acima dos textos. (Em Configurações → Pagamentos online há um atalho para lá.)

Ligue os lembretes em Notificações

Se a régua envia, e por qual canal, é a escolha Automático e E-mail (e/ou WhatsApp) de Lembrete de cobrança. Sem isso, nenhum lembrete é enviado. Dá para ligar no próprio bloco Régua de cobrança, em Enviar lembretes automaticamente — os mesmos botões da linha em Configurações → Notificações, sincronizados e salvos a cada clique — com uma linha que diz o que a régua vai fazer ("Ligado: … por e-mail e WhatsApp, nos dias e horário abaixo", "Desligado…", ou um aviso quando Automático está ligado sem canal). Sem permissão de escrita em Notificações, esses botões aparecem só para leitura. O resto do bloco define quando os lembretes saem (veja O que a clínica envia).

Defina os dias de envio

No campo Dias de envio (relativos ao vencimento), informe os dias separados por vírgula — por exemplo -3, 0, 3, 7:

  • Negativo = antes do vencimento (ex.: -3 envia 3 dias antes).
  • 0 = no dia do vencimento.
  • Positivo = depois do vencimento (ex.: 7 envia 7 dias após).

São aceitos até 8 valores.

Escolha o horário de envio

Em Horário de envio, escolha a hora cheia em que a régua roda, de 06:00 a 21:00, no fuso horário da clínica. Padrão (08:00) acompanha o valor da Akesia. A régua roda uma vez por dia: se o novo horário já passou hoje e o envio de hoje ainda não saiu, ele sai na próxima hora cheia (até as 21:00; depois disso, vale a partir de amanhã), sem perder os lembretes do dia.

Defina os limites

  • Máx. de tentativas por fatura: em quantos dias uma mesma fatura pode receber lembrete no total (de 1 a 12). Cada dia de lembrete conta uma tentativa, mesmo quando ele sai por WhatsApp e por e-mail.
  • Validade do link (dias): por quanto tempo o link de pagamento fica válido antes de expirar (de 1 a 30 dias). Só vale com o Stripe Ativo.

(Cobrança mensal fixa) Cobrar ao criar a fatura

Clínicas no modo de cobrança mensal fixa veem a opção Gerar cobrança automaticamente ao criar fatura mensal, que dispara o link assim que a fatura é emitida.

Salve

Clique em Salvar configurações.

Quando um lembrete é (ou não) enviado

A régua só envia um lembrete para uma fatura quando todas as condições abaixo são verdadeiras:

  • Lembrete de cobrança está ligado como Automático num canal (no bloco da régua ou em Configurações → Notificações). (O Stripe não é condição: sem ele, o lembrete sai sem link.)
  • A fatura está ENVIADO ou PARCIAL — ou seja, já chegou ao paciente — e ainda tem saldo em aberto. Uma fatura PENDENTE nunca recebe lembrete: envie a fatura primeiro.
  • Hoje é uma das datas calculadas a partir do vencimento + dia de envio configurado.
  • A fatura ainda não atingiu o máximo de tentativas.
  • O paciente não optou por não receber cobranças (opt-out).
  • Alguém marcado em Cobrança (ou o contato principal, se ninguém estiver) tem o contato disponível no canal escolhido (telefone para WhatsApp, e-mail para e-mail) e deu consentimento para ele. O lembrete vai para cada uma dessas pessoas; quem não autorizou o canal, ou pediu PARAR, fica de fora.
  • A assinatura da clínica na Akesia está em dia: 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.

Enquanto a cobrança por WhatsApp não é liberada, a caixa de WhatsApp das mensagens de cobrança aparece como — em Notificações, e os lembretes saem só por e-mail. Lembretes barrados por falta de consentimento ou por estarem desligados não contam para o máximo de tentativas da fatura: só conta o que de fato chegou ao serviço de envio. E conta por dia, não por canal: um lembrete enviado no mesmo dia por WhatsApp e por e-mail gasta uma tentativa só.

Na hora de sair, cada link ou lembrete confere a fatura de novo: se ela foi paga ou cancelada (ou excluída) depois que a mensagem foi preparada — um Pix que caiu minutos antes, uma nova tentativa depois de uma falha —, a mensagem não é enviada, e o histórico de Mensagens → Todas as mensagens mostra "a fatura já estava paga ou cancelada no momento do envio".

Do mesmo jeito, se o link daquela mensagem deixou de valer — você clicou em Gerar link de novo, o que cancela a cobrança anterior e cria outra, ou o link expirou —, a mensagem antiga não é enviada (o histórico mostra "o link de pagamento já tinha sido substituído por uma nova cobrança ou expirado"). O paciente recebe só o link novo, que é o que abre a página de pagamento.

No máximo um lembrete por fatura por dia

Mesmo que várias regras coincidam no mesmo dia, a régua envia um único lembrete por fatura por dia. Faturas pagas ou canceladas nunca entram na régua.

Sem o Stripe, marque as faturas pagas

O lembrete para quando a fatura vira Pago (ou é cancelada). Com o Stripe, isso acontece sozinho quando o paciente paga pelo link. Sem ele, a fatura só vira Pago quando você marca o pagamento ou concilia o extrato: uma clínica que não registra os pagamentos vai lembrar quem já pagou. O texto padrão diz "Se você já fez o pagamento, por favor desconsidere esta mensagem", mas o certo é manter as faturas em dia.

Cobrança por WhatsApp

O envio da fatura e dos lembretes pelo WhatsApp já está pronto, mas só sai depois que a Akesia liberar as mensagens de pagamento — ela aguarda a confirmação da Meta sobre as regras para mensagens de cobrança — e que a Meta aprovar os modelos dessas mensagens. Até lá, tudo continua como descrito acima — a fatura e os lembretes saem por e-mail, e Notificações não oferece WhatsApp para eles.

Quando for liberado, nas clínicas com o WhatsApp ligado e para as pessoas em Cobrança que autorizaram o contato por WhatsApp:

  • o envio da fatura chega com o PDF da fatura como documento na própria mensagem, com o valor, o mês de referência e o vencimento; com o Stripe Ativo, também com um botão Pagar fatura que abre o mesmo link de pagamento do e-mail;
  • os lembretes da régua chegam com o valor, o mês de referência e o vencimento, sem PDF; o botão Pagar fatura só vem com o Stripe Ativo;
  • depois que o pagamento é confirmado, quem está em Cobrança recebe um aviso de pagamento recebido;
  • o aviso de cada canal na tela de cobrança passa a dizer se o WhatsApp foi enviado ou por que não saiu.

Quando isso acontecer, a caixa de WhatsApp aparece nas linhas de cobrança em Configurações → Notificações, desmarcada: a clínica decide se marca. A mudança será anunciada em Novidades.

Enquanto a Meta analisa o modelo da fatura com o PDF, a fatura não sai pelo WhatsApp — com ou sem Stripe — (a mensagem fica como "modelo de mensagem ainda não aprovado pela Meta") e o e-mail sai normalmente. O mesmo vale para o lembrete de cobrança enquanto o seu modelo está em análise. Os modelos antigos, que diziam "pagar por Pix ou cartão", não são mais usados. Em Configurações → Notificações, a aba WhatsApp de cada mensagem mostra a situação do modelo na Meta.

Histórico de cobranças

Dentro da fatura, a seção Cobranças lista todas as cobranças geradas — manuais ou pela régua — da mais recente para a mais antiga. Cada item mostra um selo de status, o valor, a data de criação e detalhes como "via régua", "paga em DD/MM/AAAA" e a taxa do Stripe.

Quando ainda não houve nenhuma cobrança, aparece "Nenhuma cobrança gerada para esta fatura."

Selos de status

SeloSignificado
Link ativoLink gerado e válido, ainda não aberto pelo paciente.
Link visualizadoO paciente já abriu o link, mas ainda não pagou.
Pago via PixCobrança paga por Pix.
Pago via cartãoCobrança paga por cartão.
Link expiradoPassou a validade configurada sem pagamento.
Link canceladoCobrança cancelada (manualmente ou substituída por uma nova).
ReembolsadaCobrança paga que foi reembolsada.

Ações por cobrança

  • Cobranças com status "Link ativo" (abertas): você pode Copiar link para mandar ao paciente por conta própria, Reenviar (só o administrador: abre o Conferir e enviar da fatura, que manda de novo o PDF com o link) ou Cancelar cobrança.
  • Cobranças pagas: aparece o botão Reembolsar. O reembolso é processado pelo Stripe e, quando confirmado, a fatura é reaberta (total ou parcialmente, conforme o valor reembolsado).

Gerar uma nova cobrança cancela a anterior

Ao gerar uma nova cobrança para uma fatura que já tinha um link aberto, o link anterior é cancelado automaticamente. Sempre use o link mais recente do histórico.

O link enviado ao paciente é estável: ele continua funcionando mesmo que a sessão de pagamento do Stripe precise ser renovada (o sistema faz isso sozinho, já que as sessões do Stripe duram no máximo 24 horas). Ao abrir o link, o paciente vai direto para o checkout do Stripe, onde escolhe entre os meios que a conta da clínica aceita (cartão sempre; Pix quando a clínica o tiver ativado).

Se o paciente abrir um link que não está mais disponível, ele vê uma mensagem explicando o motivo:

  • Inválido — link adulterado, inexistente ou já reembolsado.
  • Pago — a cobrança já foi paga.
  • Expirado — o link passou da validade ou a cobrança foi cancelada.

Pix recusado não derruba o link

Se um pagamento Pix for recusado, a cobrança continua aberta e o paciente pode tentar de novo pelo mesmo link — o motivo da falha fica registrado no histórico.

Perguntas frequentes

Quem recebe o dinheiro? A própria clínica, na conta Stripe que você conectou. A plataforma pode aplicar uma taxa de serviço conforme o seu plano; o valor líquido de cada cobrança fica registrado no histórico.

Preciso conferir os repasses do Stripe? Os repasses (payouts) que caem na conta bancária da clínica aparecem na conciliação bancária e podem ser conferidos contra os valores líquidos das cobranças pagas no período.

Quais permissões são necessárias? Gerar, cancelar e reembolsar cobranças exige acesso de escrita ao módulo financeiro. Conectar/desconectar o Stripe exige acesso de escrita às configurações da clínica (perfil de administrador).

Nesta página