Conecta tu TPV de Redsys paso a paso
Los tres datos que te da tu banco, dónde se introducen, cómo probar en el entorno de pruebas y cómo comprobar que todo funciona antes de vender de verdad.
Última actualización: 2 de septiembre de 2026
Esta es la guía que más se consulta. Al terminarla estarás cobrando contra tu propio comercio bancario, con el dinero entrando directamente en tu cuenta.
Antes de empezar
Necesitas un TPV virtual contratado con tu banco. No es lo mismo que el datáfono físico de la barra: es el producto para cobrar por internet. Si no lo tienes, pídelo a tu gestor bancario; suele tardar unos días.
Mientras lo tramitan, puedes montar la sala entera y ensayar la venta con el TPV de pruebas.
Conectar una pasarela real —Redsys o Stripe— necesita el plan Pro. El plan Free trae el TPV de pruebas, con el que recorres la compra entera sin mover un euro, pero no cobra.
Los tres datos
Tu banco te facilita estos tres, normalmente en un correo o en un documento de alta:
| Dato | Qué es | Formato |
|---|---|---|
| Código de comercio (FUC) | Identifica tu comercio ante Redsys | 9 dígitos |
| Número de terminal | Identifica el terminal concreto | 3 dígitos, a menudo 001 |
| Clave secreta de firma | Con la que se firman las operaciones | Cadena larga en base 64 |
Trátala como una contraseña. No la mandes por WhatsApp ni la dejes en un documento compartido. En Tickeep se guarda cifrada y solo se descifra para firmar tus propias operaciones.
Conectarlo
Ve a integraciones en tu organización
Verás las pasarelas disponibles: Redsys, Stripe y el TPV de pruebas.
Activa Redsys
Al activarlo se desactivará la pasarela que tuvieras antes, conservando su configuración. Solo una puede estar activa a la vez.
Introduce los tres datos
Código de comercio, terminal y clave secreta, tal cual te los dio el banco. Cuidado con los espacios al copiar y pegar.
Elige el entorno
Pruebas para verificar contra el entorno de test de Redsys. Real para cobrar de verdad. Empieza por pruebas si tu banco te ha dado credenciales de test.
Guarda
Tarjetas de prueba
Si has elegido el entorno de pruebas, no uses una tarjeta real: no funcionará. Redsys publica unas tarjetas de test que solo existen en ese entorno y que no mueven dinero. Estas son las principales:
| Marca | Número | Caducidad | CVV |
|---|---|---|---|
| Visa (EMV 3DS 2.2) | 4548 8100 0000 0003 | 12/49 | 123 |
| Mastercard (EMV 3DS 2.1) | 5576 4415 6304 5037 | 12/49 | 123 |
| American Express | 3766 740000 00008 | 12/49 | 123 |
| Diners Club | 3684 98000 00018 | 12/49 | 123 |
| JCB | 3587 8700 0000 0001 | 12/49 | 123 |
Si al pagar aparece la pantalla de autenticación del banco pidiendo un código, en el entorno de pruebas el código es 123456.
Simular un pago denegado
Merece la pena probarlo: es la mitad de los casos raros que verás en producción, y muchos bancos exigen una operación aprobada y otra denegada en test antes de pasarte a real. Con cualquiera de las tarjetas de arriba, hay dos formas:
- Poner 999 como CVV.
- Comprar un importe que acabe en
,96(por ejemplo, 10,96 €).
Deberías acabar en tu web con el pago rechazado y sin entrada emitida ni correo enviado.
Estas tarjetas y estos trucos únicamente funcionan con el entorno puesto en pruebas y con credenciales de test. En cuanto pases el TPV a real, hay que probar con una tarjeta de verdad y un importe bajo, y luego devolverlo.
Para ensayar la compra de punta a punta sin banco de por medio, usa el TPV de pruebas de Tickeep: no pide credenciales y no necesita tarjeta.
Comprobar que funciona
Cuando ya estés en el entorno real:
Haz una compra real de importe bajo
Crea un evento de prueba con una entrada de 1 € y cómprala tú mismo con una tarjeta real.
Comprueba que llega la entrada
El correo con el PDF debe llegar en segundos.
Comprueba el pedido en el panel
Debe aparecer como pagado, con el importe correcto.
Devuélvela desde el panel
Así verificas que la devolución también funciona antes de necesitarla de verdad. Ver devoluciones.
Borra el evento de prueba
Cómo verifica Tickeep cada pago
Merece la pena saberlo porque explica por qué el sistema es fiable:
- Notificación servidor a servidor. Redsys avisa directamente a Tickeep cuando el pago se completa. Es la vía principal y no depende del navegador del comprador.
- Retorno del navegador. Cuando el comprador vuelve a tu web, esa respuesta también se verifica por firma.
- Validación del importe. Se comprueba que lo confirmado coincide con el pedido antes de emitir nada.
La entrada se emite igual. Basta con que llegue una de las dos vías.
Problemas habituales
«Error de firma» o SIS0042. La clave secreta no es correcta. Vuelve a copiarla del documento del banco con cuidado: es el fallo número uno, casi siempre por un espacio de más al final.
«Comercio no dado de alta» o SIS0018. El código de comercio está mal, o estás usando credenciales del entorno real en el de pruebas (o al revés).
«El pago se hace pero el pedido sigue pendiente». La notificación no está llegando. Comprueba con tu banco que la URL de notificación está permitida y que tu comercio admite notificaciones server-to-server.
«El importe no coincide». Revisa si tus precios están configurados con IVA incluido o no incluido. Ver gastos de gestión e IVA.
Y ahora
El siguiente paso es activar la facturación, para que cada venta emita su factura sin trabajo manual. No es opcional si vas a vender: publicar la web exige tener la pasarela y la facturación funcionando de verdad. Ver publicar tu web.
Artículos relacionados
Tres formas de verificar que el cobro funciona: el TPV de pruebas de Tickeep, el entorno de test de tu pasarela y una compra real de importe bajo.
Cómo devolver un pedido desde el panel, qué pasa con las entradas y la factura, y qué hacer cuando ya devolviste el dinero por otra vía.
De cero a tu primera factura: datos fiscales, alta del NIF, autorización ante Hacienda, serie de numeración, prueba en entorno de test y paso a producción.