Quando uma cobrança é recusada ou não chega a ser gerada, o MEDSAC exibe a mensagem do provedor de pagamento para você corrigir. A boa notícia: a cobrança não é criada pela metade — ou cria tudo, ou nada. Este guia reúne as causas mais comuns e a solução de cada uma.
1. A cobrança não foi gerada (QR não apareceu)
Quase sempre é dados do contato ou configuração do provedor. Confira nesta ordem:
| Sintoma / mensagem | Causa provável | Solução |
|---|---|---|
| "Sem ambiente configurado para este tipo de transação" | Pix não habilitado na conta do provedor | No painel do provedor, habilite o Pix (chave Pix / recebedor configurado). Veja Configurar o provedor Pagar.me. |
| Erro citando telefone | Contato sem telefone | O Pix exige o telefone do cliente. Cadastre o telefone no contato e gere a cobrança novamente. |
| Erro citando e-mail | Contato sem e-mail e sem fallback | O Pix exige o e-mail do cliente. Cadastre o e-mail no contato ou configure o e-mail de fallback na integração. |
| Erro de CPF | CPF do pagador inválido | Revise o CPF informado no formulário de cobrança (campo obrigatório). |
Dica: a maioria dessas falhas vem de cadastro incompleto do contato (telefone, e-mail) ou de Pix não liberado na conta do provedor.
2. Erro de autenticação ao testar a conexão
Se o Testar conexão falhar com erro de autenticação, a chave secreta está incorreta ou é do ambiente errado (chave de teste no ambiente de produção, ou vice-versa). Reveja a credencial em Configurar o provedor Pagar.me — lembre que o ambiente é definido pela chave.
3. Status "Pagamento recusado"
Esse status significa que a transação falhou no provedor (ele informou recusa via webhook). Para entender o motivo, consulte a cobrança no painel do provedor de pagamento. Se o paciente quiser tentar de novo, gere uma nova cobrança — veja Gerar uma cobrança Pix na conversa.
4. O paciente pagou, mas o status não mudou
Aqui o problema costuma ser o webhook, não a cobrança:
- Confirme que o webhook está cadastrado no painel do provedor com a URL correta. Se você regenerou o secret, a URL anterior foi invalidada — recadastre a nova. Veja Configurar o webhook do Pagar.me.
- Como solução imediata, abra a cobrança na tela global e clique em Sincronizar status (reconciliação manual). Detalhes em Sincronizar status e cancelar cobrança.
Regra de ouro: Pago sempre vence Expirado, e uma cobrança paga nunca é rebaixada — então sincronizar nunca "desfaz" um pagamento.
Checklist rápido
- Contato com telefone e e-mail (ou e-mail de fallback configurado).
- CPF do pagador válido no formulário.
- Pix habilitado na conta do provedor.
- Chave correta e do ambiente certo (use Testar conexão).
- Webhook cadastrado e com a URL atual.
Não resolveu? Fale com a equipe MEDSAC em suporte@medsac.com.br. Veja também a FAQ — Perguntas frequentes sobre Pagamentos e Status da cobrança e labels.