Saques
No momento em que um usuário efetuar um saque, os dados do saque deverão ser enviados para a QI Tech. Deste modo, será possível realizar uma análise do risco envolvido na operação, baseado naquele conjunto de dados.
Definição do Objeto de Saque
Request Body
{
"id": "082373263",
"amount": 12979,
"withdrawal_date": "2020-10-07T15:06:25-03:00",
"service_description": "SAQUE EM CAIXA 24H",
"source_account": {
"participant": "17315359",
"branch": "0000",
"account_number": "10442",
"account_digit": "6",
"account_type": "CACC",
"opening_date": "2020-01-15T18:00:00-03:00"
},
"client": {
"id": "182373263",
"type": "natural_person",
"document_number": "023.456.789-01",
"name": "John Payer",
"email": "john@payer.com",
"address": {
"street": "Av. Eng. Luis Carlos Berrini",
"number": "105",
"neighbourhood": "Brooklin",
"city": "São Paulo",
"uf": "SP",
"complement": "Cj 303",
"postal_code": "04501-140"
},
"phone": {
"international_dial_code": "55",
"area_code": "11",
"number": "998861708",
"type": "mobile"
},
"sales_channel": "inbound_sales",
"segment": "Personalité"
},
"terminal": {
"id": "1234566",
"latitude": -45.2753548,
"longitude": -15.24587,
"address": {
"street": "Av. Eng. Luis Carlos Berrini",
"number": "105",
"neighbourhood": "Brooklin",
"city": "São Paulo",
"uf": "SP",
"complement": "Cj 303",
"postal_code": "04501-140"
},
"type": "atm"
},
"authentication": {
"used_password": true,
"used_card": true,
"used_fingerprint": true,
"typed_account_number": false
}
}
Um saque deve ser enviado para a API antes de ser encaminhada para o sistema de processamento, a fim de realizar uma validação prévia de fraude.
O status do saque representa a decisão retornada pelo modelo sobre aquela conta. Os seguintes status são utilizados na flag analysis_status:
automatically_approved
automatically_reproved
Abaixo estão listados os significados de cada uma das decisões, devolvida na flag analysis_status:
status | descrição |
---|---|
automatically_approved | Recomenda-se que este saque seja aprovado. |
automatically_reproved | Recomenda-se que este saque seja reprovado. |
nome | tipo | descrição |
---|---|---|
id | string | Identificador do saque no sistema do cliente. É essencial que este número seja único para cada saque |
amount | inteiro | Valor do saque em centavos - conforme descrição da seção "Padrões". |
withdrawal_date | datetime | Data e hora da realização do saque - conforme descrição da seção "Padrões" |
source_account | account | Objeto que determina a conta de origem do recurso a ser sacado |
client | client | Objeto com os dados do cliente detentor da conta de origem |
terminal | terminal | Objeto com os dados do terminal onde o saque está sendo realizado |
authentication | authentication | Objeto com as informações de autenticação |
Objetos do Saque
Object Terminal
Request Body
{
"id": "1234566",
"latitude": -45.2753548,
"longitude": -15.24587,
"address": {
"street": "Av. Eng. Luis Carlos Berrini",
"number": "105",
"neighbourhood": "Brooklin",
"city": "São Paulo",
"uf": "SP",
"complement": "Cj 303",
"postal_code": "04501-140"
},
"type": "atm"
}
Objeto que representa o terminal que foi utilizado para o saque.
nome | tipo | descrição |
---|---|---|
id | string | Identificador do terminal no sistema do cliente |
latitude | number | Latitude, em graus, da localização do terminal |
longitude | number | Longitude, em graus, da localização do terminal |
address | address | Endereço do terminal |
type | enum | Tipo do terminal, possíveis valores: "atm", "counter" |