Appearance
Redsys — Configurar pasarela
Redsys es la pasarela de pagos más utilizada en España, operada por los principales bancos (BBVA, Santander, CaixaBank, etc.). Si tu empresa tiene TPV virtual con un banco español, probablemente ya tenés una cuenta de Redsys.
Requisitos previos
- TPV virtual contratado con tu banco (Servired, Sermepa o equivalente Redsys)
- Las credenciales del TPV virtual que te proporcionó el banco:
- Número de comercio (FUC): identificador de 9 dígitos
- Terminal: número de terminal (generalmente "1")
- Clave secreta: la clave HMAC-SHA256 del TPV
Configurar Redsys en SolNow
- Ir a Configuración → Pagos → Pasarela de pago
- Seleccionar Redsys como proveedor
- Completar los datos:
| Campo | Descripción |
|---|---|
| Número de comercio (FUC) | Los 9 dígitos que te dio el banco |
| Terminal | Número de terminal (normalmente "001") |
| Clave secreta | Clave HMAC del administrador de Redsys |
| Entorno | Pruebas (sandbox) o Producción |
| Moneda | EUR (defecto para España) |
- Hacer clic en Verificar conexión
- Realizar un pago de prueba de 0,01€ para confirmar que funciona
- Cambiar a entorno Producción
Entorno de pruebas
Redsys proporciona un entorno de pruebas (sandbox) con tarjetas de test:
| Tarjeta | Número | CVV | Caducidad |
|---|---|---|---|
| Visa (aprobada) | 4548 8120 4940 0004 | 123 | 12/34 |
| Mastercard (aprobada) | 5137 0042 1950 0008 | 123 | 12/34 |
| Pago rechazado | 4548 8121 1234 5679 | 123 | 12/34 |
Usá estas tarjetas para probar el flujo completo antes de activar producción.
Configurar la URL de retorno
En el panel de administración de Redsys (o en el portal de tu banco), debés configurar la URL de notificación de SolNow:
https://api.solnow.io/webhooks/redsys/[tu-empresa]Esta URL es donde Redsys envía la confirmación del pago. Si no está configurada, los pagos no se registrarán automáticamente en SolNow.
SolNow te muestra esta URL exacta en Configuración → Pagos → URL de notificación Redsys.
Pagos en 3 pasos (3DS2)
Redsys implementa el protocolo 3DS2 (autenticación reforzada del cliente) requerido por la PSD2 europea. Con 3DS2:
- El cliente introduce los datos de tarjeta
- El banco puede solicitar verificación adicional (SMS, app del banco)
- El pago se confirma o rechaza
SolNow gestiona este flujo automáticamente. No requiere configuración adicional.
Pagos recurrentes y tokens
Si querés guardar la tarjeta del cliente para cobros futuros (ej. el saldo pendiente de una reserva), Redsys admite tokenización de tarjetas. El cliente autoriza el guardado al pagar y SolNow almacena el token (no los datos de tarjeta) para cobros posteriores.
Para activar la tokenización: Configuración → Pagos → Guardar tarjeta del cliente → Activar.
Liquidaciones y contracargos
Los cobros se liquidan en tu cuenta bancaria según el acuerdo con tu banco (generalmente cada 1-3 días hábiles). SolNow no interviene en este proceso.
Para contracargos (chargebacks), el proceso se gestiona directamente con tu banco. SolNow proporciona el historial de transacciones en Pagos → Historial de pagos como documentación.
Problemas comunes
| Problema | Causa probable | Solución |
|---|---|---|
| Error SIS0051 | FUC o terminal incorrectos | Verificar credenciales con el banco |
| Error SIS0093 | Clave secreta incorrecta | Copiar la clave exactamente del panel Redsys |
| Pago no se registra en SolNow | URL de notificación no configurada | Configurar la URL en el panel Redsys |
| Error 3DS | El banco rechaza la autenticación | El cliente debe usar otro método de pago |