Pasarela de pago y pagos en línea

La pasarela de pago en Skolar depende de una configuración institucional central y de un flujo de cobro que valida cargos, genera factura y registra el método de pago antes de confirmar el resultado.

Qué controla esta configuración#

Desde la pestaña de pasarela de pago puedes definir:

• si los pagos en línea están habilitados
• qué proveedor está activo para la escuela
• la configuración técnica del proveedor

Cuando esta configuración no es válida, la vista de pagos en línea para familias queda fuera de servicio.

Antes de habilitar pagos en línea#

Verifica:

• que el proveedor a usar ya haya sido validado internamente
• que la configuración incluya las llaves o credenciales correctas
• que la moneda y los conceptos de cobro estén correctos en la escuela
• que el equipo financiero entienda cómo se enviarán recibos y facturas

Flujo recomendado de configuración#

1. Abre la configuración de institución.
2. Ve a la pestaña de pasarela de pago.
3. Activa la pasarela.
4. Selecciona el proveedor configurado para tu escuela.
5. Captura la configuración del proveedor y guarda.
6. Valida el flujo con un alumno o familia de prueba antes de comunicarlo al resto de la escuela.

Qué ocurre en un cobro en línea#

Cuando una familia paga en línea, Skolar:

• revisa que la pasarela siga disponible
• valida que los cargos enviados todavía sean válidos
• bloquea temporalmente el proceso para evitar duplicados sobre el mismo alumno
• genera la factura con sus conceptos
• envía la orden al proveedor de pago
• guarda el identificador externo y el método de pago asociado

Enlaces de pago#

El sistema también puede generar y enviar enlaces de pago firmados para un alumno específico. Esto es útil cuando tu equipo desea:

• compartir un enlace por correo a las familias
• reenviar un recordatorio de pago
• evitar que el tutor tenga que navegar manualmente hasta el alumno correcto

Skolar genera estos enlaces como rutas firmadas. Eso reduce el riesgo de compartir una URL genérica incorrecta y mantiene el acceso vinculado al alumno seleccionado.

Qué revisar antes de enviar un enlace#

• que el alumno correcto esté seleccionado
• que los adeudos y cargos activos ya estén actualizados
• que el tutor o responsable de pago tenga correo válido
• que el equipo financiero ya haya definido qué conceptos sí deben cobrarse en línea

Flujo interno del cobro en línea#

Antes de confirmar un pago, Skolar ejecuta varias validaciones:

1. toma un bloqueo temporal para evitar cobros duplicados sobre el mismo alumno
2. valida que los cargos enviados sigan vigentes
3. crea la factura con sus conceptos
4. envía la orden al proveedor
5. guarda identificador externo, método de pago y relación con el tutor

Si alguna validación falla, el proceso cancela el intento y libera el bloqueo.

Qué pasa si el cobro falla#

Cuando el intento no se completa, conviene revisar:

• si la pasarela sigue pasando health check
• si los conceptos enviados ya cambiaron desde que se abrió la pantalla
• si otro usuario intentó cobrar al mismo alumno al mismo tiempo
• si el proveedor rechazó la orden o el medio de pago

No registres manualmente una segunda factura hasta confirmar qué ocurrió con el primer intento.

Envío de enlaces por correo#

El sistema puede enviar el enlace de pago directamente a una o varias direcciones. Antes de usarlo:

• confirma que los correos correspondan a tutores o responsables de pago reales
• evita mandar enlaces si el saldo aún está en revisión
• documenta internamente quién envió el recordatorio

Relación con facturas y recibos#

El pago en línea no es un flujo aislado. Termina en una factura y dispara seguimiento posterior, como:

• registro del método de pago
• identificador externo del proveedor
• envío de recibo al correo indicado
• conciliación posterior si la escuela usa folio externo

Buenas prácticas#

• valida primero la salud de la pasarela con una prueba interna
• revisa el detalle de conceptos antes de enviar un enlace de pago
• confirma a qué correo se enviará el recibo
• documenta quién habilitó o cambió la configuración del proveedor

Errores frecuentes#

La pantalla de pagos en línea aparece como no disponible#

Esto normalmente indica que la pasarela está deshabilitada o que la configuración actual no supera la validación del proveedor.

Se rechazó el cobro aunque el alumno tiene cargos#

Revisa si los cargos enviados siguen vigentes, si hubo un conflicto de bloqueo para evitar duplicados o si el proveedor rechazó los datos de pago.

La familia recibió confirmación pero falta revisar la factura#

Confirma que la factura haya quedado guardada con el método de pago y el identificador de orden del proveedor antes de cerrar el seguimiento.

El enlace de pago abre pero no deja continuar#

Primero revisa si la pasarela sigue activa para la escuela. Después confirma que el alumno conserve cargos pendientes y que los conceptos no hayan cambiado desde que se generó el enlace.