💰 Links de Pagamento (Pix)
Links Pix enviados ao paciente, com baixa automática quando o pagamento cai.
Dúvidas comuns desta tela — toque numa pergunta e a Helô responde:
Links de Pagamento (Pix)
Do manual: abrir esta parte no manual completo ›
Em produção desde 13/10/2026 (#409). A clínica cobra o paciente por um link Pix (QR Code ou "copia e cola") e, quando o banco confirma o pagamento, o sistema dá a baixa sozinho no financeiro. É opcional: só funciona depois que a clínica cadastra e ativa um provedor Pix; sem provedor ativo, nenhuma opção de link aparece nas telas de cobrança.
O único tipo disponível hoje é "Pix — API padrão Banco Central (qualquer banco)". O banco fornece o certificado e as credenciais (Client ID e Client secret). Gateways de pagamento (cartão, boleto) ainda não existem no Rabi — só Pix pelo padrão do Banco Central.
Configurar o provedor (administrador)
- Abra a aba de pagamentos
Configurações › Parâmetros › aba "Pagamentos (links)" (permissão PARAMETROS; para alterar, UPDATE). A tela explica: "Só um fica ativo por vez: ele gera os links no agendamento online e para os atendentes. O pagamento confirmado dá baixa sozinho no financeiro."
- Cadastre o provedor
Novo provedor → tipo Pix. Campos: Banco, URL da API Pix, URL do token (OAuth), Escopos, Chave Pix da clínica, Validade do link (minutos) (padrão 1440 = 24 h), Client ID e Client secret, certificado do banco (.pfx/.p12 com senha, ou certificado e chave em PEM), parâmetros extras (quando o banco pede), Conta caixa onde o dinheiro cai e Forma de pagamento da baixa (vazio = a forma Pix cadastrada).
- Teste e ative
Testar conexão ("Conexão com o provedor OK."), Cadastrar aviso ("Aviso automático de pagamento cadastrado no provedor.") e ative. A situação mostra "Ativo desde dd/mm hh:mm: <nome> (<tipo>)." ou "Nenhum provedor ativo: os links de pagamento estão desligados." Só um provedor fica ativo por vez; Desligar links desliga tudo e o Histórico de vigência mostra quando cada um esteve ativo.
Gerar e enviar o link (atendente)
- Na parcela em aberto (gerador de parcelas do registro financeiro): ícone "Link de pagamento (Pix)".
- No sinal do agendamento "Pendente de Pagamento": botão "Link de pagamento" no aviso do sinal — ver Agendamento.
- A janela mostra o QR Code, "Copiar Pix copia e cola", "Enviar ao paciente" por WhatsApp, SMS ou e-mail (vazio = o contato do cadastro) e "Cancelar link" (pede motivo). Ela acompanha até o pagamento: "Aguardando pagamento" → "Baixa feita no financeiro."
- O paciente recebe: "<descrição>: R$ X. Pague por Pix pelo link: <endereço>".
- Agendamento online: com provedor ativo, o paciente pode pagar o sinal pelo próprio agendamento online.
- Quem pode: ver com VIEW e gerar com UPDATE em REGISTROS FINANCEIROS, CONTAS CAIXAS ou AGENDAMENTO/ACOLHIMENTO/CONFIRMAÇÃO.
Baixa automática e acompanhamento
- A baixa acontece pelo aviso do banco ou por uma verificação a cada 5 minutos, sempre conferindo a cobrança no banco. O Pix do sinal confirma o agendamento sozinho.
- Se a baixa falhar: "A baixa automática falhou: <motivo>. Dê a baixa manualmente."
- Menu Financeiro › "Links de Pagamento": "Links Pix gerados para pacientes (parcelas e sinal do agendamento)", com os filtros Aguardando pagamento, Pagos sem baixa ("Pagos no banco, mas a baixa automática falhou" — confira estes todo dia) e Agendamento online.
| Mensagem | O que fazer |
|---|---|
| "Nenhum provedor de pagamento ativo. Configure em Configurações › Financeiro › Pagamentos." | Ative um provedor. O caminho certo é Configurações › Parâmetros › Pagamentos (links). |
| "Esta parcela já está paga." | Não há o que cobrar. |
| "Link de pagamento é só para recebimento." | Contas a pagar não geram link. |
| "Este agendamento não está aguardando pagamento do sinal." | O agendamento não está em "Pendente de Pagamento". |
| "O prazo para pagar já terminou." | O link venceu: gere outro. |
| "Só link pendente pode ser cancelado." | Link pago ou já cancelado não se cancela. |
Gerar e enviar o link
Do manual: abrir esta parte no manual completo ›
- Na parcela em aberto (gerador de parcelas do registro financeiro): ícone "Link de pagamento (Pix)".
- No sinal do agendamento "Pendente de Pagamento": botão "Link de pagamento" no aviso do sinal — ver Agendamento.
- A janela mostra o QR Code, "Copiar Pix copia e cola", "Enviar ao paciente" por WhatsApp, SMS ou e-mail (vazio = o contato do cadastro) e "Cancelar link" (pede motivo). Ela acompanha até o pagamento: "Aguardando pagamento" → "Baixa feita no financeiro."
- O paciente recebe: "<descrição>: R$ X. Pague por Pix pelo link: <endereço>".
- Agendamento online: com provedor ativo, o paciente pode pagar o sinal pelo próprio agendamento online.
- Quem pode: ver com VIEW e gerar com UPDATE em REGISTROS FINANCEIROS, CONTAS CAIXAS ou AGENDAMENTO/ACOLHIMENTO/CONFIRMAÇÃO.
Baixa automática e acompanhamento
Do manual: abrir esta parte no manual completo ›
- A baixa acontece pelo aviso do banco ou por uma verificação a cada 5 minutos, sempre conferindo a cobrança no banco. O Pix do sinal confirma o agendamento sozinho.
- Se a baixa falhar: "A baixa automática falhou: <motivo>. Dê a baixa manualmente."
- Menu Financeiro › "Links de Pagamento": "Links Pix gerados para pacientes (parcelas e sinal do agendamento)", com os filtros Aguardando pagamento, Pagos sem baixa ("Pagos no banco, mas a baixa automática falhou" — confira estes todo dia) e Agendamento online.
| Mensagem | O que fazer |
|---|---|
| "Nenhum provedor de pagamento ativo. Configure em Configurações › Financeiro › Pagamentos." | Ative um provedor. O caminho certo é Configurações › Parâmetros › Pagamentos (links). |
| "Esta parcela já está paga." | Não há o que cobrar. |
| "Link de pagamento é só para recebimento." | Contas a pagar não geram link. |
| "Este agendamento não está aguardando pagamento do sinal." | O agendamento não está em "Pendente de Pagamento". |
| "O prazo para pagar já terminou." | O link venceu: gere outro. |
| "Só link pendente pode ser cancelado." | Link pago ou já cancelado não se cancela. |
Configurar o provedor
Do manual: abrir esta parte no manual completo ›
- Abra a aba de pagamentos
Configurações › Parâmetros › aba "Pagamentos (links)" (permissão PARAMETROS; para alterar, UPDATE). A tela explica: "Só um fica ativo por vez: ele gera os links no agendamento online e para os atendentes. O pagamento confirmado dá baixa sozinho no financeiro."
- Cadastre o provedor
Novo provedor → tipo Pix. Campos: Banco, URL da API Pix, URL do token (OAuth), Escopos, Chave Pix da clínica, Validade do link (minutos) (padrão 1440 = 24 h), Client ID e Client secret, certificado do banco (.pfx/.p12 com senha, ou certificado e chave em PEM), parâmetros extras (quando o banco pede), Conta caixa onde o dinheiro cai e Forma de pagamento da baixa (vazio = a forma Pix cadastrada).
- Teste e ative
Testar conexão ("Conexão com o provedor OK."), Cadastrar aviso ("Aviso automático de pagamento cadastrado no provedor.") e ative. A situação mostra "Ativo desde dd/mm hh:mm: <nome> (<tipo>)." ou "Nenhum provedor ativo: os links de pagamento estão desligados." Só um provedor fica ativo por vez; Desligar links desliga tudo e o Histórico de vigência mostra quando cada um esteve ativo.
Lição: links de pagamento Pix
Do manual: abrir esta parte no manual completo ›
Opcional: só funciona depois que a clínica contrata a API Pix com o banco (o banco fornece certificado e credenciais) e cadastra e ativa o provedor. Sem provedor ativo, nada aparece nas telas de cobrança.
- Configurar (administrador): Configurações › Parâmetros › aba "Pagamentos (links)" (permissão PARAMETROS; alterar = UPDATE) → Novo provedor → tipo "Pix — API padrão Banco Central (qualquer banco)": banco, URL da API Pix, URL do token (OAuth), escopos, chave Pix da clínica, validade do link (padrão 1440 minutos = 24 h), Client ID/secret, certificado do banco (.pfx/.p12 e senha, ou PEM), conta caixa onde o dinheiro cai e forma de pagamento da baixa (vazio = a forma Pix cadastrada). Testar conexão ("Conexão com o provedor OK."), Cadastrar aviso (aviso automático de pagamento no provedor) e ativar. Só um provedor fica ativo por vez; há "Desligar links" e "Histórico de vigência".
- Gerar o link: ícone "Link de pagamento (Pix)" na parcela em aberto (gerador de parcelas do registro financeiro) ou botão "Link de pagamento" no aviso de sinal do agendamento "Pendente de Pagamento".
- Enviar: a janela mostra o QR Code, "Copiar Pix copia e cola", "Enviar ao paciente" (WhatsApp, SMS ou e-mail — vazio = o contato do cadastro) e "Cancelar link" (pede motivo). O paciente recebe "<descrição>: R$ X. Pague por Pix pelo link: <url>".
- Baixa automática: pelo aviso do banco ou por verificação a cada 5 minutos, sempre consultando a cobrança — "Baixa feita no financeiro.". O Pix do sinal confirma o agendamento sozinho.
- Acompanhar: Financeiro › "Links de Pagamento" (menu novo) — filtros Aguardando pagamento, Pagos sem baixa ("Pagos no banco, mas a baixa automática falhou") e Agendamento online. Se a baixa falhar: "A baixa automática falhou: <motivo>. Dê a baixa manualmente."
Permissões para ver/gerar: REGISTROS FINANCEIROS, CONTAS CAIXAS ou AGENDAMENTO/ACOLHIMENTO/CONFIRMAÇÃO (VIEW para ver, UPDATE para gerar). Link é só para recebimento. Gateways de cartão/boleto (Asaas, Pagar.me etc.) não existem — só Pix padrão Banco Central. A issue segue aberta (melhorias), mas a função está no ar.
Pergunte à Helô com as suas palavras, veja a Central de Ajuda ou escreva para o suporte: contato@rabisistemas.com.br.