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
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. |