> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/api-rest/identity-api/identity-api-reference/onboarding/morphology/document-validation-v2/document-validation-data-v2.md). # Document validation Data V2 Obtiene los resultados del análisis morfológico del documento **una vez que el proceso de validación se ha completado exitosamente**. {% hint style="info" %} Los campos de la respuesta dependerán del proveedor de morfología configurado. {% endhint %} ### Endpoint ``` POST /verify/documentValidation/v2/data ``` ### Headers | Nombre | Tipo | Requerido | Descripción | | ------------- | ------ | --------- | ------------------------------------------------------------- | | **x-api-key** | string | **Sí** | API key de autorización de acceso. | | **family** | string | No | Valor: **OnBoarding**. Requerido con el servicio de tracking. | {% hint style="info" %} Todas las llamadas a los Endpoints para tracking con **Identity Platform** deben contener el header `family`. {% endhint %} ### Cuerpo de la solicitud **Content-Type:** `application/json` #### Parámetros | Parámetro | Tipo | Requerido | Descripción | | ---------------------- | ------ | --------- | ------------------------------------------------------------------------------------------------------- | | `scanReference` | string | **Sí** | **Número de referencia** del escaneo. | | `type` | string | No | ⚠️ Valor **obsoleto**. Será eliminado en futuras versiones. | | `tracking` | object | No | Objeto que representa la información de seguimiento necesaria. | | `tracking.extraData` | string | No | Token generado por el SDK Mobile/Web. Contiene información de seguimiento tokenizada con la Plataforma. | | `tracking.operationId` | string | No | Identificador de operación generado por el SDK Mobile/Web. | #### Ejemplo de solicitud ```json { "scanReference": "fe294c25-17e1-4d98-a958-710edbf00064", "tracking": { "extraData": "BQABAQG2gBNjuHN4kLmPqYf7R...", "operationId": "123e4567-e89b-12d3-a456-426614174000" } } ``` ### Respuestas #### `200` Éxito #### Parámetros de respuesta — raíz | Parámetro | Tipo | Descripción | | -------------- | ------ | ----------------------------------------------------------------------------------- | | `status` | string | Estado del servicio. Valores posibles: `success`, `fail` | | `verification` | object | Objeto con los resultados de la verificación. Ver tablas detalladas a continuación. | #### Parámetros de respuesta — `verification` | Parámetro | Tipo | Nullable | Descripción | | ----------------------- | ------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `acceptanceTime` | string | No | Marca de tiempo inicial en formato **YYYY-MM-DDThh**:flag\_mm:**ss.SSSZ**. | | `code` | integer | No | Código de estado correspondiente. Valores posibles: `7001`, `7002`, `9001`, `9102`, `9103`, `9104`, `9121`. Ver [Verification Results](#verification-results). | | `decisionTime` | string | No | Marca de tiempo correspondiente al momento de la **decisión final**. | | `merchantScanReference` | string | No | Número de referencia de la validación. | | `scanReference` | string | No | Referencia interna proporcionada en el estado de inicio. | | `status` | string | No | Estado del proceso de validación del documento. Valores posibles: `created`, `started`, `submitted`, `inflow_completed`, `review`, `approved`, `declined`, `resubmission_requested`, `expired`, `abandoned`. Ver [Verification Results](#verification-results). | | `reason` | string | Sí | Descripción del motivo de rechazo del documento (status `declined` o `resubmission_requested`). Null si el estado es `approved`. Ver [Service Result Code](#service-result-code). | | `reasonCode` | integer | Sí | Código asociado al motivo de rechazo. Null si el estado es approved. Ver [Reason Codes](#reason-codes). | | `document` | object | No | Información del documento. Ver tabla a continuación. | | `person` | object | No | Información de la persona. Ver tabla a continuación. | #### Parámetros de respuesta — `verification.document` | Parámetro | Tipo | Nullable | Descripción | | -------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------- | | `type` | string | No | Tipo de documento. Valores posibles: `PASSPORT`, `DRIVING_LICENSE`, `ID_CARD`, `VISA`, `UNSUPPORTED` | | `country` | string | No | Código del país emisor en formato **ISO 3166-1 alpha-3**. | | `number` | string | No | Número del documento. | | `validFrom` | string | Sí | Fecha de emisión del documento. | | `validUntil` | string | No | Fecha de expiración del documento. | | `placeOfIssue` | string | No | Lugar de emisión. | | `firstIssue` | string | No | Fecha de la primera emisión del documento. | | `issueNumber` | string | No | Número de emisión. | | `issuedBy` | string | No | Autoridad emisora. | #### Parámetros de respuesta — `verification.person` | Parámetro | Tipo | Nullable | Descripción | | -------------- | ------ | -------- | ---------------------------------------------- | | `firstName` | string | Sí | Nombre del usuario. | | `lastName` | string | Sí | Apellido del usuario. | | `idNumber` | string | Sí | Número de documento del usuario. | | `citizenship` | string | Sí | Ciudadanía. | | `nationality` | string | Sí | Nacionalidad. | | `gender` | string | Sí | Género. | | `dateOfBirth` | string | Sí | Fecha de nacimiento en formato **YYYY-MM-DD**. | | `yearOfBirth` | string | Sí | Año de nacimiento **YYYY**. | | `placeOfBirth` | string | Sí | Lugar de nacimiento. | #### Service Result Code El `serviceResultCode` indica el resultado general de la ejecución del servicio: | serviceResultCode | Descripción | Código HTTP | | ----------------- | ------------------------------------------------------------------------------------ | ----------- | | 0 | La ejecución del servicio fue exitosa, el módulo procesó la solicitud correctamente. | 200 | #### Verification Results El campo `verification.status` en la respuesta de Document Validation Data indica el resultado de la verificación. {% hint style="warning" %} El valor de `verification.status` se devuelve **en minúsculas**, tal y como aparece en la columna `status` de la tabla siguiente (por ejemplo `"status": "declined"`, `"status": "approved"`). El estado de reenvío se transmite como `resubmission_requested`, **no** como `Resubmission`. Compara siempre el valor exacto. {% endhint %} | `status` | Código | Descripción | | ------------------------ | ------ | ---------------------------------------------------------- | | `started` | 7001 | El proceso de validación ha sido iniciado. | | `submitted` | 7002 | Enviado para procesamiento de validación. | | `approved` | 9001 | Verificado y aprobado exitosamente. | | `declined` | 9102 | La validación falló y fue rechazada de forma definitiva. | | `resubmission_requested` | 9103 | Requiere reenvío con correcciones o información adicional. | | `expired` / `abandoned` | 9104 | El proceso de validación ha expirado o fue abandonado. | | `review` | 9121 | En revisión manual para verificación adicional. | Además de los anteriores, el proceso puede devolver los estados intermedios `created` e `inflow_completed`, que la plataforma trata como estados en curso junto con `started`, `submitted` y `review`. #### Reason Codes La siguiente tabla contiene los códigos de motivo (`reasonCode`) que pueden acompañar al resultado del servicio, ordenados numéricamente. La columna **Estado asociado** indica el valor de `verification.status` con el que se publica cada código; los códigos marcados con `—` corresponden a errores de validación de la solicitud o de configuración, no a una decisión de verificación. {% hint style="info" %} Esta enumeración sigue la lista oficial publicada por el proveedor de verificación y puede ampliarse en el futuro. En función de la configuración de cada integración, es posible que una integración concreta no llegue a recibir todos los códigos listados. {% endhint %} {% hint style="warning" %} * El servicio transmite el valor de `reasonCode` **tal cual**, sin filtrarlo ni traducirlo: cualquier código de esta lista puede llegar al cliente. * Como **tendencia general**, los códigos del rango **5xx** acompañan normalmente a `declined` y los del rango **6xx** a `resubmission_requested`, pero **hay excepciones** (p. ej. `655` es `declined` y `643` puede aparecer con ambos estados). Por eso la decisión debe ramificarse **siempre** sobre `verification.status`, nunca sobre el rango numérico ni sobre el texto del motivo. Ver [Relación entre `reasonCode` y la decisión](#relacion-entre-reasoncode-y-la-decision). * El rango **900** (`901`–`906`) agrupa errores de consulta a registros y de proveedores de identidad digital. No debe confundirse con los valores `9001`, `9102`, `9103`, `9104` y `9121`, que corresponden al campo `verification.code` (estado de la verificación) y no a `reasonCode`. {% endhint %} | Código | Estado asociado | Descripción | | ------ | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 101 | `declined` | No se ha utilizado un documento físico | | 102 | `declined` | Sospecha de manipulación del documento | | 103 | `declined` | La persona que muestra el documento no parece coincidir con la foto del documento | | 104 | `declined` | El nombre introducido no coincide con el nombre del documento | | 105 | `declined` | Comportamiento sospechoso | | 106 | `declined` | Fraude conocido | | 107 | `declined` | Velocidad/abuso (uso abusivo del servicio) | | 108 | `declined` | Velocidad/abuso: usuario final duplicado | | 109 | `declined` | Velocidad/abuso: dispositivo duplicado | | 110 | `declined` | Velocidad/abuso: documento de identidad duplicado | | 111 | `declined` | Acceso fraudulento a la sesión | | 112 | `declined` | Ubicación IP restringida | | 113 | `declined` | Comportamiento sospechoso: creación masiva de identidades (*identity farming*) | | 120 | `declined` | La persona del retrato no parece coincidir con la foto de referencia | | 121 | `declined` | Falta el identificador de usuario | | 122 | `declined` | No se ha encontrado ninguna referencia | | 123 | `declined` | No se han superado las comprobaciones contra registros | | 124 | `declined` | El rostro ya existe en la colección de rostros | | 126 | `declined` | Posible coincidencia con una persona políticamente expuesta (PEP) | | 127 | `declined` | Coincidencia del rostro con una lista de bloqueo | | 128 | `declined` | El identificador del usuario final no coincide | | 201 | `resubmission_requested` | Faltan el vídeo y/o las fotos | | 202 | `resubmission_requested` | El rostro no se ve con claridad | | 203 | `resubmission_requested` | El documento no se ve completo | | 204 | `resubmission_requested` | Mala calidad de imagen | | 205 | `resubmission_requested` | Documento dañado | | 206 | `resubmission_requested` | Tipo de documento no soportado | | 207 | `resubmission_requested` | Documento caducado | | 208 | `resubmission_requested` | Falta el selfie | | 209 | `resubmission_requested` | Falta la foto del documento | | 210 | `resubmission_requested` | El anverso del documento se ha fotografiado dos veces | | 211 | `resubmission_requested` | El documento no es visible en la imagen del documento de identidad | | 212 | `resubmission_requested` | Encuadre del documento: parte del documento queda fuera de la imagen | | 213 | `resubmission_requested` | Documento tapado: el documento de identidad está parcialmente tapado (p. ej., por los dedos) | | 214 | `resubmission_requested` | Selfie de mala calidad: calidad insuficiente (p. ej., demasiado oscuro o borroso) | | 215 | `resubmission_requested` | Documento de mala calidad: el documento no es legible (p. ej., demasiado borroso u oscuro) | | 216 | `resubmission_requested` | Documento de mala calidad: reflejos | | 217 | `resubmission_requested` | Reenvío personalizado | | 218 | `resubmission_requested` | Se ha superado el límite de subidas | | 501 | `declined` | Alta probabilidad de intento fraudulento | | 502 | `declined` | Varias personas presentes en la sesión | | 503 | `declined` | Intento de engaño | | 504 | `declined` | Intento de engaño: uso de pantalla de dispositivo | | 505 | `declined` | Intento de engaño: uso de copia impresa | | 506 | `declined` | Documento presentado manipulado | | 507 | `declined` | Documento presentado manipulado: cruce de datos | | 508 | `declined` | Documento presentado manipulado: similitud del documento con un espécimen | | 509 | `declined` | La persona que muestra el documento no coincide con la foto del documento | | 510 | `declined` | Tipo de documento presentado no soportado | | 511 | `declined` | Documento presentado caducado | | 512 | `declined` | Documento presentado anulado o dañado | | 513 | `declined` | Documento presentado anulado | | 514 | `declined` | El documento presentado está dañado | | 515 | `declined` | Intento de engaño: pantalla de dispositivo en la imagen del rostro | | 516 | `declined` | Intento de engaño: pantalla de dispositivo en la imagen del documento | | 517 | `declined` | Intento de engaño: pantalla de dispositivo en la imagen del anverso del documento | | 518 | `declined` | Intento de engaño: pantalla de dispositivo en la imagen del reverso del documento | | 519 | `declined` | Intento de ataque por inyección | | 520 | `declined` | Intento de engaño: copia impresa en la imagen del rostro | | 521 | `declined` | Intento de engaño: copia impresa en la imagen del documento | | 522 | `declined` | Intento de engaño: copia impresa en la imagen del anverso del documento | | 523 | `declined` | Intento de engaño: copia impresa en la imagen del reverso del documento | | 524 | `declined` | Documento presentado manipulado: los datos del anverso del documento y del MRZ no coinciden | | 525 | `declined` | Documento presentado manipulado: los datos del anverso del documento y del código de barras no coinciden | | 526 | `declined` | Intento de engaño: fotos retransmitidas en *streaming* | | 527 | `declined` | No se han podido obtener los datos del justificante de domicilio | | 528 | `declined` | La fecha de emisión del justificante de domicilio es demasiado antigua | | 529 | `declined` | No se han podido validar los datos del documento nacional de identidad | | 530 | `declined` | La persona es menor de 13 años | | 531 | `declined` | La persona es menor de 14 años | | 532 | `declined` | La persona es menor de 16 años | | 533 | `declined` | La persona es menor de 18 años | | 534 | `declined` | La persona es menor de 20 años | | 535 | `declined` | La persona es menor de 21 años | | 536 | `declined` | La persona es menor de 25 años | | 537 | `declined` | No se ha podido recortar el retrato del documento | | 538 | `declined` | No se ha podido consultar la base de datos CIFAS | | 539 | `declined` | Se ha superado el límite de reenvíos | | 540 | `declined` | Puntuación de confianza baja para la sesión | | 541 | `declined` | El nombre del documento no coincide con el nombre indicado al iniciar la sesión | | 542 | `declined` | No se ha podido validar el CPF | | 543 | `declined` | La imagen de referencia del rostro tiene mala calidad | | 544 | `declined` | El registro no ha respondido | | 545 | `declined` | Falta la imagen de referencia | | 546 | `declined` | Calidad insuficiente de la imagen del rostro | | 547 | `declined` | Falta el rostro | | 548 | `declined` | Intento de engaño con imagen de referencia del rostro ausente | | 549 | `declined` | La validación NFC ha fallado | | 550 | `declined` | El nombre del justificante de domicilio no coincide con el nombre indicado al iniciar la sesión | | 551 | `declined` | No se reconoce el documento | | 552 | `declined` | Falta el anverso del documento | | 553 | `declined` | Falta el reverso del documento | | 554 | `declined` | El anverso del documento no aparece completo en la imagen | | 555 | `declined` | El reverso del documento no aparece completo en la imagen | | 556 | `declined` | La imagen del rostro no se ve con claridad | | 557 | `declined` | Los datos del documento no son visibles | | 558 | `declined` | No se han podido obtener los apellidos | | 559 | `declined` | No se han podido obtener los nombres | | 560 | `declined` | No se ha podido obtener la fecha de nacimiento | | 561 | `declined` | No se ha podido obtener el número de documento | | 562 | `declined` | No se ha podido obtener la fecha de caducidad | | 563 | `declined` | No se ha podido obtener el número personal | | 564 | `declined` | Demasiados intentos incorrectos o MFA incompleto | | 565 | `declined` | Categoría de permiso de conducir no soportada | | 566 | `declined` | Fallo de procesamiento del sistema | | 567 | `declined` | No se cumplen los criterios de decisión | | 568 | `declined` | Entrada no válida | | 569 | `declined` | No se ha podido recortar el rostro de la imagen del rostro | | 570 | `declined` | Rechazo personalizado | | 571 | `declined` | No se ha podido identificar el país | | 572 | `declined` | El número de documento no coincide con el número de documento indicado al iniciar la sesión | | 573 | `declined` | La dirección del documento no coincide con la dirección indicada al iniciar la sesión | | 574 | `declined` | A la dirección proporcionada le faltan campos obligatorios | | 575 | `declined` | Certificado no válido | | 576 | `declined` | La fecha de nacimiento del documento no coincide con la fecha de nacimiento indicada al iniciar la sesión | | 577 | `declined` | El número personal del documento no coincide con el número personal indicado al iniciar la sesión | | 578 | `declined` | El género del documento no coincide con el género indicado al iniciar la sesión | | 579 | `declined` | No se ha podido validar la firma del PDF | | 580 | `declined` | La comparación de la dirección ha fallado por restricciones regionales | | 581 | `declined` | La imagen del rostro proporcionada no coincide con la imagen del rostro del registro | | 582 | `declined` | El nombre proporcionado no coincide con el nombre del registro | | 583 | `declined` | La fecha de nacimiento proporcionada no coincide con la fecha de nacimiento del registro | | 584 | `declined` | El número personal proporcionado no coincide con el número personal del registro | | 585 | `declined` | La fecha de emisión del documento es demasiado antigua | | 586 | `declined` | Falta una entrada obligatoria | | 587 | `declined` | La ocupación del documento no coincide con la ocupación indicada al iniciar la sesión | | 602 | `resubmission_requested` | Tipo de documento presentado no soportado | | 603 | `resubmission_requested` | Falta el vídeo | | 604 | `resubmission_requested` | Faltan las imágenes del rostro y/o del documento | | 605 | `resubmission_requested` | Falta la imagen del rostro | | 606 | `resubmission_requested` | El rostro no se ve con claridad | | 607 | `resubmission_requested` | Falta el documento en la imagen | | 608 | `resubmission_requested` | Falta el anverso del documento | | 609 | `resubmission_requested` | Falta el reverso del documento | | 610 | `resubmission_requested` | Documento tapado | | 611 | `resubmission_requested` | Anverso del documento tapado | | 612 | `resubmission_requested` | Reverso del documento tapado | | 613 | `resubmission_requested` | El documento no aparece completo en la imagen | | 614 | `resubmission_requested` | El anverso del documento no aparece completo en la imagen | | 615 | `resubmission_requested` | El reverso del documento no aparece completo en la imagen | | 616 | `resubmission_requested` | Documento cubierto por reflejos | | 617 | `resubmission_requested` | Anverso del documento cubierto por reflejos | | 618 | `resubmission_requested` | Reverso del documento cubierto por reflejos | | 619 | `resubmission_requested` | Los datos del documento no son visibles | | 620 | `resubmission_requested` | Documento presentado caducado | | 621 | `resubmission_requested` | Documento anulado o dañado | | 622 | `resubmission_requested` | Documento anulado | | 623 | `resubmission_requested` | Documento presentado dañado | | 624 | `resubmission_requested` | La imagen del rostro del documento no es visible | | 625 | `resubmission_requested` | No se han podido obtener los apellidos | | 626 | `resubmission_requested` | No se han podido obtener los nombres | | 627 | `resubmission_requested` | No se ha podido obtener la fecha de nacimiento | | 628 | `resubmission_requested` | No se ha podido obtener la fecha de emisión | | 629 | `resubmission_requested` | No se ha podido obtener la fecha de caducidad | | 630 | `resubmission_requested` | No se ha podido obtener el género | | 631 | `resubmission_requested` | No se ha podido obtener el número de documento | | 632 | `resubmission_requested` | No se ha podido obtener el número personal | | 633 | `resubmission_requested` | No se ha podido obtener la nacionalidad | | 634 | `resubmission_requested` | No se ha podido obtener la dirección del domicilio | | 635 | `resubmission_requested` | Faltan el documento y la imagen del rostro | | 636 | `resubmission_requested` | El documento presentado no es real: uso de pantalla | | 637 | `resubmission_requested` | El documento presentado no es real: uso de copia impresa | | 638 | `resubmission_requested` | No se ha podido obtener el lugar de emisión | | 639 | `resubmission_requested` | No se ha podido obtener la fecha de primera emisión | | 640 | `resubmission_requested` | La persona no ha dado su consentimiento | | 641 | `resubmission_requested` | Se han detectado varios rostros | | 642 | `resubmission_requested` | Se han subido varios documentos | | 643 | `declined` / `resubmission_requested` | No se ha podido recortar la imagen del rostro del anverso del documento | | 644 | `resubmission_requested` | No se ha podido obtener el Identificador de Ciudadano (INE) | | 645 | `resubmission_requested` | Reenvío: no se ha podido obtener el OCR (IFE) | | 646 | `resubmission_requested` | No se ha podido estimar la edad | | 647 | `resubmission_requested` | No se reconoce el documento | | 648 | `resubmission_requested` | Problemas técnicos | | 649 | `resubmission_requested` | No se ha podido obtener la información de extranjería | | 650 | `resubmission_requested` | No se ha podido obtener el número de proceso | | 651 | `resubmission_requested` | No se ha podido obtener la información de ocupación | | 652 | `resubmission_requested` | No se ha podido obtener la información del empleador | | 653 | `resubmission_requested` | No se ha podido obtener el tipo de permiso de residencia | | 654 | `resubmission_requested` | No se ha podido obtener el número del permiso de conducir | | 655 | `declined` | No se ha podido obtener el nombre adicional | | 656 | `resubmission_requested` | Hay varias personas presentes en la sesión | | 657 | `resubmission_requested` | Falta la imagen del pasaporte abierto | | 658 | `resubmission_requested` | No se ha podido obtener el número de elector (*Elector Number*) | | 659 | `resubmission_requested` | No se ha podido obtener el identificador electoral | | 660 | `resubmission_requested` | No se ha podido obtener el primer apellido | | 661 | `resubmission_requested` | No se ha podido obtener el segundo apellido | | 662 | `resubmission_requested` | No se han podido obtener las observaciones del documento | | 663 | `resubmission_requested` | No se ha podido obtener el lugar de nacimiento | | 664 | `resubmission_requested` | No se ha podido obtener la categoría B | | 665 | `resubmission_requested` | No se ha podido obtener la fecha de emisión de la categoría B | | 666 | `resubmission_requested` | No se ha podido obtener la fecha de caducidad de la categoría B | | 667 | `resubmission_requested` | No se ha podido obtener la categoría AM | | 668 | `resubmission_requested` | No se ha podido obtener la categoría A | | 669 | `resubmission_requested` | No se ha podido obtener el número de emisión del documento | | 670 | `resubmission_requested` | No se ha podido obtener la autoridad emisora del documento | | 671 | `resubmission_requested` | No se han podido obtener los nombres adicionales | | 672 | `resubmission_requested` | No se han podido obtener los datos del código de barras | | 673 | `resubmission_requested` | El rostro no está centrado | | 674 | `resubmission_requested` | El rostro queda tapado por las gafas | | 675 | `resubmission_requested` | El rostro no está dentro de los límites de rotación | | 676 | `resubmission_requested` | No se ha podido recortar el rostro de la imagen del rostro | | 677 | `resubmission_requested` | Iluminación desigual del rostro | | 678 | `resubmission_requested` | Rostro desenfocado | | 679 | `resubmission_requested` | No se ha podido obtener el color de pelo | | 680 | `resubmission_requested` | No se ha podido obtener el color de ojos | | 681 | `resubmission_requested` | No se ha podido obtener la estatura | | 682 | `resubmission_requested` | No se ha podido obtener el peso | | 683 | `resubmission_requested` | Tamaño del rostro incorrecto en relación con la imagen | | 684 | `resubmission_requested` | Los ojos no están suficientemente abiertos | | 685 | `resubmission_requested` | Demasiado ruido digital en la imagen | | 686 | `resubmission_requested` | Contraste de la imagen demasiado bajo | | 687 | `resubmission_requested` | No se ha podido obtener la categoría del permiso de conducir | | 688 | `resubmission_requested` | El número de documento no coincide con el número de documento indicado al iniciar la sesión | | 689 | `resubmission_requested` | La dirección del documento no coincide con la dirección indicada al iniciar la sesión | | 690 | `resubmission_requested` | La fecha de nacimiento del documento no coincide con la fecha de nacimiento indicada al iniciar la sesión | | 691 | `resubmission_requested` | El número personal del documento no coincide con el número personal indicado al iniciar la sesión | | 692 | `resubmission_requested` | El género del documento no coincide con el género indicado al iniciar la sesión | | 693 | `resubmission_requested` | El nombre del documento no coincide con el nombre indicado al iniciar la sesión | | 694 | `resubmission_requested` | No se ha podido obtener ningún nombre | | 695 | `resubmission_requested` | No se ha podido identificar el tipo de documento a partir del documento | | 696 | `resubmission_requested` | La ocupación del documento no coincide con la ocupación indicada al iniciar la sesión | | 697 | `resubmission_requested` | No se ha podido validar la firma del PDF | | 901 | `declined` | Error del proveedor de registro al conectar con el registro | | 902 | `declined` | No se ha encontrado a la persona en el registro | | 903 | `declined` | Ha fallado la verificación de parte de la información personal | | 904 | `declined` | Documento denunciado como perdido o robado | | 905 | `declined` | La sesión del proveedor de identidad digital ha expirado | | 906 | `declined` | No se han compartido todos los campos y documentos de identidad digital requeridos | | 1001 | — | Error de validación de la solicitud: el identificador de consulta (*Query ID*) debe tener entre 20 y 40 caracteres. | | 1002 | — / `declined` | Error de validación de la solicitud: el identificador de consulta (*Query ID*) debe ser un UUID v4 válido. En integraciones con dPAD habilitado indica un ataque de reproducción en pantalla (*Screen Replay Attack*), siempre con estado `declined`. Ver la nota sobre dPAD tras esta tabla. | | 1003 | — / `declined` | Error de validación de la solicitud: el identificador de consulta (*Query ID*) debe ser único; ya se ha utilizado. En integraciones con dPAD habilitado indica una copia impresa en blanco y negro (*Black and White Printed Copy Attack*), siempre con estado `declined`. Ver la nota sobre dPAD tras esta tabla. | | 1005 | `declined` | Solo en integraciones con dPAD habilitado: sustitución de la fotografía del documento (*Photo Replacement Attack*). Ver la nota sobre dPAD tras esta tabla. | | 1102 | — | Faltan parámetros obligatorios en la solicitud. | | 1104 | — | La solicitud incluye parámetros no válidos. | | 1201 | — | Marca de tiempo no válida: no debe tener más de una hora de antigüedad. | | 1202 | — | El formato de la marca de tiempo es incorrecto. Debe ser `YYYY-MM-DDTHH:MM:S` + desfase horario. | | 1203 | — | Fecha ISO 8601 no válida: la fecha debe tener el formato `YYYY-MM-DD`. | | 1301 | — | Las funcionalidades solicitadas no están soportadas. | | 1302 | — | Solo se permiten URLs de retorno HTTPS. | | 1303 | — | Estado no válido. | | 1304 | — | No es posible la transición al estado indicado (`$STATUS`). | | 1308 | — | Falta el número de identificación (*ID number*). | | 1309 | — | La validación de SSN requiere `firstName` + `lastName` o `fullName` de la persona. | | 1310 | — | La validación de SSN requiere `person.dateOfBirth` o datos de dirección. | | 1400 | — | No se han encontrado los datos de la imagen. | | 1401 | — | La imagen no está en un base64 válido. | | 1402 | — | El contexto de la imagen no está soportado. | | 1403 | — | Falta una propiedad de la imagen. | | 1500 | — | El campo `vendorData` no puede superar los 1000 caracteres. | | 1501 | — | `vendorData` debe ser una cadena de texto. | | 2003 | — | La fecha de nacimiento no es una fecha válida. | | 2101 | — | El número de documento debe tener entre 6 y 9 caracteres. | | 2102 | — | El número de documento solo puede contener los caracteres A-Z y 0-9. | | 2103 | — | El tipo de documento no está soportado. | | 2104 | — | El documento del país indicado no está soportado. | **Códigos con doble significado (dPAD)** En integraciones con la detección pasiva de ataques de presentación del documento (**dPAD**) habilitada, los códigos `1002`, `1003` y `1005` se emiten cuando el diagnóstico de la validación es un intento de suplantación (*spoof*), siempre con `verification.status` = `declined`: | Código | Significado con dPAD habilitado | | ------ | ------------------------------------------------------------------------ | | `1002` | Ataque de reproducción en pantalla (*Screen Replay Attack*). | | `1003` | Copia impresa en blanco y negro (*Black and White Printed Copy Attack*). | | `1005` | Sustitución de la fotografía del documento (*Photo Replacement Attack*). | En integraciones **sin** dPAD, `1002` y `1003` conservan únicamente su significado de error de validación de la solicitud y `1005` no se emite. #### Relación entre `reasonCode` y la decisión El campo `reasonCode` explica **por qué** se tomó la decisión, pero **no indica por sí mismo cuál fue la decisión**. La decisión la determina siempre `verification.status`: | `verification.status` | Significado | | ------------------------ | -------------------------------------------------------------------------------------------------------- | | `declined` | Rechazo **definitivo**. El proceso ha terminado; el usuario no puede corregir el resultado reintentando. | | `resubmission_requested` | Rechazo **recuperable**. Se solicita al usuario un nuevo envío corrigiendo el problema indicado. | {% hint style="warning" %} Un **mismo motivo** puede aparecer bajo códigos distintos según la decisión asociada: existen pares equivalentes en los que el código 5xx corresponde a `declined` y el código 6xx a `resubmission_requested`. Algunos ejemplos: documento caducado (`511` / `620`), tipo de documento no soportado (`510` / `602`), falta el anverso (`552` / `608`), falta el reverso (`553` / `609`), datos del documento no visibles (`557` / `619`), documento no reconocido (`551` / `647`), apellidos no obtenidos (`558` / `625`) o fecha de caducidad no obtenida (`562` / `629`). Por tanto, **no deduzcas el resultado a partir del texto de `reason` ni del rango numérico del código**: ramifica siempre sobre el valor exacto de `verification.status`. {% endhint %} #### Ejemplo de respuesta ```json { "status": "success", "verification": { "acceptanceTime": "2019-11-06T07:15:27.000Z", "code": 9001, "decisionTime": "2019-11-06T07:18:36.916Z", "merchantScanReference": "12345678", "scanReference": "12df6045-3846-3e45-946a-14fa6136d79a", "status": "approved", "reason": null, "reasonCode": null, "document": { "type": "DRIVERS_LICENSE", "country": "ESP", "number": "PEREZ771116SM1AJ", "validFrom": null, "validUntil": "2024-04-20", "placeOfIssue": "MADRID", "firstIssue": "2015-03-21", "issueNumber": "01", "issuedBy": "ISSUER" }, "person": { "firstName": "MATIAS", "lastName": "PEREZ", "idNumber": null, "citizenship": null, "nationality": null, "gender": null, "dateOfBirth": "1973-03-30", "yearOfBirth": "1973", "placeOfBirth": "MADRID" } } } ``` #### `400` Bad Request ```json { "status": 400, "title": "Bad Request", "detail": "Invalid request.", "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400", "errors": [] } ``` #### `401` Unauthorized ```json { "message": "Unauthorized" } ``` #### `403` Forbidden ```json { "Message": "User is not authorized to access this resource with an explicit deny" } ``` #### `502` Bad Gateway ```json { "status": 502, "title": "Bad Gateway", "detail": "Server got an invalid response.", "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502" } ``` #### `504` Gateway Timeout ```json { "message": "Endpoint request timed out" } ```