## Visão geral

O **agendamento pago** conecta o módulo **Agenda** ao módulo **Pagamentos**: quando um tipo de evento
exige pagamento, o horário escolhido **não fica confirmado na hora**. Ele entra em estado de
**aguardando pagamento** e só vira **confirmado** depois que a Conversa Labs recebe a aprovação do
pagamento pelo gateway. Assim você só bloqueia a agenda para quem realmente pagou.

Cada tipo de evento define **como** o pagamento funciona: uma **cobrança única** para confirmar, um
**sinal** (depósito) menor que o valor total, ou uma **assinatura** — exigir que o cliente já seja
assinante, ou criar a assinatura no momento do agendamento.

## Pré-requisitos

- Módulo **Agenda** ativo, com ao menos um **tipo de evento** e **disponibilidade** configurados.
- Módulo **Pagamentos** ativo, com uma **conexão de gateway** (Asaas ou Mercado Pago).
- Para assinatura, um **plano** de pagamento criado.
- Perfil com permissão para editar tipos de evento e cobranças.

## Passo a passo

1. Na **Agenda**, abra o **tipo de evento** que deseja cobrar.
2. Escolha o **modo de pagamento** (veja a tabela abaixo): nenhum, cobrança única, exigir assinatura
   ou assinar ao agendar.
3. Defina o **valor** e a **moeda**. Se o tipo estiver ligado a um **produto do Catálogo** ou a um
   **plano**, o preço pode vir de lá.
4. (Cobrança única, opcional) defina um **sinal** (depósito) **menor** que o valor total — apenas o
   sinal é cobrado para confirmar; o restante você recebe manualmente ou no local.
5. Escolha as **formas de pagamento** aceitas: **PIX**, **boleto** e/ou **cartão** (link hospedado).
6. Selecione a **conexão de gateway** e, para assinatura, o **plano**.
7. Defina o **modo de reserva** do horário e o **tempo de reserva** (veja "Reserva e expiração").
8. Salve. A partir daí, qualquer agendamento desse tipo passa a exigir pagamento.

### Modos de pagamento

| Modo | O que faz |
|---|---|
| **Nenhum** (`none`) | Sem pagamento — o horário confirma na hora. |
| **Cobrança única** (`one_off`) | Gera uma cobrança única; o horário confirma quando ela é paga. |
| **Exigir assinatura** (`subscription_gate`) | Quem já tem **assinatura ativa** no plano agenda **grátis**; quem não tem é direcionado a pagar ou assinar. |
| **Assinar ao agendar** (`recurring`) | Cria uma assinatura no gateway no momento do agendamento; a primeira cobrança confirma o horário. |

## Configurações & opções

- **Valor e moeda**: o preço cobrado para confirmar. A ordem de resolução é: valor definido no tipo
  de evento → preço do **produto do Catálogo** vinculado → valor do **plano**. Se nada resolver, o
  agendamento não é criado (veja "Solução de problemas").
- **Sinal (depósito)**: válido apenas na cobrança única; precisa ser maior que zero e menor que o
  valor total. Só o sinal é cobrado para confirmar — o saldo fica para receber depois.
- **Formas de pagamento**: subconjunto de PIX, boleto e cartão. Sem seleção, usa os padrões da conta
  ou da conexão; por fim, PIX.
- **Conexão e plano**: a conexão de gateway que processa a cobrança; o plano define o ciclo da
  assinatura.
- **Tempo de reserva**: por quantos minutos o horário fica segurado aguardando pagamento (padrão 15).

### Reserva e expiração

O **modo de reserva** decide o que acontece com o horário enquanto o pagamento não chega:

- **Reservar e segurar** (`reserve_and_hold`): o horário é **segurado** assim que o cliente inicia o
  pagamento e fica indisponível para outras pessoas até um prazo (`hold_expires_at`). Uma **varredura
  automática** roda a cada minuto: se o prazo passar sem pagamento, ela **cancela** a cobrança não
  paga no gateway, **libera o horário** e marca o agendamento como **expirado**.
- **Pagar primeiro** (`pay_first`): o horário **não** é segurado durante o pagamento. Quando o
  pagamento é aprovado, o horário é **revalidado**: se ainda estiver livre, o agendamento confirma; se
  alguém pegou o horário nesse meio-tempo, o agendamento entra em **falha de pagamento** e a cobrança
  (já paga) precisa ser reembolsada manualmente em **Pagamentos**.

