Soy Enrique Camba de MarkeThink y hoy tengo un artículo de utilidad para ti tanto si eres profesional, estás empezando en esto o tienes curiosidad. Uno de los pasos fundamentales al crear una tienda online es la configuración del TPV virtual de Redsys, esencial para aceptar pagos con tarjetas de crédito o débito en tu e-commerce español. Esta configuración es aplicable a cualquier plataforma CMS de código abierto como WooCommerce (WordPress), Virtuemart (Joomla!), PrestaShop, Magento, entre otras.
Configuración del TPV en entorno de pruebas
La entidad bancaria que elijas (Santander, Sabadell, BBVA, CaixaBank, etc.), tras contratar un TPV Virtual con Redsys, te proporcionará unos datos específicos para configurar el método de pago en tu tienda online. Inicialmente, deberás configurar estos datos en modo prueba para verificar que los pagos funcionen correctamente.
Los datos proporcionados por el banco son:
- Número de comercio (FUC): Proporcionado por tu banco (campo Ds_Merchant_MerchantCode).
- Número de terminal: Proporcionado por tu banco (campo Ds_Merchant_Terminal).
- Moneda del terminal: Definida por defecto según la moneda principal de tu comercio.
- Clave secreta de encriptación: sq7HjrUOBfKmC576ILgskDsrU870gJ7 (generalmente utilizada para entorno de pruebas).
Realización de pagos con tarjeta de prueba
Una vez configurado el TPV con los datos facilitados, debes realizar al menos dos tipos de pruebas:
Operación Autorizada:
- Número de tarjeta: 4137360000000006
- Fecha de caducidad: 12/34
- Código CVV2: 123
Operación Denegada:
- Número de tarjeta: 1111111111111117
- Fecha de caducidad: 12/20
Configuración del TPV en entorno real (producción)
Cuando hayas completado las pruebas exitosamente, deberás solicitar a tu banco, mediante correo electrónico, las claves definitivas para el entorno real (producción). Recibirás datos actualizados como la clave secreta del comercio, que deberás configurar en el módulo o plugin de Redsys.
Finalmente, te recomiendo realizar una prueba adicional con un producto de prueba por valor de 1 €. Aunque este último paso no es obligatorio, confirma definitivamente que la configuración del TPV en tu tienda online está operativa al 100%. Nosotros lo hacemos para despejar dudas.
Problemas frecuentes al configurar Redsys
- Error SIS0051 – Firma incorrecta: Este es el error más frecuente al configurar Redsys. Indica que la clave secreta introducida no coincide con la proporcionada por el banco. Comprueba la clave de comercio proporcionada, asegúrate de no dejar espacios al principio o final y verifica que esté correctamente configurada tanto en entorno de pruebas como en entorno real.
- Error SIS9912 – Terminal inexistente: Esto indica que el número de terminal proporcionado no es correcto o no coincide con los datos facilitados por el banco. Comprueba el número de terminal (generalmente suele ser «001») e introdúcelo exactamente como lo indica el banco en la documentación recibida.
- Error SIS0042 – Moneda incorrecta: Informa que la moneda configurada en el módulo o plugin no coincide con la que tu banco tiene registrada para tu TPV virtual. Generalmente, la moneda para comercios españoles es el euro (EUR – código 978). Asegúrate de configurarla adecuadamente en la configuración del módulo o plugin.
- Error SIS0007 – Error en mensaje enviado: Este error se produce cuando existe algún dato incorrecto o incompleto en el formulario enviado a Redsys. Revisa que todos los campos obligatorios, especialmente FUC, Terminal y clave secreta, estén correctamente rellenados.
- Error SIS0218 – Operación denegada: Indica que la transacción ha sido rechazada por el TPV. Esto puede deberse a datos incorrectos en la tarjeta (número, caducidad o CVV incorrectos) o restricciones en la configuración del TPV. Fíjate de estar utilizando una tarjeta válida en el entorno de pruebas o consulta a tu banco para revisar posibles restricciones en el entorno real.
Cómo configurar Redsys en WooCommerce (WordPress)
En MarkeThink solemos trabajar con WordPress y WooCommerce para tiendas online, por esta razón te explico cómo configuramos Redsys en WooCommerce paso a paso.
- Instalar el plugin oficial de Redsys para WooCommerce: Puedes hacerlo de dos maneras:
A – Visita la web oficial de Redsys y descárgalo a tu ordenador desde esta url: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-tipos-de-integracion/modulos-pago/
Una vez descargado desde tu escritorio WordPress, ve a Plugins → Añadir nuevo → Subir plugin e instala el plugin oficial proporcionado por Redsys.
B – Desde tu escritorio WordPress, ve a Plugins → Añadir nuevo, busca «Redsys WooCommerce» y encontrarás el plugin gratuito del gran profesional José Conti llamado WooCommerce Redsys Gateway Light. Luego actívalo. - Acceder a la configuración del plugin: Dirígete a WooCommerce → Ajustes → Pagos, localiza la opción «Redsys (Tarjeta)» y pulsa en «Configurar».
- Introducir los datos del TPV proporcionados por el banco: Rellena los siguientes campos con los datos proporcionados por tu entidad bancaria:
- Número de comercio (FUC)
- Número de terminal (habitualmente 001)
- Clave secreta de encriptación (asegúrate de introducir correctamente la clave)
- Configurar el entorno (pruebas o real): Inicialmente selecciona el entorno de «Pruebas». Una vez realizadas todas las comprobaciones con éxito, cámbialo al entorno «Real» o «Producción».
- Realizar pruebas: Añade un producto de prueba con un precio simbólico y utiliza las tarjetas de prueba facilitadas por Redsys para realizar una operación autorizada y otra denegada. Verifica que todo funciona correctamente antes de pasar al entorno real.
- Activar el entorno de producción: Solicita a tu entidad bancaria los datos para el entorno real. Actualiza estos datos en la configuración del plugin y asegúrate de guardar los cambios.
- Desarrollador web desde 2003. He trabajado con Joomla!, WordPress y PrestaShop
- Consultor SEO desde 2009 en MarkeThink. También colaboro con otras agencias.
- Fundador y ex CEO de Events Marketing Group.
