Saltar al contenido
Docs

Respuestas de error

500

Error interno

La API devuelve "title": "INTERNAL_SERVER_ERROR"

Un error de nuestro lado. No hay nada que corregir en tu petición.

Algo falló de nuestro lado. No es un error de tu petición: no hay nada que corregir en el cuerpo ni en las cabeceras.

Qué hacer

  1. Reintenta después de unos segundos, con espera creciente. Muchos 500 son transitorios.
  2. Si era un POST, reintenta con la misma Idempotency-Key. Es lo que evita crear el recurso dos veces si la primera llamada sí llegó a ejecutarse.
  3. Si persiste, escríbenos con el requestId.

El requestId es lo que necesitamos

{
"type": "https://docs.slan.mx/problems/500",
"title": "INTERNAL_SERVER_ERROR",
"status": 500,
"code": "INTERNAL_SERVER_ERROR",
"requestId": "01M2SJ4K5N6P7Q8R9S0T1U2V3W"
}

Ese identificador nos lleva directamente a la petición exacta: qué llegó, qué se ejecutó y dónde falló. Sin él, la única forma de encontrarla es adivinar por fecha y ruta.

Guárdalo en tu registro junto con el error, no solo en pantalla.

Lo que no vas a encontrar en la respuesta

Un 500 nunca incluye detalles internos: ni trazas, ni consultas, ni nombres de tablas. No es opacidad por gusto — esa información describe nuestra infraestructura y no ayuda a resolver nada desde fuera.

Códigos que aparecen con este estado

Programa contra el campo code, nunca contra detail: la redacción puede cambiar, el código no.

codeQué significa
INTERNAL_SERVER_ERRORError inesperado del lado de SLAN
PARTNER_END_USER_INSERT_FAILEDNo se pudo guardar el usuario final
WALLET_INSERT_FAILEDNo se pudo guardar la wallet

Llegaste aquí desde el campo type de una respuesta de error. La guíaErrores explica el formato completo y qué hacer con cada campo.