Pasarelas de pago

El módulo de Pasarelas de pago sirve para guardar las credenciales de Stripe, Redsys y PayPal y hacer que los recibos ofrezcan el botón «Pagar online». Hoy ese botón solo anota un intento de cobro: no conecta con la pasarela ni cobra nada. Los recibos se gestionan en Recibos.

También se conoce como: TPV virtual, pago con tarjeta, cobro online, Stripe, Redsys, PayPal.

Dónde está el módulo de Pasarelas de pago

Administración › Pasarelas de pago

Quién puede usar el módulo de Pasarelas de pago

• Administrador de la cuenta: configura las tres pasarelas.
• Empleados: cualquier empleado que entre al panel de gestión, sin que haga falta ningún módulo concreto en su perfil.
• Profesores: no lo ven, salvo que su perfil de empleado les conceda algún módulo.
• Alumnos y tutores: no lo ven. En su portal tampoco tienen el botón «Pagar online».

Pasarelas disponibles

Pasarela	Para qué
Stripe	Tarjeta de crédito o débito (Visa, Mastercard, Amex).
Redsys / TPV virtual	TPV virtual de bancos españoles (Sabadell, BBVA, CaixaBank…).
PayPal	Pago con cuenta PayPal o con tarjeta.

Las credenciales son de toda la cuenta: todas las sedes comparten la misma configuración de cada pasarela.

Configurar Stripe

Quién puede: el administrador de la cuenta y cualquier empleado del panel de gestión. Quién no: los profesores sin módulos de gestión, los alumnos y los tutores. Dónde: Administración › Pasarelas de pago → tarjeta Stripe.

1. Marca el interruptor de la tarjeta: pasa a Activo y aparecen los campos.
2. Elige el Entorno: «Pruebas (sandbox)» o «Producción (live)».
3. Rellena la Clave pública y la Clave secreta y, si lo usas, el Webhook secret, que es opcional.
4. Pulsa «Guardar Stripe».

Resultado: avisa «Stripe guardado correctamente». Nada queda guardado hasta pulsar el botón, tampoco el interruptor.

También se dice: conectar Stripe, dar de alta el pago con tarjeta.

Configurar Redsys

Quién puede: el administrador de la cuenta y cualquier empleado del panel de gestión. Quién no: los profesores sin módulos de gestión, los alumnos y los tutores. Dónde: Administración › Pasarelas de pago → tarjeta Redsys / TPV virtual.

1. Marca el interruptor de la tarjeta: pasa a Activo y aparecen los campos.
2. Elige el Entorno: «Pruebas» o «Producción».
3. Rellena el Terminal (viene con 1), el Código de comercio y la Clave secreta SHA-256.
4. Pulsa «Guardar Redsys».

Resultado: avisa «Redsys guardado correctamente». Nada queda guardado hasta pulsar el botón, tampoco el interruptor.

También se dice: configurar el TPV virtual del banco.

Configurar PayPal

Quién puede: el administrador de la cuenta y cualquier empleado del panel de gestión. Quién no: los profesores sin módulos de gestión, los alumnos y los tutores. Dónde: Administración › Pasarelas de pago → tarjeta PayPal.

1. Marca el interruptor de la tarjeta: pasa a Activo y aparecen los campos.
2. Elige el Entorno: «Sandbox» o «Producción».
3. Rellena el Client ID y el Client Secret.
4. Pulsa «Guardar PayPal».

Resultado: avisa «Paypal guardado correctamente». Nada queda guardado hasta pulsar el botón, tampoco el interruptor.

También se dice: conectar PayPal.

Desactivar una pasarela

Quién puede: el administrador de la cuenta y cualquier empleado del panel de gestión. Quién no: los profesores sin módulos de gestión, los alumnos y los tutores. Dónde: Administración › Pasarelas de pago → tarjeta de la pasarela.

1. Desmarca el interruptor de la tarjeta: pasa a Inactivo.
2. Pulsa el botón «Guardar» de esa tarjeta.

Resultado: la pasarela queda desactivada y sus credenciales se conservan para cuando la vuelvas a activar. Si ya no queda ninguna activa, los recibos dejan de ofrecer «Pagar online».

También se dice: apagar el cobro online, quitar Stripe.

Qué hace activar una pasarela

Con al menos una pasarela activada y guardada, los recibos Enviados o Vencidos ofrecen «Pagar online» en su menú (⋮) del listado de recibos.

Activar una pasarela no equivale a tenerla operativa. Activarla no valida las credenciales ni comprueba la conexión con el proveedor: solo hace aparecer el botón. El Entorno se guarda junto a las credenciales, con Pruebas como valor de partida, pero hoy ningún cobro lo usa.

Pagar online un recibo

Quién puede: el administrador de la cuenta y los empleados con el módulo «Recibos» concedido. Quién no: los profesores sin ese módulo, los alumnos y los tutores. Dónde: Administración › Recibos → menú (⋮) de la fila del recibo → «Pagar online».

1. Pulsa «Pagar online».
2. En Pasarela, elige una de las activadas.
3. Confirma.

Resultado: avisa «Intento de pago registrado» y «Pasarela: … La integración de redireccionamiento se activará próximamente.» Se anota un pago Pendiente por el saldo del recibo, con una referencia que empieza por GW, el nombre de la pasarela, la fecha y la hora. No hay redirección a la pasarela ni cargo real: el recibo no cambia de estado y el cobro se concilia a mano, con «Registrar pago» en la ficha del recibo.

Si falla:

• «Recibo ya cobrado»: el recibo no tiene saldo pendiente, así que no se anota nada.
• «Sin método de pago disponible»: la sede del recibo no tiene ningún método de pago activo.

También se dice: cobrar con tarjeta, pago online del recibo.

Seguridad de las credenciales

• Las claves secretas —la clave secreta y el webhook secret de Stripe, la clave secreta SHA-256 de Redsys y el Client Secret de PayPal— nunca se envían al navegador: al abrir la página, esos campos salen vacíos. Si guardas sin escribir una nueva, se conserva la que ya estaba.
• Las credenciales se guardan cifradas, salvo la clave pública de Stripe.

Qué no se puede hacer en el módulo de Pasarelas de pago

• Cobrar de verdad con Stripe, Redsys o PayPal: la integración que ejecuta el cobro no está operativa.
• Tener credenciales distintas por sede: la configuración es de toda la cuenta.
• Comprobar desde aquí que las credenciales funcionan: la página no prueba la conexión.
• Ofrecer el pago online a las familias: su portal no tiene el botón «Pagar online».

Problemas frecuentes con las pasarelas de pago

«He activado la pasarela y no sale “Pagar online”»

Por qué pasa. El interruptor no se guarda solo: hay que pulsar el botón «Guardar» de la tarjeta. Además, «Pagar online» solo sale en los recibos Enviados o Vencidos.

Cómo se arregla. Vuelve a Administración › Pasarelas de pago, activa la pasarela y pulsa su botón «Guardar». Después abre el menú (⋮) de un recibo enviado o vencido.

«He pulsado “Pagar online” y el recibo sigue pendiente»

Es el comportamiento esperado. «Pagar online» solo anota un intento de pago pendiente: no redirige a la pasarela ni cobra nada, así que el recibo no cambia de estado.

Qué puedes hacer. Cobra por otro medio y registra el pago en la ficha del recibo con «Registrar pago».