Maneja errores de la API

Los errores públicos incluyen un código estable y un request_id. Usa el código para decidir y el request ID para soporte.

Clasifica la respuesta

Estado	Significado	Acción
`400`	Payload o parámetro inválido	Corrige la solicitud
`401`	Credencial ausente o inválida	Revisa host y llave
`403`	Scope o capability no concedido	Revisa permisos
`404`	Recurso ausente en este comercio y ambiente	Verifica el ID
`409`	Conflicto de estado, readiness o idempotencia	Lee `code`
`429`	Límite excedido	Respeta `Retry-After`
`5xx`	Dependencia temporalmente no disponible	Reintenta si la operación es idempotente

Registra request_id, método, ruta, status y código. No registres la llave, payloads financieros completos ni datos personales.

capability_not_enabled indica que el producto no está concedido. capability_not_ready indica que está concedido, pero falta readiness temporal.

Última modificación el 22 de agosto de 2026