## Visión general

La **cita con pago** conecta el módulo **Agenda** con el módulo **Pagos**: cuando un tipo de evento
exige pago, el horario elegido **no queda confirmado de inmediato**. Pasa a un estado de **esperando
pago** y solo queda **confirmado** después de que Conversa Labs recibe la aprobación del pago por parte
de la pasarela. Así solo bloqueas tu agenda para quien realmente pagó.

Cada tipo de evento define **cómo** funciona el pago: un **cobro único** para confirmar, una **señal**
(depósito) menor que el valor total, o una **suscripción** — exigir que el cliente ya sea suscriptor,
o crear la suscripción en el momento de la reserva.

## Requisitos previos

- Módulo **Agenda** activo, con al menos un **tipo de evento** y **disponibilidad** configurados.
- Módulo **Pagos** activo, con una **conexión de pasarela** (Asaas o Mercado Pago).
- Para suscripción, un **plan** de pago creado.
- Un perfil con permiso para editar tipos de evento y cobros.

## Paso a paso

1. En **Agenda**, abre el **tipo de evento** que deseas cobrar.
2. Elige el **modo de pago** (ver la tabla abajo): ninguno, cobro único, exigir suscripción o
   suscribirse al reservar.
3. Define el **valor** y la **moneda**. Si el tipo está vinculado a un **producto del Catálogo** o a
   un **plan**, el precio puede venir de allí.
4. (Cobro único, opcional) define una **señal** (depósito) **menor** que el valor total — solo se
   cobra la señal para confirmar; el resto lo recibes manualmente o en el lugar.
5. Elige las **formas de pago** aceptadas: **PIX**, **boleto** o **tarjeta** (enlace alojado).
6. Selecciona la **conexión de pasarela** y, para suscripción, el **plan**.
7. Define el **modo de reserva** del horario y el **tiempo de reserva** (ver "Reserva y expiración").
8. Guarda. Desde entonces, cualquier cita de ese tipo exige pago.

### Modos de pago

| Modo | Qué hace |
|---|---|
| **Ninguno** (`none`) | Sin pago — el horario se confirma de inmediato. |
| **Cobro único** (`one_off`) | Genera un cobro único; el horario se confirma cuando se paga. |
| **Exigir suscripción** (`subscription_gate`) | Quien ya tiene **suscripción activa** en el plan reserva **gratis**; el resto es dirigido a pagar o suscribirse. |
| **Suscribirse al reservar** (`recurring`) | Crea una suscripción en la pasarela al reservar; el primer cobro confirma el horario. |

## Configuración y opciones

- **Valor y moneda**: el precio cobrado para confirmar. El orden de resolución es: valor definido en
  el tipo de evento → precio del **producto del Catálogo** vinculado → valor del **plan**. Si nada se
  resuelve, la cita no se crea (ver "Solución de problemas").
- **Señal (depósito)**: válida solo en el cobro único; debe ser mayor que cero y menor que el valor
  total. Solo se cobra la señal para confirmar — el saldo se recibe después.
- **Formas de pago**: un subconjunto de PIX, boleto y tarjeta. Sin selección, usa los valores por
  defecto de la cuenta o de la conexión; por último, PIX.
- **Conexión y plan**: la conexión de pasarela que procesa el cobro; el plan define el ciclo de la
  suscripción.
- **Tiempo de reserva**: cuántos minutos se mantiene el horario mientras espera el pago (por defecto
  15).

### Reserva y expiración

El **modo de reserva** decide qué pasa con el horario mientras el pago no llega:

- **Reservar y mantener** (`reserve_and_hold`): el horario se **mantiene** en cuanto el cliente inicia
  el pago y queda no disponible para otros hasta un plazo (`hold_expires_at`). Un **barrido
  automático** se ejecuta cada minuto: si el plazo vence sin pago, **cancela** el cobro impago en la
  pasarela, **libera el horario** y marca la cita como **expirada**.
- **Pagar primero** (`pay_first`): el horario **no** se mantiene durante el pago. Cuando el pago es
  aprobado, el horario se **revalida**: si sigue libre, la cita se confirma; si alguien tomó el
  horario mientras tanto, la cita pasa a **fallo de pago** y el cobro (ya pagado) debe **reembolsarse
  manualmente** en **Pagos**.

