Códigos de error
Todos los errores retornan un JSON con success: false y un código de error.
Formato de error
Respuesta de error
{ "success": false, "error_code": "PA006", "error_message": "CBU inválido: debe tener exactamente 22 dígitos numéricos", "credits_remaining": 10, "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"}Tabla de errores
| Código | HTTP | Descripción | Consume crédito |
|---|---|---|---|
PA006 | 400 | CBU o Alias inválido | Sí |
PA011 | 404 | No se encontró información | Sí |
INSUFFICIENT_CREDITS | 402 | Sin créditos disponibles | No |
UNAUTHORIZED | 401 | API key inválida o faltante | No |
RATE_LIMITED | 429 | Exceso de requests por minuto | No |
GE500 | 500 | Error interno del servidor | No |
GE403 | 403 | Acceso denegado | No |
PA006 y PA011 consumen crédito porque se realizó la consulta al upstream. Los errores del sistema (GE500, RATE_LIMITED, UNAUTHORIZED, INSUFFICIENT_CREDITS, GE403) no consumen créditos.