### Ciclo do agendamento

| Estado | Quando acontece | O que o cliente e o agente veem |
|---|---|---|
| **Aguardando pagamento** | Cobrança criada; horário em reserva (no modo "reservar e segurar"). | Cliente recebe o link/PIX; o agente vê o agendamento pendente, ainda não confirmado. |
| **Confirmado** | Pagamento aprovado. | Dispara os efeitos do agendamento (conversa, tarefa, negócio, e-mail) e gera o link do **Google Meet**. |
| **Falha de pagamento** | No "pagar primeiro", o horário foi ocupado antes da aprovação. | O horário não é mantido; é preciso reembolsar e remarcar. |
| **Expirado** | O prazo de reserva passou sem pagamento. | A cobrança não paga é cancelada e o horário volta a ficar livre. |

## Casos de uso

### Onde funciona

O pagamento para confirmar vale em todos os pontos onde um agendamento é criado:

- **Página pública** de agendamento (booking).
- **Agente** marcando direto na conversa.
- **Automação** e **macro**.
- **FlowBuilder** (incluindo Flows nativos do WhatsApp).
- **Maestro** (assistente de IA).

Exemplos:

- Consultas e mentorias que só são confirmadas após o pagamento.
- Cobrar um **sinal** para reduzir faltas, recebendo o restante no atendimento.
- Sessões recorrentes vendidas como **assinatura**.
- Atendimentos exclusivos para **assinantes** (quem é membro agenda sem pagar de novo).

## Dicas, limites e boas práticas

- Use **PIX** para confirmar mais rápido; boleto pode levar dias e estourar o tempo de reserva.
- Ajuste o **tempo de reserva** ao seu cenário: curto demais expira pagamentos lentos; longo demais
  segura horários ociosos.
- Prefira **reservar e segurar** quando o horário é disputado; **pagar primeiro** quando você não quer
  bloquear a agenda antes de receber.

### Cancelamento e reembolso

- **Cancelar** um agendamento pago **libera o horário** e remove o evento do **Google**, mas **não
  reembolsa automaticamente**. O reembolso é uma ação **manual** no módulo **Pagamentos**.
- Reembolsar ou cancelar a cobrança de um agendamento **já confirmado** **não** cancela o compromisso
  sozinho — quem decide é o agente. Apenas um agendamento ainda **aguardando pagamento** é liberado
  automaticamente quando a cobrança falha, é cancelada ou reembolsada.

## Solução de problemas

- **O pagamento não confirmou o horário**: confirme que a **conexão de gateway** está ativa e
  recebendo notificações (webhook). O horário só confirma quando o gateway avisa que a cobrança foi
  **paga** — a página de sucesso do pagamento, sozinha, não confirma.
- **O horário expirou antes de pagar**: o **tempo de reserva** acabou. A cobrança não paga é cancelada
  e o horário volta a ficar livre — basta agendar de novo. Aumente o tempo de reserva se isso for
  frequente.
- **O valor não foi resolvido (erro 422)**: o tipo de evento não tem um preço calculável — sem valor
  definido, sem produto do Catálogo com preço e sem plano. Defina um **valor** (ou vincule um produto
  ou plano) para o agendamento ser criado.
- **No "pagar primeiro", o cliente pagou mas perdeu o horário**: outra pessoa marcou o mesmo horário
  antes da aprovação. Reembolse a cobrança em **Pagamentos** e ofereça um novo horário, ou use
  **reservar e segurar** para evitar a disputa.

## Veja também

- [Página pública de agendamento (booking)](/hc/ajuda/articles/calendar-scheduling-pagina-publica-de-agendamento-pt-br)
- [Tipos de evento, disponibilidade e buffers](/hc/ajuda/articles/calendar-scheduling-tipos-de-evento-disponibilidade-buffers-pt-br)
- [Conectar um gateway de pagamento](/hc/ajuda/articles/payments-conectar-gateway-pt-br)
- [Assinaturas e planos](/hc/ajuda/articles/payments-assinaturas-planos-pt-br)
- [Reembolsos, webhooks e relatórios](/hc/ajuda/articles/payments-reembolsos-webhooks-relatorios-pt-br)