Skip to main content
POST
/
api
/
v1
/
onboarding
/
enroll
/
json
Nova análise de cadastro (JSON)
curl --request POST \
  --url https://flex-hml.flexdoc-apis.com.br/services/api/v1/onboarding/enroll/json \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cpf": 12345678900,
  "customerId": "flexdoc",
  "imageFront": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "email": "[email protected]",
  "phone": 11991234567,
  "zipCode": "01000000",
  "imageBack": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "imageSelfie": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "callBackUrl": "https://seusistema.com/webhook",
  "basicAuth": "usuario:senha"
}
'
{
  "onboardingId": "onb-123456",
  "cpf": 12345678900,
  "customerId": "flexdoc",
  "status": "STARTED",
  "statusReason": "Documentos ilegíveis",
  "faceMatch": {
    "similarity": 92.5,
    "match": true
  },
  "basicData": {
    "useTerms": true,
    "acceptedTermVersion": 1,
    "firstName": "João",
    "fullName": "João da Silva",
    "cep": "01000000",
    "city": "São Paulo",
    "state": "SP",
    "email": "[email protected]",
    "emailToken": "abc123def456",
    "emailConfirmed": false,
    "emailTokenExpiresAt": "2025-05-01T12:00:00",
    "cellphone": 67991234567,
    "smsToken": 7891011,
    "tokenConfirmed": false,
    "smsTokenExpiresAt": "2025-05-01T12:00:00"
  },
  "scoreData": {
    "cpf": 12345678901,
    "customerId": "CUST_123456",
    "score": 85,
    "hardStop": false,
    "penalties": [
      {
        "rulesName": "RULE_01",
        "rulesPenalty": 15,
        "hardStop": false,
        "message": "CNH com menos de 2 meses para vencer"
      }
    ],
    "statistics": {
      "batchId": 12345,
      "methodName": "analyzeDocument",
      "totalTime": 1500
    }
  },
  "ocrData": {
    "typeRecognized": "rg",
    "typeParentAlias": "di",
    "digitalDocument": true,
    "fields": [
      {
        "key": "nome",
        "value": "João da Silva",
        "conf": 0.95,
        "bbox": [
          12,
          34,
          56,
          78
        ],
        "fields": "<unknown>"
      }
    ],
    "errorMessage": "Falha ao processar imagem: formato inválido"
  }
}

Authorizations

​
Authorization
string
header
required

Autentica o acesso a partir de usuário e senha e retorna o Bearer token JWT. Copie o access_token retornado e utilize-o no header Authorization para acessar os endpoints da API.

Body

application/json

Payload para cadastro de onboarding, contendo dados pessoais, documentos codificados e configurações de callback.

Payload para cadastro de onboarding, contendo dados pessoais, documentos codificados e configurações de callback.

​
cpf
string
required

CPF (somente números).

Example:

12345678900

​
customerId
string
required

Identificador do cliente no sistema.

Example:

"flexdoc"

​
imageFront
file
required

Frente do documento, frente/verso unificados ou PDF (PDF, JPG ou PNG).

Example:

"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."

​
email
string

E-mail.

Example:

"[email protected]"

​
phone
string

Telefone (somente números)

Example:

11991234567

​
zipCode
string

CEP (somente números).

Example:

"01000000"

​
imageBack
file

Verso do documento (PDF, JPG ou PNG).

Example:

"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."

​
imageSelfie
file

Selfie (PDF, JPG ou PNG).

Example:

"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."

​
callBackUrl
string

URL de callback (WebHook).

Example:

"https://seusistema.com/webhook"

​
basicAuth
string

Basic Authorization (WebHook).

Example:

"usuario:senha"

Response

Onboarding concluído com sucesso.

Resultado do processo de onboarding, incluindo identificadores e dados de validação.

​
onboardingId
string

Identificador único do processo de onboarding.

Example:

"onb-123456"

​
cpf
string

CPF da pessoa.

Example:

12345678900

​
customerId
string

Identificador do cliente no sistema.

Example:

"flexdoc"

​
status
enum<string>

Status atual do onboarding.

Available options:
STARTED,
PENDING,
PROCESSING,
ANALYSIS,
DONE,
REJECTED,
CANCELED,
ERROR,
BLACKLISTED,
RESOLVED
Example:

"STARTED"

​
statusReason
string

Motivo do status, em caso de falha ou bloqueio.

Example:

"Documentos ilegíveis"

​
faceMatch
object

Resultado da comparação facial, contendo o nível de similaridade e o indicador de correspondência.

​
basicData
object

Dados básicos do usuário extraídos durante o processo de onboarding.

​
scoreData
object

Resultado da análise de score do processo de onboarding, incluindo penalidades e estatísticas.

​
ocrData
object

Resultado da extração OCR, contendo tipos, campos extraídos, estatísticas e eventual mensagem de erro.