Sincronização sem documento

Requisitos de autenticação:

• Endpoints regulares usam OAuth2 autenticação com URL base: https://api.us.prd.caf.io
• Para maior segurança, alguns endpoints também podem suportar mTLS autenticação com URL base: https://mtls.us.prd.caf.io
• Para informações sobre a implementação de mTLS, acesse Usando mTLS

Guia do produto

Esta seção fornece documentação para o Doc Less serviço.

Doc Less é uma solução projetada para otimizar o processo de onboarding do usuário por meio da reutilização de documentos já armazenados em nosso banco de dados.

Ao fazer isso, elimina a necessidade de solicitar os mesmos documentos novamente, tornando o processo de onboarding mais rápido, mais eficiente, e aumentando as taxas de conversão.

Benefícios

• Maiores taxas de conversão: Acelera o onboarding ao reutilizar documentos existentes.
• Maior eficiência operacional: Elimina etapas repetitivas e reduz o esforço do usuário.
• Flexibilidade para o cliente: Permite que os clientes definam o nível de validação de documentos com base em seu apetite a risco.

Como funciona

O Doc Less consulta um banco de dados centralizado de documentos armazenados anteriormente.

Durante o processo de onboarding, o serviço verifica se os documentos do usuário já existem no banco de dados, evitando a necessidade de nova captura de documentos.

Opções de uso

O Doc Less está disponível em dois modos:

• Onboarding web: Integrado ao fluxo padrão de onboarding da Certta.
• Fluxo de API: Ideal para clientes que usam integração direta por meio do SDK de Captura de Documentos da Certta.

Processo de ativação

1. Validação do contrato: Certifique-se de que seu contrato inclua permissão para usar o Doc Less.
2. Ativação pela Certta: Nossa equipe técnica ativará a funcionalidade para sua conta.

Requisitos

• Para o fluxo de API, é obrigatório informar o CPF do usuário (número de identificação brasileiro), juntamente com a confirmação de aceite dos termos de uso e da política de privacidade, para recuperar a referência do documento.

Referência do documento

A referência do documento é um hash criptografado que serve como identificador único para localizar o documento correspondente no banco de dados.

O documento só será disponibilizado após uma transação válida ser criada no sistema da Certta. Esses mecanismos garantem tanto a reutilização eficiente de dados quanto a conformidade com as regulamentações de privacidade vigentes.

Guia do fluxo de API

Este guia descreve as três etapas principais para integrar o Doc Less serviço via API.

1. Inserção dos Termos de Uso e da Política de Privacidade da Certta

Para usar o produto Doc Less da Certta, é obrigatório incluir os Termos de Uso e a Política de Privacidade da Certta no fluxo de onboarding do usuário.

O aceite do usuário aos Termos e à Política de Privacidade da Certta deve ser devidamente registrado, incluindo logs como endereço IP, data, hora e as URLs dos documentos aceitos. Esses registros e evidências devem ser compartilhados com a Certta. Essa medida garante conformidade legal e segurança regulatória no uso do serviço.

Exemplo recomendado

"Ao continuar, você reconhece e concorda que seus dados pessoais serão tratados pela Certta de acordo com os Termos de Uso e a Política de Privacidade."

2. Obtenção da referência do documento

Depois de obter seu token de acesso, você pode solicitar uma referência do documento para reutilização.

Fornecemos um serviço que verifica se os documentos do usuário já existem em nosso banco de dados centralizado. Se uma correspondência for encontrada, a resposta incluirá a documentRef — uma string hash que referencia o documento armazenado.

Doc Less command

post

https://api.us.prd.caf.io/v1/doc-lesshttps://mtls.us.prd.caf.io/v1/doc-less

/

This endpoint allows clients to obtain the document reference. The request has a timeout of 5 seconds. \ Permission required: Create Doc-less

Autorizações

bearerAuth

AuthorizationstringObrigatório

JWT Authorization header using the Bearer scheme.

Corpo

application/json

personIdstringObrigatório

Unique identifier of the user to be consulted.

Respostas

200

Success

application/json

requestIdstringOpcional

Unique identifier for the request.

statusstring · enumOpcional

Indicates whether the document was found or not.

Valores possíveis:

documentTypestring · enumOpcional

Type of document identified by the query.

Valores possíveis:

documentRefstringOpcional

400

Bad Request

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

post/

HTTPcURLJavaScriptPython

POST /v1/doc-less/ HTTP/1.1
Host: api.us.prd.caf.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "personId": "text",
  "acceptedTerms": {
    "userIp": "text",
    "datetime": "text",
    "acceptedTermsLinks": [
      "text"
    ]
  }
}

{
  "requestId": "text",
  "status": "FOUND",
  "documentType": "IDENTITY_CARD",
  "documentRef": "text"
}

3. Reutilização da referência do documento

Se a resposta da etapa anterior for bem-sucedida e o status for "FOUND", o documentRef atributo será retornado.

Com essa referência em mãos, você pode prosseguir para criar uma transação no fluxo de processamento da Certta.

Para reutilizar o documento, passe a documentRef no files array ao criar uma transação com o tipo definido como "DOCUMENT_REF":

{
    ...
    "files": [
      "data": "<valor de documentRef>",
      "type": "DOCUMENT_REF"
    ]
}

Você pode encontrar a documentação completa sobre como criar uma transação clicando aqui.