Criar uma nova transação

Na Transação são enviados os dados do consumidor que o cliente deseja consultar nos módulos da Plataforma Data Trust.

📘

Endereço dos nossos serviços:

Homologação: POST https://datatrustapihml.clearsale.com.br/v1/transaction/
Produção: POST https://datatrustapi.clearsale.com.br/v1/transaction/

Acesse aqui a documentação técnica

Para criar uma transação na Plataforma Data Trust, utilize o token gerado anteriormente.

A criação de uma transação é necessária para que seja gerado um ID único, chamado de Transaction Id, vinculado aos dados do cliente a ser consultado nos módulos da Plataforma Data Trust.

A resposta da chamada da Transação agregará o campo “Id”, comumente chamado de Transaction Id, que deve ser utilizado em todas as chamadas dos endpoints dos módulos em que deseja obter os resultados relacionados aos dados do cliente enviados na transação.

Campos Genéricos (genericFields)

A inclusão de campos genéricos foi pensada para que o cliente possa inserir nas mensagens de texto de 2FA (Disponível para uso nos textos das mensagens 2FA SMS e WhatsApp), variáveis que somente a empresa cliente tem acesso aos dados e que façam sentido para o entendimento do contexto da mensagem pelo seu cliente / consumidor.

Para o envio de campos genéricos para uso na mensagem de 2FA é necessário alinhamento prévio, para que então o campo passe a ser considerado no envio da transação.

Uma vez que os campos estejam mapeados, é possível adicionar uma máscara para validar o dado enviado, como por exemplo enviar somente letras, enviar uma data, um valor monetário, etc.

Se você tem interesse em enviar campos genéricos na mensagem de 2FA entre em contato com o [email protected]

Dicionário de Variáveis de Entrada

Apenas o CPF é obrigatório na criação de uma Transação, porém, conforme o módulo a ser chamado posteriormente, outros parâmetros de entrada podem tornar-se imprescindíveis para a correta e assertiva resposta do módulo.

Parâmetro

Descrição

Tipo

Tamanho

Obrigatório

DocumentType

Tipo do documento do cliente (CPF ou CNPJ*)

String

3

Sim

Document

Documento do cliente (Sem pontuação)

String

11

Sim

Name

Nome completo do cliente (Sem abreviação)

String

300

Não

Birthdate

Data de nascimento do cliente [YYYY-MM-DD]

String

10

Não

Email

Email do cliente

String

100

Não

MothersName

Nome completo da mãe (Sem abreviação)

String

300

Não

VerifiedEmail

Flag de Email verificado

Boolean


Não

SessionID

Chave do device do cliente

String

200

Não

Address

Objeto com informações do endereço do cliente

Address


Não

Phone

Objeto com informações do número de telefone (fixo ou celular) do cliente

Phone


Não

ReferenceDate

Data de referência da transação

DateTime


Não

Type

Tipo da transação
(1- Presencial; 2- Online)

Int

1

Não

ChannelId

Chave da subentidade

Int


Não

IdentifierId

ID interno controlado pelo cliente

String

100

Não

IdentifierDate

Data de identificação da transação

DateTime


Não

GenericFields

Campos Genéricos previamente configurados

String


Não

Criterion

ID com o critério para geração do módulo de credit pro

Int


Não

Card

Informações do cartão associados a transação

Card


Não

SecondaryDocumentType

Tipo do documento secundário associado a transação (CPF ou CNPJ)

String

4

Não

SecondaryDocument

Documento secundário (Sem pontuação)

String

14

Não

Vehicle

Forneça os dados do veículo e os detalhes da proposta de financiamento

Vehicle


Não

Image

Informações da selfie e documentos para validações biométricas (Disponível apenas no Pack Sync) clique aqui para mais informações

Image


Não

Address

NomeDescriçãoTipoTamanhoObrigatório
ZipCodeCódigo Postal do endereço do clienteString8Não
StreetEndereço do clienteString200Não
NumberNúmero do endereço do clienteString15Não
ComplementComplemento do endereço do clienteString150Não
DistrictDistrito do endereço do clienteString150Não
CityCidade do clienteString150Não
StateEstado do clienteString2Não
CountryPaís do clienteString150Não

Phone

Nome

Descrição

Tipo

Tamanho

Obrigatório

CountryCode

Código de país do número de telefone celular do cliente

Int

3

Sim

AreaCode

Código de área do número de telefone celular do cliente - DDD

Int

2

Sim

Number

Número de telefone celular do cliente

Int

9

Sim

Verified

Flag de número de telefone celular verificado

Bolean


Não

Card

NomeDescriçãoTipoTamanhoObrigatório
Bin6 ou 8 primeiros dígitos do cartãoString6Sim
Last44 últimos dígitos do cartãoString4Sim
OwnerDocumentDocument (CPF) do dono do cartãoString11Não
OwnerNameNome do dono do cartãoString300Não

Vehicle

Nome

Descrição

Tipo

Tamanho

Obrigatório

ProposedDate

Menor ou igual à data atual, maior ou igual a 2000-01-01

DateTime


Não

VehicleLicensePlate

Não vazio, ter 7 caracteres, formato válido de placa(AAA1111 ou AAA1A11)

String

7

Sim

StoreState

Duas letras maiúsculas ou minúsculas

String

2

Não

LicensePlateState

Duas letras maiúsculas ou minúsculas

String

2

Não

VehicleRegistrationState

Duas letras maiúsculas ou minúsculas

String

2

Não

VehicleRegistrationState

Exatamente duas letras maiúsculas ou minúsculas

String

2

Não

FinancingAmount

Valor deve ser > 0 e estar em um formato monetário válido (9999999999.99). Valores com mais de duas casas decimais serão arredondados.

double

12

Sim

MarketValue

Valor deve ser ≥ 0 e estar em um formato monetário válido (9999999999.99). Valores com mais de duas casas decimais serão arredondados.

double

12

Não

VehicleManufacturingYear

Entre 1900 e o ano atual

Int


Não

*Para a consulta de CNPJ, apenas os módulos de score e insights estão disponíveis