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:

1. 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**.
2. 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**.