A configuração do pagamento fica em **Configurações → Integrações → MEDSAC Pagamentos → Pagar.me**. Apenas **administradores** têm acesso.

## Passo 1 — Abrir a integração

Em **Configurações → Integrações**, clique no card **MEDSAC Pagamentos** e depois em **Pagar.me** (a lista de provedores também mostra Mercado Pago, Asaas e Rede como "Em breve").

## Passo 2 — Definir o ambiente

| Ambiente     | Quando usar                                               |
| ------------ | --------------------------------------------------------- |
| **Sandbox**  | Testes/homologação. Use a chave de teste (`sk_test_...`). |
| **Produção** | Cobranças reais. Use a chave de produção (`sk_...`).      |

O ambiente é definido **pela chave** — a URL da API é a mesma nos dois casos.

## Passo 3 — Credenciais

* **Secret key** — sua chave secreta do Pagar.me (Configurações → Chaves no painel Pagar.me). É gravada **criptografada** e **nunca** volta em texto: a tela mostra apenas um valor mascarado (`sk_test_****1234`). Deixar o campo em branco ao salvar **não apaga** a chave existente.

* **E-mail de fallback** — usado quando o contato não tem e-mail cadastrado. O **Pix do Pagar.me exige o e-mail do cliente**; sem e-mail do contato nem fallback, a cobrança falha. Ex.: [`financeiro@suaclinica.com.br`](mailto:financeiro@suaclinica.com.br).

## Passo 4 — Salvar e testar

1. Deixe a chave **Pix** habilitada.

2. Clique em **Salvar**.

3. Clique em **Testar conexão** — o MEDSAC faz uma chamada leve ao Pagar.me (lista de webhooks) e confirma se a chave é válida. Erro de autenticação indica chave incorreta ou do ambiente errado.

## Pré-requisitos no painel Pagar.me (sandbox)

Para o Pix funcionar de fato, a conta Pagar.me precisa estar com **Pix habilitado** (chave Pix / recebedor configurado). Sem isso, a cobrança é criada mas a transação Pix volta recusada com *"Sem ambiente configurado para este tipo de transação."*. Além disso, o **contato precisa ter telefone** — o Pix do Pagar.me exige o telefone do cliente.

## Próximos passos

* **Configurar o webhook do Pagar.me** — para o status do pagamento atualizar automaticamente.

* **Template WhatsApp de cobrança** — para enviar a cobrança com botão "Pagar agora".