O que são atributos?

Os atributos desempenham a função de localizar um workflowadequado 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 protected]",
                "[email protected]"
             ]
          },
          "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

PropriedadeTipoDescrição
idstringId que identifica o serviço do cliente. Exemplo: financiamento de veículos.
namestringNome do serviço.
(category) idstringTipo da categoria do serviço, por exemplo: FINC (seguros; solicitações de crédito); CRED; RU.
(category) namestringNome da categoria, por exemplo: para FINC = Financeira; para CRED = Crédito; RU = Rural.

Object person

PropriedadeTipoDescrição
typestringPessoa Física ou Jurídica (PF, PJ).
idstringNúmero do Identificador da pessoa (CPF, RG).
aliasstringApelido da pessoa.
birthdatedateData de Nascimento (pattern: yyyy-MM-dd).
profilestringO 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) typestringTipo do documento (CNH, CPF, DNI, RNE, OAB, CIN ou outros documentos).

contact.phones (array)

PropriedadeTipoDescrição
typestringTipo do telefone(fixo, celular).
countryCodestringDDI (Brasil: +55).
areaCodestringDDD (São Paulo: 11).
numberstringNúmero do telefone (11956854485).

emails (array)

PropriedadeTipoDescrição
emailsstringE-mails do usuário.

addresses (array)

PropriedadeTipoDescrição
addressstringEndereço (Rua, Av.).
citystringNome da cidade.
statestringEstado.
countrystringPaís.
zipcodestringCódigo postal (CEP).

Object transaction

PropriedadeTipoDescrição
idstringIdentificador da transação.
datedatetimeData da transação (pattern: yyyy-MM-dd HH:mm:ss).
amountstringValor da transação.
currency (array)stringNome da moeda da transação (R$, USD).
paymentTypes (array)stringTipo de pagamentos. Exemplo: crédito, débito, PIX, boleto.
channelstringCanal de negócio do cliente. Exemplo: vendas, telemarketing, venda direta.
operatorstringFuncionário do cliente.
campaignstringCampanha de marketing que gerou a transação. Exemplo: Dia dos Pais, Dia das Crianças.
clientIpAddressstringIP do dispositivo.
products (array)stringProdutos do cliente. Exemplo: gift card, playstation, macbook, iPhone (product1, product2).
categories (array)stringCategoria de produtos do cliente. Exemplo: gift card, playstation, macbook, iPhone (category1, category2).

Object geolocation

PropriedadeTipoDescrição
typestringTipo de localização.
coordinates (array)numberGeolocalização capturada do dispositivo.

Object phone

PropriedadeTipoDescrição
typestringTipo do telefone (fixo, celular).
areaCodestringDDI (Brasil: +55).
countryCodestringDDD (São Paulo: 11).
numberstringNúmero do telefone (56956854485).

Object assessment

PropriedadeTipoDescrição
taxIdStatusstringStatus do CPF na Receita.
hasObitValidationConfirmedstringTem óbito confirmado no cadastro.
hasLivenessValidationConfirmedstringTem confirmação de Prova de Vida pelo cliente.
hasDocumentValidationConfirmedstringTem documento validado pelo cliente.
hasUnderAgeValidationConfirmedstringTem confirmação de menor de idade.