Verificar

Serviço que valida a identidade do usuário e gera um token de verificação para a integração com Previred.

Este serviço valida todos os resultados do onboarding e gera um token seguro que é utilizado para construir a URL de verificação compartilhada com o Previred.

Pré-requisitos

Antes de chamar este serviço, deve-se garantir que o usuário tenha concluído o processo de Onboarding com resultados válidos:

• facialAuthenticationResult = 3 (Autenticação facial bem-sucedida)

• passiveLivenessResult = 3 (Teste de vida superado)

• documentValidation = 9001 (Validação documental aprovada)

Endpoint

POST /services/previred/{serviceTransactionId}/verify

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
x-api-key	string	Sim	API Key de autorização de acesso.

Parâmetros de rota

Parâmetro	Tipo	Obrigatório	Descrição
serviceTransactionId	string	Sim	Identificador único de transação para o processo de transferência.

Corpo da solicitação

Content-Type: application/json

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
scanReference	string	Sim	Identificador de referência do processo de Onboarding que contém os resultados de validação de identidade.

Exemplo de solicitação

{
  "scanReference": "550e8400-e29b-41d4-a716-446655440000"
}

Respostas

200 Sucesso

Parâmetros de resposta

Parâmetro	Tipo	Descrição
token	string	Token de verificação para construir a URL de verificação compartilhada com o Previred.

Exemplo de resposta

{
  "token": "MUOJHSYODkRtgVENLbXXXpujiDHqGTYS"
}

Armazenar o token de forma segura, pois ele é necessário nas próximas etapas.

400 Bad Request

{
  "status": 400,
  "title": "Requisição inválida",
  "detail": "Solicitação inválida.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": []
}

401 Não autorizado

{
  "message": "Não autorizado"
}

403 Proibido

{
  "Message": "O usuário não está autorizado a acessar este recurso com uma negação explícita"
}

404 Não encontrado

{
  "status": 404,
  "title": "Não encontrado",
  "detail": "Recurso não encontrado.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404"
}

502 Bad Gateway

{
  "status": 502,
  "title": "Gateway inválido",
  "detail": "O servidor recebeu uma resposta inválida.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502"
}

504 Gateway Timeout

{
  "message": "A requisição do Endpoint excedeu o tempo limite"
}

---

Envio de evidência de verificação ao Previred

Uma vez obtido o token, a AFP deve enviar a url_verificacion ao Previred como prova de validação.

Formato da URL de verificação

{host}/services/previred/{serviceTransactionId}/certificate?token={token}&apiKey={previredApiKey}

O apiKeyPrevired é acompanhado de username e password para autenticação.

Chamada ao Previred - Solicitação de Token

POST {baseUrlPrevired}/tvi/solicitudTokenWS

Headers:

Nome	Tipo	Obrigatório	Descrição
Content-Type	string	Sim	application/json
Authorization	string	Sim	Basic {authToken}

Exemplo de solicitação:

{
  "afiliado": {
    "nombre": "{nombre_afiliado}",
    "apellido_paterno": "{apellido_paterno_afiliado}",
    "apellido_materno": "{apellido_materno_afiliado}",
    "rut_numero": "{rut_numero_afiliado}",
    "dv": "{dv_afiliado}",
    "verificacion": {
      "identificacion_proveedor": "{identificacion_proveedor}",
      "fecha_verificacion": "{fecha_verificacion}",
      "url_verificacion": "{host}/services/previred/{serviceTransactionId}/certificate?token={token}&apiKey={previredApiKey}",
      "url_usuario": "{username}",
      "url_clave": "{password}",
      "tipo_verificacion": "{tipo_verificacion}",
      "codigo_verificacion": "{codigo_verificacion}"
    }
  },
  "codigo_institucion": "{codigo_institucion}",
  "requiere_segunda_verificacion": false
}

O campo codigo_verificacion deve cumprir as restrições do Previred, por isso é gerado a partir do serviceTransactionId em formato Base64 URL-safe. Para mais detalhes, consulte a seção Formato de UUID para Previred.

Exemplo de resposta:

{
  "respuesta": {
    "codigo": 200,
    "mensaje": "Ticket gerado com sucesso",
    "ticket_tvi": "17416257523259999232077343926588:...",
    "fecha": "20250310 135552",
    "errores": []
  }
}

Chamada ao Previred - Obter Token

POST {baseUrlPrevired}/tvi/obtenerTokenWS

Exemplo de solicitação:

{
  "codigo_institucion": "9999",
  "ticket_tvi": "{ticket_tvi}"
}

Exemplo de resposta:

{
  "respuesta": {
    "codigo": 200,
    "mensaje": "OK",
    "token": "2N/BNwHs6kMlVKKEPsFi6fpPjf5I/x0X+IFKFk/EhWZn3vQIvY4FQbORNpzPpOFsO7Gp/jiiCzhE5EnLgjSTUg==",
    "fecha": "20250310 135555",
    "errores": []
  }
}

---

Formato de UUID para Previred

Previred impõe um limite de 30 caracteres em codigo_verificacion. Os UUID (36 caracteres) são transformados em Base64 URL-safe sem padding.

Conversão de UUID para Base64 URL-safe

Exemplo:

UUID original	UUID convertido
3994d0f4-77c2-4079-8fd3-ccd14e90f909	OTlEbw93wkCeNMzNF5D5CQ

Implementação em Go:

import (
    "encoding/base64"
    "github.com/google/uuid"
)

func ShortID(ID string) string {
    tID := uuid.MustParse(ID)
    marshalled, _ := tID.MarshalBinary()
    return base64.RawURLEncoding.EncodeToString(marshalled)
}

Este método garante unicidade e conformidade com o Previred. Deve ser aplicado de forma consistente.