Respuestas de error

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

El servicio no puede atender la petición ahora mismo. A diferencia de un 500, esto no es un fallo inesperado: es una indisponibilidad conocida y casi siempre temporal.

Las causas habituales son un proveedor externo que no responde, o una ventana de mantenimiento.

Qué hacer

Reintenta con espera creciente: un segundo, dos, cuatro, ocho. Un 503 suele resolverse solo en cuestión de minutos.

Si era un POST, reintenta con la misma Idempotency-Key.

Si dura

Si un 503 se mantiene más de unos minutos, escríbenos con el requestId y la hora aproximada. A diferencia de los demás códigos, este suele afectar a más de un partner a la vez, así que es probable que ya lo estemos mirando.

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