> 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/docs.facephi-pt-br/api-rest/identity-api/identity-api-reference/onboarding/civil-validation/honduras.md).

# Honduras

Serviço de validação civil para Honduras. Realiza a Verificação de Identidade em relação aos dados do Registro Civil de Honduras.

### Endpoint

```
POST /services/civilValidation
```

### Cabeçalhos

| Nome          | Tipo   | Obrigatório | Descrição                                                     |
| ------------- | ------ | ----------- | ------------------------------------------------------------- |
| **x-api-key** | string | **Sim**     | API Key de autorização de acesso.                             |
| **family**    | string | Não         | Valor: **Onboarding**. Obrigatório com o serviço de Tracking. |

{% hint style="info" %}
Todas as chamadas aos Endpoints para Tracking com **Identity Platform** devem conter o cabeçalho `family`.
{% endhint %}

## Validação Completa Mobile

Realiza a validação de dados e correspondência facial com o Registro Civil de Honduras usando plataforma móvel.

### Corpo da solicitação

**Content-Type:** `application/json`

#### Parâmetros

| Parâmetro              | Tipo    | Obrigatório | Descrição                                                                                                                                                                         |
| ---------------------- | ------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `operation`            | string  | **Sim**     | Operação de validação a ser realizada. Valor: `"FULL"`.                                                                                                                           |
| `platform`             | string  | **Sim**     | Plataforma a partir da qual a solicitação é realizada. Valor: `"MOBILE"`.                                                                                                         |
| `tokenOcr`             | string  | **Sim**     | Token gerado pelo Widget SelphID nativo ou híbrido, criptografado em AES256 e Tokenizado, enviado em formato Base64. Contém o resultado OCR do Documento de identidade capturado. |
| `templateRaw`          | string  | **Sim**     | Template Biométrico gerado pelo Widget Selphi. Necessário para operações FACIAL ou FULL.                                                                                          |
| `countryCode`          | string  | **Sim**     | Código de país no formato ISO 3166-1 alfa-3. Valor: `"HND"`.                                                                                                                      |
| `returnPII`            | boolean | Não         | Indica se se deseja receber os dados pessoais gerados pelo serviço OCR e a resposta do Registro Civil.                                                                            |
| `documentValidation`   | boolean | Não         | Indica se se deseja iniciar a validação do documento, retornando `scanReference` e `type`.                                                                                        |
| `tracking`             | object  | Não         | Objeto que representa as informações de Tracking necessárias.                                                                                                                     |
| `tracking.extraData`   | string  | Não         | Token gerado pelo SDK Mobile/Web. Contém informações de Tracking tokenizadas com a Plataforma.                                                                                    |
| `tracking.operationId` | string  | Não         | Identificador de operação gerado pelo SDK Mobile/Web.                                                                                                                             |

#### Exemplo de solicitação

```json
{
  "operation": "FULL",
  "platform": "MOBILE",
  "tokenOcr": "base64TokenOcrString",
  "templateRaw": "base64TemplateRawString",
  "countryCode": "HND",
  "returnPII": false,
  "tracking": {
    "extraData": "BQABAQG2gBNjuHN...",
    "operationId": "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx"
  }
}
```

### Respostas

#### `200` Sucesso

#### Parâmetros de resposta

