Errores frecuentes de Redsys y cómo solucionarlos
Qué significan los códigos de Redsys más habituales — SIS0042, SIS0051, SIS0046, MasterCard 172/173/174 — y cómo resolver cada uno.
La mayoría de errores de Redsys vienen de credenciales o configuración incorrectas. SIS0042 significa que la firma es incorrecta (revisa tu clave secreta / SHA-256). SIS0051 es número de pedido repetido. SIS0046 es que el BIN de la tarjeta no está dado de alta. Los códigos MasterCard 172, 173 y 174 son de acción obligatoria y el plugin Premium los gestiona automáticamente.
Cómo leer un error de Redsys
Redsys devuelve un código (a menudo empieza por SIS) cuando rechaza una transacción. El código indica la causa; la mayoría son problemas de configuración, no de la tarjeta.
Activa los logs del plugin (Logs detallados en Premium) para capturar el código exacto y la petición que lo provocó.
Códigos de error comunes
Estos son los códigos que más ven las tiendas y qué hacer con cada uno.
| Código | Significado | Cómo solucionarlo |
|---|---|---|
| SIS0042 | La firma enviada no es correcta. | Vuelve a copiar la clave secreta SHA-256 exactamente; confirma que el plugin usa SHA-256 y no un algoritmo antiguo. |
| SIS0051 | Número de pedido repetido. | Un intento fallido deja reservado ese número. Usa un número de pedido nuevo y único en cada intento. |
| SIS0046 | El BIN de la tarjeta no está dado de alta. | Contacta con tu banco o con Redsys para dar de alta el BIN o ajustar la configuración del método de pago. |
| 172 / 173 / 174 | Códigos de acción obligatoria de MasterCard. | El plugin Premium realiza las acciones requeridas automáticamente, sin configuración. |
Errores MasterCard 172, 173 y 174
Cuando MasterCard devuelve 172, 173 o 174, el comercio debe realizar acciones obligatorias o se arriesga a sanciones de MasterCard y restricciones del banco.
El control de errores MasterCard del plugin Premium los gestiona automáticamente, sin configuración — un riesgo que la mayoría de tiendas ni conoce.
Lista de comprobación
- Confirma que los tres datos — número de comercio, terminal y clave secreta — coinciden exactamente con los de tu banco.
- Revisa el entorno: las credenciales de pruebas solo funcionan en el entorno de pruebas, y las reales en real.
- Asegúrate de que el plugin usa SHA-256.
- Lee los logs del plugin para ver el código SIS exacto.
- Si persiste, contacta con soporte con el código y la entrada del log.
Preguntas frecuentes
José Conti ofrece sus plugins premium de pasarela de pago totalmente gratis, con soporte de por vida, para ONGs legalmente registradas. Si gestionas una ONG y necesitas cobrar con Redsys, solicita una licencia gratuita.
Deja de perder pagos por errores
Premium añade control automático de errores MasterCard y logs detallados para diagnosticar cualquier incidencia rápido.