Sincronização sem documentos

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 Caf.
• Fluxo de API: Ideal para clientes que utilizam integração direta por meio do SDK de Captura de Documentos da Caf.

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 Caf: 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 é criado no sistema da Caf. Esses mecanismos garantem tanto o reaproveitamento 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 Caf

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

A aceitação dos Termos e da Política de Privacidade da Caf pelo usuário deve ser devidamente registrada, incluindo logs como endereço IP, data, hora e as URLs dos documentos aceitos. Esses registros e evidências devem ser compartilhados com a Caf. 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 processados pela Caf de acordo com a 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

This endpoint allows clients to obtain the document reference. The request has a timeout of 5 seconds.

Autorizações

AuthorizationstringObrigatório

JWT Authorization header using the Bearer scheme.

Corpo

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/

POST /v1/doc-less/ HTTP/1.1
Host: api.combateafraude.com
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 Caf.

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.