Saltar a contenido

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

  1. Ve a Convoca → Gateway → Ajustes
  2. 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)
  1. Usa el botón Probar conexión para verificar
  2. Configura la URL de notificación en el panel de Redsys:
https://tudominio.com/wp-json/convoca-gateway/v1/notificacion

Crear un pago manual

  1. Ve a Pagos → Añadir nuevo
  2. 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 Email del pagador para notificaciones
  1. El sistema genera un link de pago único para copiar y enviar al pagador
  2. El link usa un hash persistente (no caduca aunque cambie AUTH_SALT)

Shortcode

[convoca_pago]

Atributos opcionales:

[convoca_pago concepto="Donación" importe="10" sugerido="5,10,20,50"]

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:

  1. El sistema valida la firma HMAC SHA-256
  2. Actualiza el estado a Completado
  3. Si está vinculado a un socio, actualiza su membresía
  4. Envía email de confirmación al pagador
  5. 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

Además de crear pagos desde el panel, puedes generar links directos vía URL:

https://tudominio.com/?convoca_pagar=1&concepto=Cuota&importe=30

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