Me topé con el error API 102 de HSBC: esto es todo lo que sé sobre él
Si has visto en tu pantalla un mensaje que menciona api_102, o alguna variante como API_102, mientras usabas la app de HSBC, la banca online o incluso una pasarela de pago conectada a sus sistemas, respira. No eres el único. Este código circula por foros y grupos de soporte desde hace tiempo, y la primera sensación al buscar información es de desconcierto. No porque no haya respuestas, sino porque nadie da una definición clara y universal.
Tras años gestionando arquitectura IT en entornos de comercio electrónico, donde los códigos de error ambiguos son el pan de cada día cuando integras pasarelas de pago y microservicios, puedo decir que la opacidad documentar en un sistema bancario no es tan rara como parece. HSBC, al final, es un conglomerado enorme de plataformas separadas: banca minorista, banca comercial, Open Banking, trade finance, HSBCnet, servicios de pagos internacionales... Cada una con su propia documentación, sus propios formatos de respuesta y, lo que es más frustrante, sus propios procedimientos de soporte técnico.
Y aquí está el quid de la cuestión. HSBC no publica una definición oficial, única y global del código api_102. Lo he comprobado revisando el portal de desarrolladores del banco, y lo que encontrarás son guías específicas por mercado y por API concreta. No existe una tabla maestra donde ponga 'api_102 = esto'. Por tanto, cualquier afirmación rotunda que leas en una web de terceros atribuyéndole un significado concreto, como 'es siempre un error de firma' o 'significa que tu token caducó', debe tomarse con mucha cautela. No está confirmado por el banco.
Lo que sí se puede afirmar con cierto criterio es que api_102 se relaciona con la comunicación entre una aplicación y los servidores de HSBC a través de su API. Es decir, algo falló en el intercambio de datos. Pero ese 'algo' es amplio. Podría ser una etiqueta interna que la app muestra sin más contexto, una respuesta inesperada del gateway, un problema de autenticación o validación de sesión, una caída momentánea de conectividad o un error transitorio del propio servicio. El código, aislado, no te dice cuál de todos esos supuestos aplica a tu caso.
En una etapa de mi carrera en la que tuve que coordinar incidencias entre equipos de desarrollo y proveedores de infraestructura, aprendí algo clave: un código de error sin contexto es como un diagnóstico médico que solo dice 'no funciona'. Necesitas saber dónde ocurrió, con qué parámetros, en qué entorno. Lo mismo aplica aquí.
Y muy importante, lo que este código NO demuestra por sí solo:
- No significa que tu cuenta esté bloqueada.
- No prueba que tu contraseña o token sean incorrectos.
- No indica que un pago haya sido rechazado por el banco.
- No confirma que HSBC tenga una caída generalizada.
- No implica que tu dispositivo esté comprometido ni que haya un fraude activo.
- No certifica que haya fallado una firma de API concreta.
Algunas webs especializadas en troubleshooting bancario insisten en que api_102 es siempre un problema de validación de token en Open Banking. Puede ser en algunos casos, pero no está respaldado por documentación oficial del banco, así que no conviene cerrar el diagnóstico ahí sin más pruebas.
El hecho de que la ambigüedad persista también se explica por la variabilidad entre países y filiales. Un error que aparece en HSBC México puede tener un manejo distinto al que se muestra en HSBC Reino Unido o HSBC España. Los equipos locales de soporte reciben el mismo código, pero las escalas internas, los endpoints afectados y los tiempos de resolución difieren bastante.
Así que, si te lo encuentras, lo primero no es entrar en pánico ni asumir lo peor. Es registrar todo. Guarda una captura exacta del mensaje, anota la fecha, la hora, la zona horaria, qué función estabas usando (transferencia, consulta de saldo, pago de factura), desde qué dispositivo y con qué versión de la app o navegador. Antes de compartir esa captura en ningún foro, elimina contraseñas, códigos OTP, números de cuenta completos y respuestas a preguntas de seguridad.
Después, cambia de canal. Si el error apareció en la app, prueba acceder desde la web oficial del banco, y viceversa. Esto te ayuda a separar un problema puntual de la aplicación (cache corrupta, versión desactualizada) de un problema más amplio que afecte a tu cuenta o al servicio en general. Yo lo hago casi por instinto cuando una herramienta me devuelve algo raro, porque en la mayoría de los casos el problema está en un lado y no en el otro.
Prueba también modificar la red. Pasa de wifi a datos móviles, o al contrario. Evita durante las pruebas redes corporativas con cortafuegos restrictivos, VPNs desconocidas o proxy corporativos que puedan estar filtrando o mutilando peticiones HTTPS. Cierra sesión por completo, reinicia la app, y si el dispositivo lo permite, reinicia también el terminal. Las actualizaciones, eso sí, únicamente desde la App Store o Google Play oficiales. Nada de APKs sueltos, perfiles de configuración raros ni 'herramientas de reparación' que prometen arreglar bancos.
Varias guías de soporte coinciden en un punto incómodo: api_102 es, a día de hoy, un error sin una solución específica pública y universalmente aceptada. Por eso la recomendación principal, cuando los pasos básicos no lo resuelven, es contactar directamente con HSBC. Puedes llamar por teléfono, escribir un mensaje dentro de la propia app o incluso acudir a sus perfiles oficiales en redes sociales. Los tiempos de respuesta varían según país y filial, así que ten paciencia.
Como complemento, algunas fuentes sugieren comprobaciones más prosaicas: verificar que las credenciales de acceso son correctas (mayúsculas, espacios), optimizar la conexión a internet, limpiar caché y cookies del navegador, o probar con un navegador distinto al habitual. Son acciones sencillas que no arreglan un problema de backend, pero sí eliminan variables locales del diagnóstico.
“Si el api_102 aparece durante un pago o transferencia, revisa el historial de transacciones antes de reintentar para evitar cobros duplicados.”
Dato clave