O que são atributos?

Os atributos desempenham a função de localizar um **workflow**adequado com base nos dados da transação do usuário. Portanto, com base neste perfil, o sistema retorna um workflow que assegura maior segurança para o usuário.

É possível executar um ou mais serviços dentro do mesmo workflow o, tais como: Serpro, Bureau, FaceToken, Prova de Vida, Análise de Documentos e FaceMatch.

Exemplo:

{
  "attrs": {
    "products": "iPhone",
    "document": {
      "type": "CNH"
    },
    "transaction": {
      "amount": "6000",
      "paymentTypes": "PIX"
    },
    "person": {
      "type": "PJ"
    }
  }
}

Cada perfil de usuário é encaminhado para um workflow específico de validação, um workflow personalizado que a Oiti estabelece com base nas configurações solicitadas pelos clientes.

Exemplo de request:

{
    "attrs":{
       "service":{
          "id":"value", // Id que identifica o serviço do cliente. Ex: Financiamento de Veículos (String)
          "name":"value",
          "category":{
             "id":"value",// Finaceira / Seguros / Solicitação de Crédito (String)
             "name":"value"
          }
       },
       "person":{
          "type":"value", // Pessoa Física ou Jurídica (Lista)
          "id":"value",
          "name":"value",
          "alias":"value",
          "birthdate":"date", // Data de Nascimento (date)
          "profile":"value", // O Usuário foi validado previamente pelo cliente que o classificou como Baixo Risco de Crédito ou Alto Risco de Crédito ou Alto Risco de Fraude (String)
          "document":{
             "type":"value" //CNH / CPF/ CIN/ DNI / RNE / OAB, etc. - Dependendo do documento enviado podemos criar um fluxo sem a Tyrrell, por exemplo. (Lista)
          },
          "contact":{
             "phones":[
                {
                   "type":"value",
                   "countryCode":"value",
                   "areaCode":"value",
                   "number":"value"
                }
             ],
             "emails":[
                "email@example.com",
                "email@example.com"
             ]
          },
          "addresses":[
             {
                "address":"value",
                "city":"value",
                "state":"value", 
                "country":"value", 
                "zipcode":"value"
             }
          ]
       },
       "transaction":{
          "id":"value",
          "date":"datetime", // Data da transação (date)
          "amount":"decimal", // Valor da transação (decimal)
          "currency":[ // Nome da moeda da transação (Lista)
             "R$",
             "USD"
          ],
          "paymentTypes":[ // Tipo de pagamentos. Ex: Crédito, Débito, PIX, Boleto (Lista)
             "creditCard",
             "debit"
          ],
          "channel":"value", // Canal de negócio do cliente. Ex: Vendas, Telemarketing, Venda Direta (String)
          "operator":"value",
          "campaign":"value", // Campanha de marketing que gerou a transação. Ex: Dia dos Pais, Dia das Crianças (String)
          "clientIpAddress":"value",
          "products":[ // Produtos do cliente. Caso seja um produto de risco ex: Gift Card Playstation, Macbook, iPhone (String)
             "product1",
             "product2"
          ],
          "categories":[ // Categoria de produtos do cliente. Ex: Gift Card, Eletrônicos, Celular (String)
             "category1",
             "category2"
          ]
       },
       "geoLocation":{
          "type": "value",
          "coordinates": [ 0, 0 ]  // Geolocalização capturada do dispositivo. 
       },
       "phone":{
          "type":"value",
          "areaCode":"value",
          "countryCode":"value",
          "number":"value"
       },
       "assessment":{
          "taxIdStatus":"value", // Status do CPF na Receita
          "hasObitValidationConfirmed":"value", // Tem óbito confirmado no cadastro
          "hasLivenessValidationConfirmed":"value", // Tem confirmação de Liveness pelo cliente
          "hasDocumentValidationConfirmed":"value", // Tem documento validado pelo cliente
          "hasUnderAgeValidationConfirmed":"value" // Tem confirmação de menor de idade
       },
       "custom":[
          {
             "field":"value",
             "data":"object"
          },
          {
             "field":"value",
             "data":"object"
          }
       ]
    }
 }

Abaixo, estão apresentados: as propriedades, os tipos e as descrições para cada parâmetro.

Object service

Propriedade	Tipo	Descrição
id	string	Id que identifica o serviço do cliente. Exemplo: financiamento de veículos.
name	string	Nome do serviço.
(category) id	string	Tipo da categoria do serviço, por exemplo: FINC (seguros; solicitações de crédito); CRED; RU.
(category) name	string	Nome da categoria, por exemplo: para FINC = Financeira; para CRED = Crédito; RU = Rural.

Object person

Propriedade	Tipo	Descrição
type	string	Pessoa Física ou Jurídica (PF, PJ).
id	string	Número do Identificador da pessoa (CPF, RG).
alias	string	Apelido da pessoa.
birthdate	date	Data de Nascimento (pattern: yyyy-MM-dd).
profile	string	O usuário foi validado previamente pelo cliente que o classificou como: baixo risco de crédito, alto risco de crédito, alto risco de fraude.
(document) type	string	Tipo do documento (CNH, CPF, DNI, RNE, OAB, CIN ou outros documentos).

contact.phones (array)

Propriedade	Tipo	Descrição
type	string	Tipo do telefone(fixo, celular).
countryCode	string	DDI (Brasil: +55).
areaCode	string	DDD (São Paulo: 11).
number	string	Número do telefone (11956854485).

emails (array)

Propriedade	Tipo	Descrição
emails	string	E-mails do usuário.

addresses (array)

Propriedade	Tipo	Descrição
address	string	Endereço (Rua, Av.).
city	string	Nome da cidade.
state	string	Estado.
country	string	País.
zipcode	string	Código postal (CEP).

Object transaction

Propriedade	Tipo	Descrição
id	string	Identificador da transação.
date	datetime	Data da transação (pattern: yyyy-MM-dd HH:mm:ss).
amount	string	Valor da transação.
currency (array)	string	Nome da moeda da transação (R$, USD).
paymentTypes (array)	string	Tipo de pagamentos. Exemplo: crédito, débito, PIX, boleto.
channel	string	Canal de negócio do cliente. Exemplo: vendas, telemarketing, venda direta.
operator	string	Funcionário do cliente.
campaign	string	Campanha de marketing que gerou a transação. Exemplo: Dia dos Pais, Dia das Crianças.
clientIpAddress	string	IP do dispositivo.
products (array)	string	Produtos do cliente. Exemplo: gift card, playstation, macbook, iPhone (product1, product2).
categories (array)	string	Categoria de produtos do cliente. Exemplo: gift card, playstation, macbook, iPhone (category1, category2).

Object geolocation

Propriedade	Tipo	Descrição
type	string	Tipo de localização.
coordinates (array)	number	Geolocalização capturada do dispositivo.

Object phone

Propriedade	Tipo	Descrição
type	string	Tipo do telefone (fixo, celular).
areaCode	string	DDI (Brasil: +55).
countryCode	string	DDD (São Paulo: 11).
number	string	Número do telefone (56956854485).

Object assessment

Propriedade	Tipo	Descrição
taxIdStatus	string	Status do CPF na Receita.
hasObitValidationConfirmed	string	Tem óbito confirmado no cadastro.
hasLivenessValidationConfirmed	string	Tem confirmação de Prova de Vida pelo cliente.
hasDocumentValidationConfirmed	string	Tem documento validado pelo cliente.
hasUnderAgeValidationConfirmed	string	Tem confirmação de menor de idade.