Errores y estados
Status de verificación
Valor del campo status en la respuesta de una verificación:
| Status | Significado |
|---|---|
verified | Documento válido, superó las verificaciones |
invalid | Documento inválido o con indicios de alteración |
inconclusive | No fue posible concluir (calidad de imagen, datos ilegibles) |
manual_review | Requiere revisión humana |
processing | Aún en análisis — respuesta de POST /v1/verify/submit y de GET /v1/verify/result/{id} en REST, o de GetVerificationResult en SOAP, mientras el análisis en segundo plano no termina |
Cada check individual dentro de checks tiene su propio status:
passed, failed, warning o skipped.
Errores REST
| HTTP status | Causa |
|---|---|
400 | document_type no soportado en POST /v1/verify/submit |
403 | API key inválida/ausente, protocolo no habilitado para tu institución, tipo de documento no habilitado, o (en GET /v1/verify/result/{id}) la verificación consultada pertenece a otra institución |
404 | (GET /v1/verify/result/{id}) no existe una verificación con ese id |
500 | Error interno |
Faults SOAP
Los errores SOAP regresan HTTP 500 con un <soap:Fault> estándar:
| faultcode | Causa |
|---|---|
soap:Client.AuthenticationFailed | API key inválida o ausente |
soap:Client.InvalidDocumentType | documentType no soportado |
soap:Client.DocumentTypeNotEnabled | El tipo de documento no está incluido en tu plan |
soap:Client.Forbidden | Protocolo no habilitado, o la verificación consultada pertenece a otra institución |
soap:Client.NotFound | verificationId inexistente |
soap:Client | XML malformado, base64 inválido, archivo muy grande, etc. |
soap:Server | Error interno |
Límites
- Tamaño máximo de archivo: 30 MB decodificado (SOAP y REST).
- Formatos aceptados: PDF, JPEG, PNG, WEBP.
- Si integras desde una plataforma con su propio límite de payload (por ejemplo, algunas plataformas de bajo código limitan el tamaño de los webhooks), ese límite aplica primero — el base64 agrega ~33% de tamaño sobre el archivo original.
Last updated on