💳 Redsys
Redsys es la pasarela de pago de la mayoría de bancos españoles (BBVA, Santander, Sabadell, CaixaBank, Bankinter…). Integrarla con TPVReady te permite cobrar online tus pedidos y facturas desde el portal del cliente, desde los emails que envías, o desde un enlace público que compartes por WhatsApp.
El dinero llega directamente a tu cuenta del banco, sin pasar por TPVReady ni por ningún intermediario. Nosotros solo ponemos el flujo técnico de la pasarela.
🚪 Cómo se accede
Menú lateral → Configuración → Mi empresa → pestaña Pasarela Redsys (solo admin).
🏦 Requisitos previos
Antes de configurar nada, necesitas tener contratado el TPV Virtual Redsys con tu banco. Es un producto bancario:
- Contactas con tu banco y pides "TPV Virtual Redsys".
- Te dan acceso al panel de administración en
sis.redsys.es(preproducción) ysis-r.redsys.es(producción). - Te facilitan tres datos críticos: código de comercio, terminal y clave secreta.
No siempre es trivial: muchos directores de oficina ni saben qué es. Insiste si hace falta. El alta suele tardar 2-5 días laborables y suele tener un coste mensual bajo + una comisión por transacción.
⚙️ Configurar Redsys en TPVReady
Campos a rellenar
| Campo | De dónde sale | Notas |
|---|---|---|
| Código de comercio (FUC) | Tu banco te lo da | 9 dígitos. |
| Terminal | Tu banco te lo da | Normalmente "001" para el primero. |
| Clave secreta | Tu banco te la da | Cadena Base64. Se cifra en BD con AES. |
| Modo | Tú decides | Pruebas (sis-t) o Producción (sis). |
| Algoritmo de firma | Tú decides | HMAC-SHA256 (default) o SHA512 (más nuevo). Consulta a Redsys cuál acepta tu cuenta. |
| Moneda | Por defecto EUR (978) | Casi siempre no se toca. |
| Activo | Toggle | Mientras esté desactivado, no se ofrece pago online aunque esté configurado. |
Probar antes de activar
Botón Probar conexión abajo de la pestaña. Hace una validación local:
- Comprueba que los tres datos están bien formados.
- Genera una firma de prueba y la valida contra tu propia clave.
- Si pasa → ✓ todo correcto.
- Si falla → te dice exactamente qué campo está mal.
La validación es local. Para una prueba real, tendrás que hacer un pago de 1 € desde el portal cliente o desde un enlace público.
URL de notificación que debes configurar en Redsys
Cuando un cliente paga, Redsys necesita avisar a TPVReady de si fue OK o KO. Esto se hace mediante una notificación server-to-server a una URL fija.
Esa URL la encontrarás abajo de la pestaña, en un recuadro azul. Algo así:
https://api.tpvready.es/api/publico/redsys/notificacion
Esta URL debes pegarla en el panel de tu Redsys, en la sección URLs → URL de notificación. Sin esto configurado, los pagos llegan al banco pero TPVReady no se entera y la factura no se marca como cobrada.
💡 Cómo funciona un pago
- Tú envías el documento al cliente con el botón "Enlace de pago" o por email con la plantilla habilitada para pago online.
- El cliente recibe un enlace del tipo
https://app.tpvready.es/pago/{token}(token de 36 caracteres, irreproducible). - El cliente abre el enlace, ve los datos del pedido o factura, acepta los términos legales y pulsa "Pagar con tarjeta".
- Redirección a Redsys: el cliente ve la pantalla del banco con el formulario de tarjeta (TPVReady no ve ni guarda nunca los datos de tarjeta).
- El cliente paga. El banco responde:
- OK → vuelve a TPVReady con confirmación.
- KO → vuelve a TPVReady con error y opción de reintentar.
- TPVReady recibe la notificación server-to-server de Redsys y marca el documento como cobrado.
- Si está activo, se envía email automático al cliente y a tu equipo confirmando el pago.
Usamos la modalidad redirección de Redsys (no REST/InSite). Eso significa que los datos de tarjeta los teclea el cliente dentro del entorno seguro de Redsys, nunca en TPVReady. Tu negocio no necesita certificación PCI-DSS.
🔐 Seguridad
- La clave secreta se cifra en la BD con AES usando una clave maestra de entorno. Nunca se devuelve en claro por la API, ni siquiera al admin que la configuró: si vuelves a la pantalla verás
****en el campo. - Todas las firmas usan HMAC con SHA-256 (o SHA-512 si lo activas).
- Las notificaciones de Redsys se verifican criptográficamente antes de marcar nada como cobrado. Un atacante no puede falsificar un "pago OK".
- El token del enlace de pago es un UUID de 36 caracteres: en la práctica, irreproducible por fuerza bruta.
📑 Aceptación de términos
Antes de pagar, el cliente debe aceptar tus términos del servicio y, si aplica, el aviso de VeriFactu. Los textos los defines en Mi empresa → Pagos y legales.
Cada aceptación queda registrada en BD con timestamp, IP y user-agent del cliente.
💸 Habilitar pago online en facturas y pedidos
Para que un documento ofrezca pago online:
- Redsys configurado y activo (esta pantalla).
- La empresa debe tener
permite_pago_online = síen su configuración. - El documento (pedido o factura) debe tener saldo pendiente > 0.
Cuando se cumplen las tres, aparece:
- El botón "Enlace de pago" en la cabecera del documento.
- La variable
{{url_pago}}lista para usarse en las plantillas de email (ver Plantillas de email). - La opción "Pagar online" en el portal del cliente.
💡 Buenas prácticas
- Empieza en modo pruebas. Configura con las claves de
sis-tque tu banco te dará para test. Haz un pago de prueba completo de un extremo a otro. Solo cuando todo funciona, pasa a producción. - Configura la URL de notificación en cuanto cambies a producción. Sin ella, los pagos "llegan al banco" pero TPVReady no actualiza el cobro. Es la causa más común de tickets de soporte sobre Redsys.
- Incluye el botón de pago en las plantillas de email. Es la diferencia entre cobrar al día siguiente y cobrar a las 4 semanas.
- Activa los avisos por email al equipo cuando se cobre. Tu administrativa lo agradece (sabe inmediatamente qué factura saldar en tesorería).
❓ Preguntas frecuentes
Mi cliente dice que pagó pero la factura sigue pendiente.
Casi siempre falta la URL de notificación en el panel Redsys. Vete a sis.redsys.es, sección URLs, y verifica que la URL https://api.tpvready.es/api/publico/redsys/notificacion está ahí (sin espacios, exacta). Después de añadirla, los nuevos pagos se actualizan automáticamente. Para los que se quedaron colgados, márcalos manualmente como cobrados en Tesorería.
¿Puedo usar el mismo TPV Redsys en varias tiendas / empresas? No es recomendable. Cada empresa de TPVReady debería tener su propio comercio Redsys para que los cobros caigan en la cuenta correcta. Si lo compartes, el banco no distingue de dónde viene cada cobro.
¿Cuánto cobra Redsys por transacción? Depende de lo que pactes con tu banco. Suele ser entre 0,5% y 1,5% del importe + un fijo por operación. Negocia: si tu volumen es alto, baja.
¿Funciona con Bizum? Algunos terminales Redsys lo soportan. Si tu banco te lo activa en el TPV Virtual, aparecerá automáticamente como opción al pagar.
¿Y si quiero devolver el dinero a un cliente? La devolución la haces desde el panel de Redsys de tu banco, no desde TPVReady. Después, marca manualmente el cobro como devuelto en Tesorería para mantener la coherencia.
¿Tienes problemas con Redsys? Escríbenos a soporte@extremanet.com.