Detalhes do onboarding
Esse endpoint serve para exibir os detalhes das informações de um onboarding
Pré-requisitos
Para que seja possível utilizar este endpoint, é necessario que:
- O usuário esteja utilizando a Autenticação Gestão do Banco
Requisição (Request)
Requisição HTTP
GET https://sandbox.hiperbanco.com.br/dashboard/onboarding/{onboardingId}--request GET 'https://sandbox.hiperbanco.com.br/dashboard/onboarding/{onboardingId}' \
--header 'version: cutting-edge' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' Cabeçalhos (Headers)
| Nome | Propriedade | Descrição |
|---|---|---|
version | cutting-edge | Essa propriedade garante que o response da API seja retornado no formato JSON |
Authorization | Bearer token | Obrigatório. Token de autorização do tipo Bearer. |
Parâmetros da rota (Path)
| Nome | Tipo | Descrição |
|---|---|---|
onboardingId | path | Identificador do onboarding |
Corpo da requisição (Body)
Não é necessário enviar parâmetros no body desta requisição.
Resposta (Response)
O status code 200 indicará que a requisição foi feita com sucesso e trará um objeto contendo as informações das informações do onboarding.
Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:
Pessoa Fisica
| Campo | Tipo | Descrição |
|---|---|---|
id | string | Identificador do usuário |
birthDate | string | Data de nascimento |
dateNumberDocumentPhoto | string | Data da foto do documento numérico |
documentNumber | string | Número do documento |
documentNumberPhoto | string | Foto do número do documento |
email | string | E-mail do usuário |
motherName | string | Nome da mãe |
registerName | string | Nome de registro |
socialName | string | Nome social |
status | string | Status do onboarding |
reasons | string | Motivo do status |
hasBrazilianNationality | boolean | Indica nacionalidade brasileira |
phone | string | Telefone |
isPoliticallyExposedPerson | boolean | Indica se é PEP |
type_account | string | Tipo de conta |
retry_onboarding | number | Tentativas de onboarding |
declaredAnnualBilling | number | Faturamento anual declarado |
createdAt | string | Data de criação |
updatedAt | string | Data de atualização |
deletedAt | string | Data de exclusão |
passwordUpdatedAt | string | Data da última troca de senha |
isImported | boolean | Indica se foi importado |
occupation | string | Ocupação |
pep | string | Declaração de PEP |
assertedIncome | number | Renda declarada |
nationality | string | Nacionalidade |
gender | string | Gênero |
relationshipStatus | string | Estado civil |
education | string | Escolaridade |
documentType | string | Tipo de documento |
expirationDateForgotPassword | string | Expiração de recuperação de senha |
issuerEntity | string | Órgão emissor |
ccbPersonId | string | ID no CCB |
deviceFCMToken | string | Token FCM do dispositivo |
mfaSecret | string | Segredo MFA |
deviceModel | string | Modelo do dispositivo |
importStatus | string | Status de importação |
token[] | array | Lista de tokens do documento |
token[].id | string | ID do token |
token[].content | string | Conteúdo do token |
token[].fileName | string | Nome do arquivo |
token[].type | string | Tipo do token |
token[].analysisRequestCount | number | Contagem de análises |
token[].status | string | Status da análise |
token[].createdAt | string | Data de criação |
token[].updatedAt | string | Data de atualização |
token[].deletedAt | string | Data de exclusão |
address | object | Endereço do usuário |
address.id | string | ID do endereço |
address.zipCode | string | CEP |
address.addressLine | string | Logradouro |
address.buildingNumber | string | Número |
address.complement | string | Complemento |
address.neighborhood | string | Bairro |
address.city | string | Cidade |
address.state | string | Estado |
address.country | string | País |
address.createdAt | string | Data de criação |
address.updatedAt | string | Data de atualização |
address.deletedAt | string | Data de exclusão |
authBlocked[] | array | Registros de bloqueio de autenticação |
authBlocked[].id | string | Identificador do registro de bloqueio |
authBlocked[].correlationId | string | Identificador de correlação |
authBlocked[].type | string | Tipo de bloqueio |
authBlocked[].reason | string | Motivo do bloqueio |
authBlocked[].createdAt | string | Data de criação do registro |
authBlocked[].updatedAt | string | Data de atualização do registro |
authBlocked[].deletedAt | string | Data de exclusão do registro |
company[] | array | Empresas vinculadas |
pfOwner | object | Dono PF (se houver) |
pjCounterparts[] | array | Contrapartes PJ |
isBlocked | boolean | Indica se está bloqueado |
Pessoa Juridica
| Campo | Tipo | Descrição |
|---|---|---|
company | object | Dados da empresa |
company.id | string | ID da empresa |
company.documentNumber | string | Documento da empresa |
company.businessName | string | Razão social |
company.tradingName | string | Nome fantasia |
company.businessEmail | string | E-mail comercial |
company.businessType | string | Tipo empresarial |
company.businessSize | string | Porte da empresa |
company.cnaeCode | string | Código CNAE |
company.legalNature | string | Natureza jurídica |
company.declaredAnnualBilling | string | Faturamento anual declarado |
company.openingDate | string | Data de abertura |
company.phone | string | Telefone |
company.status | string | Status |
company.reasons | string | Motivos do status |
company.address | object | Endereço da empresa |
company.address.zipCode | string | CEP |
company.address.addressLine | string | Logradouro |
company.address.buildingNumber | string | Número |
company.address.complement | string | Complemento |
company.address.neighborhood | string | Bairro |
company.address.city | string | Cidade |
company.address.state | string | Estado |
company.address.country | string | País |
legalRepresentatives[] | array | Representantes legais |
legalRepresentatives[].id | string | ID do representante |
legalRepresentatives[].documentNumber | string | Documento |
legalRepresentatives[].registerName | string | Nome civil |
legalRepresentatives[].socialName | string | Nome social |
legalRepresentatives[].birthDate | string | Data de nascimento |
legalRepresentatives[].motherName | string | Nome da mãe |
legalRepresentatives[].email | string | |
legalRepresentatives[].phone | string | Telefone |
legalRepresentatives[].gender | string | Gênero |
legalRepresentatives[].declaredIncome | string | Renda declarada |
legalRepresentatives[].occupation | string | Ocupação |
legalRepresentatives[].address | object | Endereço do representante |
legalRepresentatives[].address.zipCode | string | CEP |
legalRepresentatives[].address.addressLine | string | Logradouro |
legalRepresentatives[].address.buildingNumber | string | Número |
legalRepresentatives[].address.complement | string | Complemento |
legalRepresentatives[].address.neighborhood | string | Bairro |
legalRepresentatives[].address.city | string | Cidade |
legalRepresentatives[].address.state | string | Estado |
legalRepresentatives[].address.country | string | País |
legalRepresentatives[].isPoliticallyExposedPerson | boolean | Indica se é PEP |
legalRepresentatives[].isAlsoOwner | boolean | Indica se também é sócio |
owners[] | array | Lista de sócios |
owners[].id | string | ID do sócio |
owners[].documentNumber | string | Documento |
owners[].email | string | |
owners[].participationPercentage | string | Percentual societário |
owners[].address | object | Endereço do sócio |
owners[].address.zipCode | string | CEP |
owners[].address.addressLine | string | Logradouro |
owners[].address.buildingNumber | string | Número |
owners[].address.complement | string | Complemento |
owners[].address.neighborhood | string | Bairro |
owners[].address.city | string | Cidade |
owners[].address.state | string | Estado |
owners[].address.country | string | País |
owners[].registerName | string | Nome civil |
owners[].socialName | string | Nome social |
owners[].birthDate | string | Data de nascimento |
owners[].motherName | string | Nome da mãe |
owners[].declaredIncome | string | Renda declarada |
owners[].occupation | string | Ocupação |
owners[].pep | object | Dados de PEP |
owners[].pep.level | boolean | Indica se é PEP |
documentation | object | Documentação da empresa |
documentation.articlesOfIncorporation | string | Contrato social |
documentation.lastContractChange | string | Última alteração contratual |
documentation.balanceSheet | string | Balanço patrimonial |
documentation.powerOfAttorney | string | Procuração |
isBlocked | boolean | Indica se está bloqueado |
{
"id": "eb302cfa-58b3-4cb4-88b3-74b2d54ddd6f",
"birthDate": "1997-09-04",
"dateNumberDocumentPhoto": "2023-02-22T00:00:00.000Z",
"documentNumber": "61354045041",
"documentNumberPhoto": "659681516",
"email": "[email protected]",
"motherName": "Isabela Patrícia Santos",
"registerName": "Patrícia Costa",
"socialName": "Patrícia Costa",
"status": "APPROVED",
"reasons": null,
"hasBrazilianNationality": true,
"phone": "5581916942256",
"isPoliticallyExposedPerson": false,
"type_account": "PF",
"retry_onboarding": 1,
"declaredAnnualBilling": null,
"createdAt": "2025-11-11T13:46:28.115Z",
"updatedAt": "2025-11-11T13:52:47.000Z",
"deletedAt": null,
"passwordUpdatedAt": null,
"isImported": false,
"occupation": "Administrador Iniciativa Privada",
"pep": "Não sou politicamente exposto.",
"assertedIncome": 53481.32,
"nationality": "Brasileiro",
"gender": "Feminino",
"relationshipStatus": "Solteiro",
"education": "NAO_ALFABETIZADO",
"documentType": "RG",
"expirationDateForgotPassword": null,
"issuerEntity": "SSP/BA",
"ccbPersonId": null,
"deviceFCMToken": null,
"mfaSecret": null,
"deviceModel": null,
"importStatus": null,
"token": [
{
"id": "2461192d-5563-4b9b-817c-cb8edb766e4e",
"content": "Ri0iPTqgiepDwJnk0UuoM3uJbna5rnkS",
"fileName": "212ba237-5906-4856-beb8-095edf2c3d14.jpg",
"type": "SELFIE",
"analysisRequestCount": 1,
"status": "NO_LIVENESS",
"createdAt": "2025-11-11T13:46:36.013Z",
"updatedAt": "2025-11-11T13:46:43.000Z",
"deletedAt": null
},
{
"id": "90705cf6-b999-420a-b81b-6e961998ca1a",
"content": "ZcNESnm30fVEcu8eeG01BgmecOM692CE",
"fileName": "12020ece-1a58-45dc-a8a5-4176c770e3dd.jpg",
"type": "FRONT",
"analysisRequestCount": 1,
"status": "UNMATCHED_DOCUMENT",
"createdAt": "2025-11-11T13:46:40.255Z",
"updatedAt": "2025-11-11T13:46:43.000Z",
"deletedAt": null
},
{
"id": "9d15b2ec-c4fe-4af3-b0bb-d9273a098269",
"content": "OvG9QnEl3Iutp3XHnMZEZhQ0ZOMZxXLo",
"fileName": "7561b2e8-be99-49b1-9cd8-666c8d3496bc.jpg",
"type": "BACK",
"analysisRequestCount": 1,
"status": "NO_INFO_FOUND",
"createdAt": "2025-11-11T13:46:43.832Z",
"updatedAt": "2025-11-11T13:46:44.000Z",
"deletedAt": null
}
],
"address": {
"id": "9f581c21-a5aa-4529-ae85-a25f7ef4b3cc",
"zipCode": "79002210",
"addressLine": "Rua Maracaju",
"buildingNumber": "877",
"complement": "Sala 78",
"neighborhood": "Centro",
"city": "Campo Grande",
"state": "MS",
"country": "BR",
"createdAt": "2025-11-11T13:46:28.098Z",
"updatedAt": "2025-11-11T13:46:28.098Z",
"deletedAt": null
},
"authBlocked": [
{
"id": "a7c3c35a-9816-4adc-b410-494859bc57c0",
"correlationId": "e08610bd-70fe-430c-a07e-4bd7899d0eb7",
"type": "FAILED_LOGIN_ATTEMPTS",
"reason": "Account blocked due to invalid login attempts.",
"createdAt": "2025-08-22T16:17:20.000Z",
"updatedAt": "2025-09-09T17:46:16.000Z",
"deletedAt": "2025-09-09T17:46:16.000Z"
},
{
"id": "a1edecda-b75e-4e0a-9d78-776ff2582eca",
"correlationId": "d2572241-9099-43d7-8a76-b88dfdefe82c",
"type": "FAILED_LOGIN_ATTEMPTS",
"reason": "Account blocked due to invalid login attempts.",
"createdAt": "2025-10-28T01:21:27.000Z",
"updatedAt": "2025-10-28T12:46:56.000Z",
"deletedAt": "2025-10-28T12:46:56.000Z"
}
],
"company": [],
"pfOwner": null,
"pjCounterparts": [],
"isBlocked": false
}{
"company": {
"id": "c887cf3d-e4e1-4ba9-9ba9-8496b6ccadbc",
"documentNumber": "27902520859660",
"businessName": "Smart Group LTDA",
"tradingName": "Smart Group",
"businessEmail": "[email protected]",
"businessType": "LTDA",
"businessSize": "SMALL",
"cnaeCode": "8711501",
"legalNature": "328-0",
"declaredAnnualBilling": "Mais de cinquenta mil, até cem mil reais",
"openingDate": "2020-07-18T03:00:00.000Z",
"phone": "5561985122032",
"status": "APPROVED",
"reasons": "",
"address": {
"zipCode": "76801180",
"addressLine": "Rua Major Amarante",
"buildingNumber": "11",
"complement": "Sala 23",
"neighborhood": "Arigolândia",
"city": "Porto Velho",
"state": "RO",
"country": "BR"
}
},
"legalRepresentatives": [
{
"id": "c5096507-193c-46c1-a646-4129c0eec421",
"documentNumber": "18299469430",
"registerName": "Mariana Oliveira Silva",
"socialName": "Mariana Oliveira",
"birthDate": "1997-05-25",
"motherName": "Camila Mariana Silva Silva",
"email": "[email protected]",
"phone": "5561985122032",
"gender": null,
"declaredIncome": "Menos de mil reais por mês",
"occupation": "Produtor Fonográfico",
"address": {
"zipCode": "76801180",
"addressLine": "Rua Major Amarante",
"buildingNumber": "11",
"complement": "Sala 23",
"neighborhood": "Arigolândia",
"city": "Porto Velho",
"state": "RO",
"country": "BR"
},
"isPoliticallyExposedPerson": false,
"isAlsoOwner": true
}
],
"owners": [
{
"id": "c5096507-193c-46c1-a646-4129c0eec421",
"documentNumber": "18299469430",
"email": "[email protected]",
"participationPercentage": null,
"address": {
"zipCode": "76801180",
"addressLine": "Rua Major Amarante",
"buildingNumber": "11",
"complement": "Sala 23",
"neighborhood": "Arigolândia",
"city": "Porto Velho",
"state": "RO",
"country": "BR"
},
"registerName": "Mariana Oliveira Silva",
"socialName": "Mariana Oliveira",
"birthDate": "1997-05-25",
"motherName": "Camila Mariana Silva Silva",
"declaredIncome": "Menos de mil reais por mês",
"occupation": "Produtor Fonográfico",
"pep": {
"level": false
}
},
{
"id": "f3de375c-9e9f-41ac-b144-b9311260b23e",
"documentNumber": "18299469430",
"email": "[email protected]",
"participationPercentage": "87.32",
"address": {
"zipCode": "76801180",
"addressLine": "Rua Major Amarante",
"buildingNumber": "11",
"complement": "Sala 23",
"neighborhood": "Arigolândia",
"city": "Porto Velho",
"state": "RO",
"country": "BR"
},
"registerName": "Mariana Oliveira Silva",
"socialName": "Mariana Oliveira",
"birthDate": "1997-06-06",
"motherName": "Camila Mariana Silva Silva",
"declaredIncome": "Menos de mil reais por mês",
"occupation": "Produtor Fonográfico",
"pep": {
"level": true
}
}
],
"documentation": {
"articlesOfIncorporation": "eDMnFa.OKXTdgqyOTUsH1EAxjWvEypRA",
"lastContractChange": "yyNXKdiSyMNGL8z6a.CHF9Yq3UC_u9fA",
"balanceSheet": "vCPe_I_kSJ70jnSlS.I2AcMEpfuBoheq",
"powerOfAttorney": null
},
"isBlocked": false
}Erros
Este endpoint não retorna erros específicos. Porém, ele poderá retornar alguns erros comuns entre todos os endpoints.
Eventos
Este endpoint não possui eventos relacionados a ele.
Updated about 1 month ago