| Parâmetro                           | Tipo    | Descrição                                                                                                                                            |
| ----------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `serviceResultCode`                 | integer | Código que indica o resultado geral da execução do serviço. Ver [Código de Resultado do Serviço](#service-result-code).                              |
| `serviceTime`                       | string  | Tempo total de processamento (milissegundos).                                                                                                        |
| `serviceResultLog`                  | string  | Campo descritivo do resultado da execução do serviço. Inclui detalhes quando há um erro ou exceção.                                                  |
| `serviceTransactionId`              | string  | Identificador de transação associado à solicitação processada pela API.                                                                              |
| `civilDataValidation`               | array   | Array que representa as validações OCR contra os dados obtidos do Registro Civil. Sua presença depende do Registro Civil consultado.                 |
| `civilDataValidation[].field`       | string  | Nome do campo validado (ex. `firstName`, `lastName`, `dateOfBirth`).                                                                                 |
| `civilDataValidation[].code`        | string  | Código de resultado da validação. `"0"`: Validado corretamente. `"-99"`: Possivelmente adulterado.                                                   |
| `civilDataValidation[].message`     | string  | Mensagem descritiva do resultado da validação.                                                                                                       |
| `serviceFacialAuthenticationResult` | integer | Código que indica o resultado da correspondência facial. Ver [Resultado de Authentication Facial do Serviço](#service-facial-authentication-result). |
| `serviceFacialSimilarityResult`     | number  | Valor que indica a semelhança facial entre o rosto na foto do documento e a selfie do usuário. **1.0 = 100%**.                                       |
| `serviceFacialAuthenticationHash`   | string  | Hash de integridade do Template Biométrico utilizado em uma autenticação facial positiva ou incerta.                                                 |
| `serviceDocument`                   | string  | String JSON que representa o documento capturado. Suas propriedades são todos os campos extraídos pelo processo OCR.                                 |
| `civilServiceData`                  | string  | String JSON com os dados pessoais obtidos do Registro Civil (só é retornado se `returnPII` foi enviado como `true` na solicitação).                  |

#### Exemplo de resposta

```json
{
  "serviceResultCode": 0,
  "serviceTime": "1799",
  "serviceResultLog": "Positivo | Serviço executado com sucesso",
  "serviceTransactionId": "f0392b79-664c-476f-8fad-d30009b68d60",
  "civilDataValidation": [
    {
      "field": "firstName",
      "code": "-99",
      "message": "Possivelmente adulterado"
    },
    {
      "field": "lastName",
      "code": "0",
      "message": "Validado com sucesso"
    },
    {
      "field": "dateOfBirth",
      "code": "0",
      "message": "Validado com sucesso"
    }
  ],
  "serviceFacialAuthenticationResult": 3,
  "serviceFacialSimilarityResult": 0.9946,
  "serviceFacialAuthenticationHash": "NA",
  "serviceDocument": "{\"Back/INPUT/Issuer\":\"HND\",\"Back/ML/DateOfBirth\":\"13/04/1964\",\"Back/ML/DateOfExpiry\":\"16/04/2023\",\"Back/ML/DocumentNumber\":\"1 0627 0723\",\"Back/ML/ElectoralAddress\":\"\",\"Back/ML/FatherName\":\"LUOOT NOT. HOSPITAL CENTRAL SAN JOSE\",\"Back/ML/Gender\":\"\",\"Back/ML/MotherName\":\"XO F\",\"Back/ML/PlaceOfBirth\":\"Domicilio Ectoral SAN BOSCO CENTRAL SAN JOSE\",\"DateOfBirth\":\"13/04/1964\",\"DateOfExpiry\":\"16/04/2023\",\"DocumentCaptured\":\"CR/All\",\"DocumentNumber\":\"1 0627 0723\",\"FirstName\":\"\",\"Front/INPUT/Issuer\":\"HND\",\"Front/ML/CC\":\".:\")}",
  "civilServiceData": "{\"nombres\":\"APUY STIER\",\"fechaNacimiento\":\"13/04/1964\",\"fechaVencimiento\":\"16/04/2023\",\"lugarNacimiento\":\"SAN BOSCO CENTRAL SAN JOSE\"}"
}
```

## Validação Completa Web

Realiza a validação de dados e correspondência facial com o Registro Civil de Honduras usando plataforma web.

### Corpo da solicitação

**Content-Type:** `application/json`

#### Parâmetros

| Parâmetro              | Tipo    | Obrigatório | Descrição                                                                                                    |
| ---------------------- | ------- | ----------- | ------------------------------------------------------------------------------------------------------------ |
| `operation`            | string  | **Sim**     | Operação de validação a ser realizada. Valor: `"FULL"`.                                                      |
| `platform`             | string  | **Sim**     | Plataforma a partir da qual a solicitação é realizada. Valor: `"WEB"`.                                       |
| `imageFrontDocument`   | string  | **Sim**     | Captura frontal do documento, imagem em Base64 sem o cabeçalho do tipo MIME. Requerido para plataforma WEB.  |
| `imageBackDocument`    | string  | **Sim**     | Captura traseira do documento, imagem em Base64 sem o cabeçalho do tipo MIME. Requerido para plataforma WEB. |
| `templateRaw`          | string  | **Sim**     | Template Biométrico gerado pelo Widget Selphi. Necessário para operações FACIAL ou FULL.                     |
| `countryCode`          | string  | **Sim**     | Código de país no formato ISO 3166-1 alfa-3. Valor: `"HND"`.                                                 |
| `returnPII`            | boolean | Não         | Indica se se deseja receber os dados pessoais gerados pelo serviço OCR e a resposta do Registro Civil.       |
| `documentValidation`   | boolean | Não         | Indica se se deseja iniciar a validação do documento, retornando `scanReference` e `type`.                   |
| `tracking`             | object  | Não         | Objeto que representa as informações de Tracking necessárias.                                                |
| `tracking.extraData`   | string  | Não         | Token gerado pelo SDK Mobile/Web. Contém informações de Tracking tokenizadas com a Plataforma.               |
| `tracking.operationId` | string  | Não         | Identificador de operação gerado pelo SDK Mobile/Web.                                                        |

#### Exemplo de solicitação

```json
{
  "operation": "FULL",
  "platform": "WEB",
  "imageFrontDocument": "base64ImageFrontString",
  "imageBackDocument": "base64ImageBackString",
  "templateRaw": "base64TemplateRawString",
  "countryCode": "HND",
  "returnPII": false,
  "tracking": {
    "extraData": "BQABAQG2gBNjuHN...",
    "operationId": "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx"
  }
}
```

### Respostas

#### `200` Sucesso

#### Parâmetros de resposta

| Parâmetro                           | Tipo    | Descrição                                                                                                                                            |
| ----------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `serviceResultCode`                 | integer | Código que indica o resultado geral da execução do serviço. Ver [Código de Resultado do Serviço](#service-result-code).                              |
| `serviceTime`                       | string  | Tempo total de processamento (milissegundos).                                                                                                        |
| `serviceResultLog`                  | string  | Campo descritivo do resultado da execução do serviço. Inclui detalhes quando há um erro ou exceção.                                                  |
| `serviceTransactionId`              | string  | Identificador de transação associado à solicitação processada pela API.                                                                              |
| `civilDataValidation`               | array   | Array que representa as validações OCR contra os dados obtidos do Registro Civil. Sua presença depende do Registro Civil consultado.                 |
| `civilDataValidation[].field`       | string  | Nome do campo validado (ex. `firstName`, `lastName`, `dateOfBirth`).                                                                                 |
| `civilDataValidation[].code`        | string  | Código de resultado da validação. `"0"`: Validado corretamente. `"-99"`: Possivelmente adulterado.                                                   |
| `civilDataValidation[].message`     | string  | Mensagem descritiva do resultado da validação.                                                                                                       |
| `serviceFacialAuthenticationResult` | integer | Código que indica o resultado da correspondência facial. Ver [Resultado de Authentication Facial do Serviço](#service-facial-authentication-result). |
| `serviceFacialSimilarityResult`     | number  | Valor que indica a semelhança facial entre o rosto na foto do documento e a selfie do usuário. **1.0 = 100%**.                                       |
| `serviceFacialAuthenticationHash`   | string  | Hash de integridade do Template Biométrico utilizado em uma autenticação facial positiva ou incerta.                                                 |
| `serviceDocument`                   | string  | String JSON que representa o documento capturado. Suas propriedades são todos os campos extraídos pelo processo OCR.                                 |
| `civilServiceData`                  | string  | String JSON com os dados pessoais obtidos do Registro Civil (só é retornado se `returnPII` foi enviado como `true` na solicitação).                  |

#### Exemplo de resposta

```json
{
  "serviceResultCode": 0,
  "serviceTime": "4074",
  "serviceResultLog": "Negativo | Serviço executado com sucesso",
  "serviceTransactionId": "e1243a68-be8f-464c-94a7-e8a5562d71a0",
  "civilDataValidation": [
    {
      "field": "firstName",
      "code": "-99",
      "message": "Possivelmente adulterado"
    },
    {
      "field": "lastName",
      "code": "0",
      "message": "Validado com sucesso"
    },
    {
      "field": "dateOfBirth",
      "code": "0",
      "message": "Validado com sucesso"
    }
  ],
  "serviceFacialAuthenticationResult": 1,
  "serviceFacialSimilarityResult": 0,
  "serviceFacialAuthenticationHash": "NA",
  "serviceDocument": "{\"ASK4BACK\":\"NO\",\"BACKSIDE\":{\"FIELD_DATA\":{\"ADDRESS\":\"SAN RAFAEL POAS ALAJUELA\",\"BARCODES\":[{\"DATA\":\"\",\"TYPE\":\"\"}],\"BIRTH_DATE\":\" 19 10 1984\",\"BIRTH_PLACE\":\"CENTRO CENTRAL ALAJUELA\",\"EXPIRATION_DATE\":\" 07 02 2028\",\"FATHER_NAME\":\"LUIS RODRIGUEZ CASTRO\",\"IDENTITY_NUMBER\":\"205990558\",\"MOTHER_NAME\":\"FLORA ISABEL QUESADA CASTRO\",\"SEX\":\"\",\"VERTICAL_NUMBER\":\"000631975\"}},\"CHECKS\":{\"IDENTITY_NUMBER_SIDE_MATCH\":true},\"COUNTRY_CODE\":\"HND\",\"DOC_MODEL\":\"NEW\",\"FRONTSIDE\":{\"FIELD_DATA\":{\"FIRST_SURNAME\":\"RODRIGUEZ\",\"IDENTITY_NUMBER\":\"205990558\",\"NAME\":\"LUIS\",\"SECOND_SURNAME\":\"QUESADA\"}},\"SCORING\":{\"BACK_CONFIDENCE\":0.976855586876,\"BACK_SHA256\":\"4dfb73e9c8cbba6db42d1e4938ba1e62244bfe26efecd55579a4f65c9aed63ae\",\"FIELDS_RETURNED\":15,\"FIELDS_TOTAL\":15,\"FRONT_CONFIDENCE\":0.922833224138,\"FRONT_SHA256\":\"506b3192e0e80f851012f895300c63e8c85fea0ca78b9d99195e6256afadc5d4\",\"OVERALL_RATING\":100.0,\"OVERALL_SIDE_CORRESPONDENCE\":100.0}}",
  "civilServiceData": "{\"nombres\":\"LUIS RODRIGUEZ QUESADA\",\"fechaNacimiento\":\"19/10/1984\",\"lugarNacimiento\":\"CENTRO CENTRAL ALAJUELA\",\"direccion\":\"SAN RAFAEL POAS ALAJUELA\"}"
}
```

## Validação de Dados Mobile

Realiza a validação de dados contra o Registro Civil de Honduras usando plataforma móvel. Não inclui correspondência facial.

### Corpo da solicitação

**Content-Type:** `application/json`

#### Parâmetros

| Parâmetro              | Tipo    | Obrigatório | Descrição                                                                                                                                                                         |
| ---------------------- | ------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `operation`            | string  | **Sim**     | Operação de validação a ser realizada. Valor: `"DATA"`.                                                                                                                           |
| `platform`             | string  | **Sim**     | Plataforma a partir da qual a solicitação é realizada. Valor: `"MOBILE"`.                                                                                                         |
| `tokenOcr`             | string  | **Sim**     | Token gerado pelo Widget SelphID nativo ou híbrido, criptografado em AES256 e Tokenizado, enviado em formato Base64. Contém o resultado OCR do Documento de identidade capturado. |
| `countryCode`          | string  | **Sim**     | Código de país no formato ISO 3166-1 alfa-3. Valor: `"HND"`.                                                                                                                      |
| `returnPII`            | boolean | Não         | Indica se se deseja receber os dados pessoais gerados pelo serviço OCR e a resposta do Registro Civil.                                                                            |
| `documentValidation`   | boolean | Não         | Indica se se deseja iniciar a validação do documento, retornando `scanReference` e `type`.                                                                                        |
| `tracking`             | object  | Não         | Objeto que representa as informações de Tracking necessárias.                                                                                                                     |
| `tracking.extraData`   | string  | Não         | Token gerado pelo SDK Mobile/Web. Contém informações de Tracking tokenizadas com a Plataforma.                                                                                    |
| `tracking.operationId` | string  | Não         | Identificador de operação gerado pelo SDK Mobile/Web.                                                                                                                             |

#### Exemplo de solicitação

```json
{
  "operation": "DATA",
  "platform": "MOBILE",
  "tokenOcr": "base64TokenOcrString",
  "countryCode": "HND",
  "returnPII": true,
  "tracking": {
    "extraData": "BQABAQG2gBNjuHN...",
    "operationId": "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx"
  }
}
```

### Respostas

#### `200` Sucesso

#### Parâmetros de resposta

| Parâmetro                       | Tipo    | Descrição                                                                                                                            |
| ------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `serviceResultCode`             | integer | Código que indica o resultado geral da execução do serviço. Ver [Código de Resultado do Serviço](#service-result-code).              |
| `serviceTime`                   | string  | Tempo total de processamento (milissegundos).                                                                                        |
| `serviceResultLog`              | string  | Campo descritivo do resultado da execução do serviço. Inclui detalhes quando há um erro ou exceção.                                  |
| `serviceTransactionId`          | string  | Identificador de transação associado à solicitação processada pela API.                                                              |
| `civilDataValidation`           | array   | Array que representa as validações OCR contra os dados obtidos do Registro Civil. Sua presença depende do Registro Civil consultado. |
| `civilDataValidation[].field`   | string  | Nome do campo validado (ex. `firstName`, `lastName`, `dateOfBirth`).                                                                 |
| `civilDataValidation[].code`    | string  | Código de resultado da validação. `"0"`: Validado corretamente. `"-99"`: Possivelmente adulterado.                                   |
| `civilDataValidation[].message` | string  | Mensagem descritiva do resultado da validação.                                                                                       |
| `serviceDocument`               | string  | String JSON que representa o documento capturado. Suas propriedades são todos os campos extraídos pelo processo OCR.                 |
| `civilServiceData`              | string  | String JSON com os dados pessoais obtidos do Registro Civil (só é retornado se `returnPII` foi enviado como `true` na solicitação).  |

#### Exemplo de resposta

```json
{
  "serviceResultCode": 0,
  "serviceTime": "1232",
  "serviceResultLog": "Serviço executado com sucesso",
  "serviceTransactionId": "796a580b-67b5-4a6e-a19a-5b9145ad55cd",
  "civilDataValidation": [
    {
      "field": "firstName",
      "code": "-99",
      "message": "Possivelmente adulterado"
    },
    {
      "field": "lastName",
      "code": "0",
      "message": "Validado com sucesso"
    },
    {
      "field": "dateOfBirth",
      "code": "0",
      "message": "Validado com sucesso"
    }
  ],
  "serviceDocument": "{\"Back/INPUT/Issuer\":\"HND\",\"Back/ML/DateOfBirth\":\"13/04/1964\",\"Back/ML/DateOfExpiry\":\"16/04/2023\",\"Back/ML/DocumentNumber\":\"1 0627 0723\",\"Back/ML/ElectoralAddress\":\"\",\"Back/ML/FatherName\":\"LUOOT NOT. HOSPITAL CENTRAL SAN JOSE\",\"Back/ML/Gender\":\"\",\"Back/ML/MotherName\":\"XO F\",\"Back/ML/PlaceOfBirth\":\"Domicilio Ectoral SAN BOSCO CENTRAL SAN JOSE\",\"DateOfBirth\":\"13/04/1964\",\"DateOfExpiry\":\"16/04/2023\",\"DocumentCaptured\":\"CR/All\",\"DocumentNumber\":\"1 0627 0723\",\"FirstName\":\"\",\"Front/INPUT/Issuer\":\"HND\",\"Front/ML/CC\":\".:\")}",
  "civilServiceData": "{\"nombres\":\"APUY STIER\",\"fechaNacimiento\":\"13/04/1964\",\"lugarNacimiento\":\"HOSPITAL CENTRAL SAN JOSE\"}"
}
```

## Validação de Dados Web

Realiza a validação de dados contra o Registro Civil de Honduras usando plataforma web. Não inclui correspondência facial.

### Corpo da solicitação

**Content-Type:** `application/json`

#### Parâmetros

| Parâmetro              | Tipo    | Obrigatório | Descrição                                                                                                    |
| ---------------------- | ------- | ----------- | ------------------------------------------------------------------------------------------------------------ |
| `operation`            | string  | **Sim**     | Operação de validação a ser realizada. Valor: `"DATA"`.                                                      |
| `platform`             | string  | **Sim**     | Plataforma a partir da qual a solicitação é realizada. Valor: `"WEB"`.                                       |
| `imageFrontDocument`   | string  | **Sim**     | Captura frontal do documento, imagem em Base64 sem o cabeçalho do tipo MIME. Requerido para plataforma WEB.  |
| `imageBackDocument`    | string  | **Sim**     | Captura traseira do documento, imagem em Base64 sem o cabeçalho do tipo MIME. Requerido para plataforma WEB. |
| `countryCode`          | string  | **Sim**     | Código de país no formato ISO 3166-1 alfa-3. Valor: `"HND"`.                                                 |
| `returnPII`            | boolean | Não         | Indica se se deseja receber os dados pessoais gerados pelo serviço OCR e a resposta do Registro Civil.       |
| `documentValidation`   | boolean | Não         | Indica se se deseja iniciar a validação do documento, retornando `scanReference` e `type`.                   |
| `tracking`             | object  | Não         | Objeto que representa as informações de Tracking necessárias.                                                |
| `tracking.extraData`   | string  | Não         | Token gerado pelo SDK Mobile/Web. Contém informações de Tracking tokenizadas com a Plataforma.               |
| `tracking.operationId` | string  | Não         | Identificador de operação gerado pelo SDK Mobile/Web.                                                        |

#### Exemplo de solicitação

```json
{
  "operation": "DATA",
  "platform": "WEB",
  "imageFrontDocument": "base64ImageFrontString",
  "imageBackDocument": "base64ImageBackString",
  "countryCode": "HND",
  "returnPII": false,
  "tracking": {
    "extraData": "BQABAQG2gBNjuHN...",
    "operationId": "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx"
  }
}
```

### Respostas

#### `200` Sucesso

#### Parâmetros de resposta

| Parâmetro                       | Tipo    | Descrição                                                                                                                            |
| ------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `serviceResultCode`             | integer | Código que indica o resultado geral da execução do serviço. Ver [Código de Resultado do Serviço](#service-result-code).              |
| `serviceTime`                   | string  | Tempo total de processamento (milissegundos).                                                                                        |
| `serviceResultLog`              | string  | Campo descritivo do resultado da execução do serviço. Inclui detalhes quando há um erro ou exceção.                                  |
| `serviceTransactionId`          | string  | Identificador de transação associado à solicitação processada pela API.                                                              |
| `civilDataValidation`           | array   | Array que representa as validações OCR contra os dados obtidos do Registro Civil. Sua presença depende do Registro Civil consultado. |
| `civilDataValidation[].field`   | string  | Nome do campo validado (ex. `firstName`, `lastName`, `dateOfBirth`).                                                                 |
| `civilDataValidation[].code`    | string  | Código de resultado da validação. `"0"`: Validado corretamente. `"-99"`: Possivelmente adulterado.                                   |
| `civilDataValidation[].message` | string  | Mensagem descritiva do resultado da validação.                                                                                       |
| `serviceDocument`               | string  | String JSON que representa o documento capturado. Suas propriedades são todos os campos extraídos pelo processo OCR.                 |
| `civilServiceData`              | string  | String JSON com os dados pessoais obtidos do Registro Civil (só é retornado se `returnPII` foi enviado como `true` na solicitação).  |

#### Exemplo de resposta

```json
{
  "serviceResultCode": 0,
  "serviceTime": "3651",
  "serviceResultLog": "Serviço executado com sucesso",
  "serviceTransactionId": "3e915bc6-b6e6-4f77-bc26-2c59193078ee",
  "civilDataValidation": [
    {
      "field": "firstName",
      "code": "-99",
      "message": "Possivelmente adulterado"
    },
    {
      "field": "lastName",
      "code": "0",
      "message": "Validado com sucesso"
    },
    {
      "field": "dateOfBirth",
      "code": "0",
      "message": "Validado com sucesso"
    }
  ],
  "serviceDocument": "{\"ASK4BACK\":\"NO\",\"BACKSIDE\":{\"FIELD_DATA\":{\"ADDRESS\":\"SAN RAFAEL POAS ALAJUELA\",\"BARCODES\":[{\"DATA\":\"\",\"TYPE\":\"\"}],\"BIRTH_DATE\":\" 19 10 1984\",\"BIRTH_PLACE\":\"CENTRO CENTRAL ALAJUELA\",\"EXPIRATION_DATE\":\" 07 02 2028\",\"FATHER_NAME\":\"LUIS RODRIGUEZ CASTRO\",\"IDENTITY_NUMBER\":\"205990558\",\"MOTHER_NAME\":\"FLORA ISABEL QUESADA CASTRO\",\"SEX\":\"\",\"VERTICAL_NUMBER\":\"000631975\"}},\"CHECKS\":{\"IDENTITY_NUMBER_SIDE_MATCH\":true},\"COUNTRY_CODE\":\"HND\",\"DOC_MODEL\":\"NEW\",\"FRONTSIDE\":{\"FIELD_DATA\":{\"FIRST_SURNAME\":\"RODRIGUEZ\",\"IDENTITY_NUMBER\":\"205990558\",\"NAME\":\"LUIS\",\"SECOND_SURNAME\":\"QUESADA\"}},\"SCORING\":{\"BACK_CONFIDENCE\":0.976855586876,\"BACK_SHA256\":\"4dfb73e9c8cbba6db42d1e4938ba1e62244bfe26efecd55579a4f65c9aed63ae\",\"FIELDS_RETURNED\":15,\"FIELDS_TOTAL\":15,\"FRONT_CONFIDENCE\":0.922833224138,\"FRONT_SHA256\":\"506b3192e0e80f851012f895300c63e8c85fea0ca78b9d99195e6256afadc5d4\",\"OVERALL_RATING\":100.0,\"OVERALL_SIDE_CORRESPONDENCE\":100.0}}",
  "civilServiceData": "{\"nombres\":\"LUIS RODRIGUEZ QUESADA\",\"fechaNacimiento\":\"19/10/1984\",\"lugarNacimiento\":\"CENTRO CENTRAL ALAJUELA\"}"
}
```

## Validação Facial Mobile

Realiza a correspondência facial com as imagens oficiais do Registro Civil de Honduras usando plataforma móvel. Não inclui validação de dados.

### Corpo da solicitação

**Content-Type:** `application/json`

#### Parâmetros

| Parâmetro              | Tipo   | Obrigatório | Descrição                                                                                      |
| ---------------------- | ------ | ----------- | ---------------------------------------------------------------------------------------------- |
| `operation`            | string | **Sim**     | Operação de validação a ser realizada. Valor: `"FACIAL"`.                                      |
| `platform`             | string | **Sim**     | Plataforma a partir da qual a solicitação é realizada. Valor: `"MOBILE"`.                      |
| `templateRaw`          | string | **Sim**     | Template Biométrico gerado pelo Widget Selphi. Necessário para operações FACIAL ou FULL.       |
| `documentNumber`       | string | Não         | Número do documento do usuário. Requerido para operações FACIAL em Honduras.                   |
| `countryCode`          | string | **Sim**     | Código de país no formato ISO 3166-1 alfa-3. Valor: `"HND"`.                                   |
| `tracking`             | object | Não         | Objeto que representa as informações de Tracking necessárias.                                  |
| `tracking.extraData`   | string | Não         | Token gerado pelo SDK Mobile/Web. Contém informações de Tracking tokenizadas com a Plataforma. |
| `tracking.operationId` | string | Não         | Identificador de operação gerado pelo SDK Mobile/Web.                                          |

#### Exemplo de solicitação

```json
{
  "operation": "FACIAL",
  "platform": "MOBILE",
  "templateRaw": "base64TemplateRawString",
  "documentNumber": "1 0627 0723",
  "countryCode": "HND",
  "tracking": {
    "extraData": "BQABAQG2gBNjuHN...",
    "operationId": "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx"
  }
}
```

### Respostas

#### `200` Sucesso

#### Parâmetros de resposta

| Parâmetro                           | Tipo    | Descrição                                                                                                                                            |
| ----------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `serviceResultCode`                 | integer | Código que indica o resultado geral da execução do serviço. Ver [Código de Resultado do Serviço](#service-result-code).                              |
| `serviceTime`                       | string  | Tempo total de processamento (milissegundos).                                                                                                        |
| `serviceResultLog`                  | string  | Campo descritivo do resultado da execução do serviço. Inclui detalhes quando há um erro ou exceção.                                                  |
| `serviceTransactionId`              | string  | Identificador de transação associado à solicitação processada pela API.                                                                              |
| `civilDataValidation`               | array   | Array que representa as validações OCR contra os dados obtidos do Registro Civil. Sua presença depende do Registro Civil consultado.                 |
| `civilDataValidation[].field`       | string  | Nome do campo validado (ex. `firstName`, `lastName`, `dateOfBirth`).                                                                                 |
| `civilDataValidation[].code`        | string  | Código de resultado da validação. `"0"`: Validado corretamente. `"-99"`: Possivelmente adulterado.                                                   |
| `civilDataValidation[].message`     | string  | Mensagem descritiva do resultado da validação.                                                                                                       |
| `serviceFacialAuthenticationResult` | integer | Código que indica o resultado da correspondência facial. Ver [Resultado de Authentication Facial do Serviço](#service-facial-authentication-result). |
| `serviceFacialSimilarityResult`     | number  | Valor que indica a semelhança facial entre o rosto na foto do documento e a selfie do usuário. **1.0 = 100%**.                                       |
| `serviceFacialAuthenticationHash`   | string  | Hash de integridade do Template Biométrico utilizado em uma autenticação facial positiva ou incerta.                                                 |

#### Exemplo de resposta

```json
{
  "serviceResultCode": 0,
  "serviceTime": "2800",
  "serviceResultLog": "Serviço executado com sucesso",
  "serviceTransactionId": "24681357-2468-1357-9024-246813579024",
  "civilDataValidation": [
    {
      "field": "firstName",
      "code": "-99",
      "message": "Possivelmente adulterado"
    },
    {
      "field": "lastName",
      "code": "0",
      "message": "Validado com sucesso"
    },
    {
      "field": "dateOfBirth",
      "code": "0",
      "message": "Validado com sucesso"
    }
  ],
  "serviceFacialAuthenticationResult": 3,
  "serviceFacialSimilarityResult": 0.94,
  "serviceFacialAuthenticationHash": "NA"
}
```

## Validação Facial Web

Realiza a correspondência facial com as imagens oficiais do Registro Civil de Honduras usando plataforma web. Não inclui validação de dados.

### Corpo da solicitação

**Content-Type:** `application/json`

#### Parâmetros

| Parâmetro              | Tipo   | Obrigatório | Descrição                                                                                      |
| ---------------------- | ------ | ----------- | ---------------------------------------------------------------------------------------------- |
| `operation`            | string | **Sim**     | Operação de validação a ser realizada. Valor: `"FACIAL"`.                                      |
| `platform`             | string | **Sim**     | Plataforma a partir da qual a solicitação é realizada. Valor: `"WEB"`.                         |
| `templateRaw`          | string | **Sim**     | Template Biométrico gerado pelo Widget Selphi. Necessário para operações FACIAL ou FULL.       |
| `documentNumber`       | string | Não         | Número do documento do usuário. Requerido para operações FACIAL em Honduras.                   |
| `countryCode`          | string | **Sim**     | Código de país no formato ISO 3166-1 alfa-3. Valor: `"HND"`.                                   |
| `tracking`             | object | Não         | Objeto que representa as informações de Tracking necessárias.                                  |
| `tracking.extraData`   | string | Não         | Token gerado pelo SDK Mobile/Web. Contém informações de Tracking tokenizadas com a Plataforma. |
| `tracking.operationId` | string | Não         | Identificador de operação gerado pelo SDK Mobile/Web.                                          |

#### Exemplo de solicitação

```json
{
  "operation": "FACIAL",
  "platform": "WEB",
  "templateRaw": "base64TemplateRawString",
  "documentNumber": "205990558",
  "countryCode": "HND",
  "tracking": {
    "extraData": "BQABAQG2gBNjuHN...",
    "operationId": "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx"
  }
}
```

### Respostas

#### `200` Sucesso

#### Parâmetros de resposta

| Parâmetro                           | Tipo    | Descrição                                                                                                                                            |
| ----------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `serviceResultCode`                 | integer | Código que indica o resultado geral da execução do serviço. Ver [Código de Resultado do Serviço](#service-result-code).                              |
| `serviceTime`                       | string  | Tempo total de processamento (milissegundos).                                                                                                        |
| `serviceResultLog`                  | string  | Campo descritivo do resultado da execução do serviço. Inclui detalhes quando há um erro ou exceção.                                                  |
| `serviceTransactionId`              | string  | Identificador de transação associado à solicitação processada pela API.                                                                              |
| `civilDataValidation`               | array   | Array que representa as validações OCR contra os dados obtidos do Registro Civil. Sua presença depende do Registro Civil consultado.                 |
| `civilDataValidation[].field`       | string  | Nome do campo validado (ex. `firstName`, `lastName`, `dateOfBirth`).                                                                                 |
| `civilDataValidation[].code`        | string  | Código de resultado da validação. `"0"`: Validado corretamente. `"-99"`: Possivelmente adulterado.                                                   |
| `civilDataValidation[].message`     | string  | Mensagem descritiva do resultado da validação.                                                                                                       |
| `serviceFacialAuthenticationResult` | integer | Código que indica o resultado da correspondência facial. Ver [Resultado de Authentication Facial do Serviço](#service-facial-authentication-result). |
| `serviceFacialSimilarityResult`     | number  | Valor que indica a semelhança facial entre o rosto na foto do documento e a selfie do usuário. **1.0 = 100%**.                                       |
| `serviceFacialAuthenticationHash`   | string  | Hash de integridade do Template Biométrico utilizado em uma autenticação facial positiva ou incerta.                                                 |

#### Exemplo de resposta

```json
{
  "serviceResultCode": 0,
  "serviceTime": "3200",
  "serviceResultLog": "Serviço executado com sucesso",
  "serviceTransactionId": "87654321-4321-4321-4321-210987654321",
  "civilDataValidation": [
    {
      "field": "firstName",
      "code": "-99",
      "message": "Possivelmente adulterado"
    },
    {
      "field": "lastName",
      "code": "0",
      "message": "Validado com sucesso"
    },
    {
      "field": "dateOfBirth",
      "code": "0",
      "message": "Validado com sucesso"
    }
  ],
  "serviceFacialAuthenticationResult": 1,
  "serviceFacialSimilarityResult": 0.15,
  "serviceFacialAuthenticationHash": "NA"
}
```

## Tabelas de referência

#### Código de Resultado do Serviço

O `serviceResultCode` indica o resultado geral da execução do serviço:

| serviceResultCode | Descrição                                                                              | Código HTTP |
| ----------------- | -------------------------------------------------------------------------------------- | ----------- |
| 0                 | A execução do serviço foi bem-sucedida, o módulo processou a solicitação corretamente. | 200         |

#### Resultado de Authentication Facial do Serviço

O `serviceFacialAuthenticationResult` indica o resultado das operações de correspondência facial (somente para operações FULL e FACIAL):

| Código | Resultado                        | Descrição                                                                                                                                                                                    |
| ------ | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 0      | NONE                             | Não foi possível realizar a verificação facial.                                                                                                                                              |
| 1      | NEGATIVE                         | O processo foi executado corretamente. A comparação do padrão facial dos rostos não corresponde.                                                                                             |
| 3      | POSITIVE                         | O processo foi executado corretamente. A comparação do padrão facial dos rostos é positiva. O valor de `serviceFacialSimilarityResult` indica o % de semelhança entre as imagens comparadas. |
| 4      | NONE BECAUSE POSE EXCEED         | Não foi possível realizar a verificação facial devido à posição do rosto.                                                                                                                    |
| 5      | NONE BECAUSE INVALID EXTRACTIONS | Não foi possível realizar a verificação facial devido a problemas na extração do padrão facial.                                                                                              |

## Erros comuns

#### `400` Requisição inválida

```json
{
  "status": 400,
  "title": "Bad Request",
  "detail": "Invalid request.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": []
}
```

#### `401` Não autorizado

```json
{
  "message": "Unauthorized"
}
```

#### `403` Proibido

```json
{
  "Message": "User is not authorized to access this resource with an explicit deny"
}
```

#### `502` Gateway inválido

```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"
}
```