# Errores · Documentación de Pagos Express

> Respuestas problem+json de la API de Pagos Express: códigos, estados HTTP y qué hacer con cada uno.

HTML: https://pagos.express/docs/errores
Texto para modelos: https://pagos.express/docs/errores.llms.txt
Índice de la documentación: https://pagos.express/docs

Todos los errores usan RFC 7807 (`application/problem+json`) con `type`, `title`, `status`, `code` y `detail`. El campo `code` es estable; decide con él, no con el texto. `type` apunta a https://pagos.express/docs/errors/<code>.

## Códigos
- validation_error 400: cuerpo o parámetros inválidos; `errors[]` trae path y message.
- unauthorized 401: clave ausente, inválida, revocada o token OAuth expirado.
- subscription_required 402: crear enlaces en vivo requiere suscripción activa.
- forbidden 403: modo equivocado, sin permiso o agente sin alcance.
- not_found 404: el recurso no existe en tu cuenta y modo.
- link_already_paid 409: el enlace ya se pagó.
- no_active_connection 409: sin conexión de proveedor activa en este modo.
- request_in_flight 409: otra petición con la misma Idempotency-Key sigue en curso; reintenta con la misma clave.
- link_expired 410: el enlace pasó su vencimiento.
- api_moved 410: llamaste a la API en el host del sitio; usa https://api.pagos.express.
- idempotency_key_reuse 422: misma clave con otro cuerpo u operación.
- provider_rejected 422: la pasarela rechazó la operación de forma definitiva.
- rate_limited 429: respeta `Retry-After`.
- internal_error 500: reintenta con la misma Idempotency-Key.
- provider_unavailable 503: la pasarela no respondió o el resultado es incierto; reintenta después.
- email_unavailable 503: correo no configurado en este despliegue.
- billing_unavailable 503: facturación de plataforma no configurada.
- invoicing_unavailable 409: no hay conexión con CFDI Express activa o falta elegir el emisor.
- invoicing_rejected 422: CFDI Express o el SAT rechazaron la factura; corrige los datos y vuelve a solicitarla.

Los 5xx y request_in_flight son reintentables con la misma Idempotency-Key. Los demás 4xx requieren corregir la petición.