Convoca Gateway v2.6.2¶
Procesa pagos a través de Redsys (Sermepa), el TPV virtual más usado en España. Permite crear pagos manuales, generar links de pago únicos, y recibir notificaciones automáticas cuando un pago se completa.
Requiere: Convoca Core activo.
Configuración de Redsys¶
- Ve a Convoca → Gateway → Ajustes
- Rellena los datos de tu comercio Redsys:
| Campo | Descripción |
|---|---|
| Comercio (FUC) | Número de comercio asignado por el banco |
| Terminal | Número de terminal (normalmente 001) |
| Clave secreta | Clave SHA-256 proporcionada por Redsys |
| Titular | Nombre del titular del comercio |
| Moneda | EUR (978) |
| Entorno | Real o Pruebas (sandbox) |
- Usa el botón Probar conexión para verificar
- Configura la URL de notificación en el panel de Redsys:
Crear un pago manual¶
- Ve a Pagos → Añadir nuevo
- Rellena:
| Campo | Descripción |
|---|---|
| Concepto | Descripción del pago (ej: "Cuota anual 2026") |
| Importe | En euros (ej: 30.00) |
| Socio | Vincular a un socio (opcional) |
| Email del pagador para notificaciones |
- El sistema genera un link de pago único para copiar y enviar al pagador
- El link usa un hash persistente (no caduca aunque cambie AUTH_SALT)
Shortcode¶
Atributos opcionales:
Panel de pagos¶
En Convoca → Gateway → Pagos:
- Listado con estado (Pendiente, Completado, Fallido)
- Filtro por fecha, estado y socio
- Exportar CSV
Notificaciones automáticas¶
Cuando Redsys confirma un pago:
- El sistema valida la firma HMAC SHA-256
- Actualiza el estado a Completado
- Si está vinculado a un socio, actualiza su membresía
- Envía email de confirmación al pagador
- Dispara el webhook
payment.completed
Urls de notificación
Asegúrate de que la URL de notificación está accesible desde internet. Redsys no notifica a IPs privadas ni localhost.
Diagnóstico¶
El panel Convoca → Salud del Sistema incluye chequeos específicos:
- ✅ Conectividad con Redsys
- ✅ Certificados SSL válidos
- ✅ Configuración del comercio
- ✅ URL de notificación accesible
Links de pago directos¶
Además de crear pagos desde el panel, puedes generar links directos vía URL:
Parámetros: concepto, importe, socio_id, email.
Solución de problemas¶
| Problema | Solución |
|---|---|
| Error "Firma no válida" | Verifica la clave secreta. Redsys distingue mayúsculas |
| Pago completado pero no se refleja | Revisa Convoca → Registros para ver la notificación |
| Link de pago no funciona | Cada link es de un solo uso. Verifica que el pago no esté ya completado |
| Entorno de pruebas | Usa el modo "Pruebas" y la tarjeta 4548812049400004 |