| name | ubemedicos-appointments-payments |
| description | Documentación del flujo entre el módulo de citas y el módulo de pagos. Úsalo cuando el usuario necesite implementar el checkout, validar confirmaciones de pago o entender la sincronización de estados entre una reserva y su transacción. |
Ubemedicos Appointments & Payments
Ciclo de Vida de la Cita (Appointment)
Ubicación: backend/apps/appointments/models.py.
Estados (status):
pending_confirmation: Cita creada pero esperando validación o pago.confirmed: Cita válida y agendada (bloquea el slot).cancelled_by_patient / cancelled_by_professional: Cita anulada.completed: La consulta ya se realizó.no_show_patient / no_show_professional: Inasistencia.
Módulo de Pagos (Payment)
Ubicación: backend/apps/payments/models.py.
Estados (status):
pending: Pago iniciado/esperando respuesta de pasarela.succeeded: Cobro exitoso.failed: Error en el cobro.refunded: Dinero devuelto al paciente.
Relación y Lógica de Negocio
- Vínculo: Existe una relación
OneToOne entre Payment y Appointment.
- Sincronización:
- Al recibir una notificación de pago exitoso (
succeeded), el campo is_paid de la cita debe marcarse como True.
- Dependiendo de la configuración del médico, un pago exitoso puede mover la cita automáticamente de
pending_confirmation a confirmed.
- Pagos Demo: Actualmente el sistema utiliza un flujo de demostración donde la validación puede ser manual o simulada a través de
apps.payments.api_views.
Reglas de Slot
- Solo las citas en estado
pending_confirmation o confirmed activan la restricción UniqueConstraint para evitar duplicidad de pacientes en el mismo horario para un profesional.