### Ciclo de la cita

| Estado | Cuándo ocurre | Qué ven el cliente y el agente |
|---|---|---|
| **Esperando pago** | Cobro creado; horario reservado (en "reservar y mantener"). | El cliente recibe el enlace/PIX; el agente ve la cita pendiente, aún no confirmada. |
| **Confirmada** | Pago aprobado. | Dispara los efectos de la cita (conversación, tarea, negocio, correo) y genera el enlace de **Google Meet**. |
| **Fallo de pago** | En "pagar primero", el horario fue tomado antes de la aprobación. | El horario no se mantiene; hay que reembolsar y reagendar. |
| **Expirada** | El plazo de reserva venció sin pago. | El cobro impago se cancela y el horario vuelve a estar libre. |

## Casos de uso

### Dónde funciona

El pago para confirmar vale en todos los puntos donde se crea una cita:

- La **página pública** de reservas (booking).
- Un **agente** reservando directo en la conversación.
- **Automatización** y **macros**.
- **FlowBuilder** (incluidos los Flows nativos de WhatsApp).
- **Maestro** (el asistente de IA).

Ejemplos:

- Consultas y mentorías que solo se confirman tras el pago.
- Cobrar una **señal** para reducir ausencias, recibiendo el resto en la atención.
- Sesiones recurrentes vendidas como **suscripción**.
- Atenciones exclusivas para **suscriptores** (los miembros reservan sin volver a pagar).

## Consejos, límites y buenas prácticas

- Usa **PIX** para confirmar más rápido; el boleto puede tardar días y superar el tiempo de reserva.
- Ajusta el **tiempo de reserva** a tu escenario: demasiado corto expira pagos lentos; demasiado largo
  mantiene horarios ociosos.
- Prefiere **reservar y mantener** cuando el horario es disputado; **pagar primero** cuando no quieres
  bloquear la agenda antes de cobrar.

### Cancelación y reembolso

- **Cancelar** una cita pagada **libera el horario** y elimina el evento de **Google**, pero **no
  reembolsa automáticamente**. El reembolso es una acción **manual** en el módulo **Pagos**.
- Reembolsar o cancelar el cobro de una cita **ya confirmada** **no** cancela la cita por sí solo —
  decide el agente. Solo una cita aún **esperando pago** se libera automáticamente cuando su cobro
  falla, se cancela o se reembolsa.

## Solución de problemas

- **El pago no confirmó el horario**: confirma que la **conexión de pasarela** está activa y recibiendo
  notificaciones (webhook). El horario solo se confirma cuando la pasarela informa que el cobro fue
  **pagado** — la página de éxito del pago, por sí sola, no lo confirma.
- **El horario expiró antes de pagar**: el **tiempo de reserva** se acabó. El cobro impago se cancela y
  el horario vuelve a estar libre — basta con reservar de nuevo. Aumenta el tiempo de reserva si esto
  es frecuente.
- **El valor no se resolvió (error 422)**: el tipo de evento no tiene un precio calculable — sin valor
  definido, sin producto del Catálogo con precio y sin plan. Define un **valor** (o vincula un producto
  o plan) para que la cita se cree.
- **En "pagar primero", el cliente pagó pero perdió el horario**: otra persona reservó el mismo horario
  antes de la aprobación. Reembolsa el cobro en **Pagos** y ofrece un nuevo horario, o usa **reservar y
  mantener** para evitar la disputa.

## Ver también

- [Página pública de reservas (booking)](/hc/ajuda/articles/calendar-scheduling-pagina-publica-de-agendamento-es)
- [Tipos de evento, disponibilidad y buffers](/hc/ajuda/articles/calendar-scheduling-tipos-de-evento-disponibilidade-buffers-es)
- [Conectar una pasarela de pago](/hc/ajuda/articles/payments-conectar-gateway-es)
- [Suscripciones y planes](/hc/ajuda/articles/payments-assinaturas-planos-es)
- [Reembolsos, webhooks e informes](/hc/ajuda/articles/payments-reembolsos-webhooks-relatorios-es)