Cómo conseguir las credenciales del TPV virtual (Redsys) en España

1) Lo importante: Redsys no te da las credenciales, te las da tu banco

En España, la mayoría de TPVs virtuales funcionan sobre Redsys, pero el contrato lo haces con tu banco/adquirente. Cuando el banco te aprueba el TPV, te entrega accesos y datos técnicos (a veces por email, otras en la banca online o mediante un gestor).

2) Qué vas a necesitar (la lista de credenciales)

Para integrar tu TPV virtual, el banco debe proporcionarte (como mínimo) estos datos:

• FUC / Código de comercio (también se llama Merchant Code).
• Número de terminal (Terminal ID).
• Clave secreta (SHA-256) para firmar operaciones. Importante: suele venir en base64 o como “clave” para el módulo de firma.
• Entorno: pruebas (test/sandbox) y/o producción.
• URL(s) de pago o indicación de que es Redsys estándar (normalmente no hace falta si usas librería/config estándar, pero algunos bancos las adjuntan).

Si vas a usar pagos recurrentes o tokenización, pide explícitamente que te activen los permisos necesarios (ver el punto 6).

3) Requisitos típicos que te pedirá el banco

Esto varía por entidad, pero es muy habitual que te pidan:

• Actividad y web operativa (dominio, política de privacidad/cookies, aviso legal, condiciones).
• Cuenta de abono donde liquidar cobros.
• Documentación del titular (autónomo/SL) y, a veces, facturación estimada.
• Descripción del producto/servicio y si hay suscripciones.

4) Cómo solicitar el TPV virtual (paso a paso)

1. Contacta con tu oficina/gestor o solicita “TPV virtual” desde la banca online (si existe esa opción).
2. Indica que quieres Redsys (si te dan a elegir) y si necesitas:
   • Pago con tarjeta estándar.
   • Pagos recurrentes (suscripciones).
   • Tokenización (guardar tarjeta como token para cobro futuro).
3. Pide entornos: primero pruebas (test) y después producción.
4. Solicita las credenciales completas (FUC, terminal y clave secreta SHA-256).
5. Configura y prueba una compra/alta de suscripción en test antes de pasar a producción.

5) Pruebas vs Producción: por qué suele “no funcionar” al principio

El fallo más común es mezclar datos de test con endpoints de producción (o al revés). Cada entorno tiene sus credenciales.

• Test: para validar integración y configuración sin cobros reales.
• Producción: cobros reales, requiere contrato activo y, a veces, validación de la web.

Si algo falla, revisa primero: FUC, terminal, clave y entorno (los 4 deben pertenecer al mismo entorno).

6) Si necesitas suscripciones: qué pedir exactamente

Para cobros recurrentes, te interesa que tu banco te habilite:

• Operativa de pago recurrente (suscripciones) o “MIT/CIT recurrente” según el proveedor.
• Tokenización / referencia de tarjeta (para no manejar PAN en tu sistema).
• 3DS/SCA cuando aplique (especialmente en el alta inicial o primera compra).

7) Checklist rápido antes de configurar

8) Siguiente paso: configurar tus credenciales en la plataforma

Cuando tengas las credenciales, podrás introducirlas en tu configuración y hacer una prueba de cobro. Si aún no has leído la guía completa de configuración, aquí la tienes:

Configurar TPV virtual para suscripciones Volver al blog