Produto BaaS (parceiro). Requer Bearer JWT e assinatura HMAC obrigatória. Scope: baas.onboarding-natural-persons.read. Guia: documentação técnica.
stringAssinatura HMAC-SHA256 da requisição (hex).
stringTimestamp Unix (segundos, UTC) usado na assinatura.
stringNonce único por requisição (anti-replay).
stringstringstringRequer Bearer token e assinatura HMAC obrigatórios.
Scope: baas.onboarding-natural-persons.read.
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | Sim | Bearer {{access_token}} |
Accept | Sim | application/json |
X-Signature | Sim | Assinatura HMAC |
X-Timestamp | Sim | Timestamp da assinatura |
X-Nonce | Sim | Nonce único por requisição |
| Parâmetro | Descrição |
|---|---|
proposalId | ID da proposta |
personId | ID da pessoa física |
| Campo | Descrição |
|---|---|
id, document, status | Identificação e status KYC |
full_name, social_name, email, phone, birth_date | Cadastro |
monthly_gross_income, is_political_exposed | Dados financeiros e PEP |
accepted_terms_at, onboarding_proposal_id | Termos e vínculo com proposta |
email_verification_code | OTP volátil quando exigido |
address | CEP, logradouro, cidade, UF |
journey | Etapa do fluxo PF |
account | Conta bancária quando aprovada |
files[] | Metadados dos documentos (sem base64 em path) |
curl --request GET \
--url 'https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/natural-persons/268' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'X-Timestamp: {{timestamp}}' \
--header 'X-Nonce: {{nonce}}' \
--header 'X-Signature: {{signature}}'
const axios = require("axios");
const data = {};
axios({
method: "get",
url: "https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/natural-persons/268",
headers: {
Accept: "application/json",
Authorization: "Bearer {{access_token}}",
"X-Timestamp": "{{timestamp}}",
"X-Nonce": "{{nonce}}",
"X-Signature": "{{signature}}",
},
})
.then((response) => console.log(JSON.stringify(response.data)))
.catch((error) => console.log(error.response?.data || error.message));
import requests
url = "https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/natural-persons/268"
headers = {
"Accept": "application/json",
"Authorization": "Bearer {{access_token}}",
"X-Timestamp": "{{timestamp}}",
"X-Nonce": "{{nonce}}",
"X-Signature": "{{signature}}",
}
response = requests.get(url, headers=headers)
print(response.text)
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/natural-persons/268',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Accept: application/json',
'Authorization: Bearer {{access_token}}',
'X-Timestamp: {{timestamp}}',
'X-Nonce: {{nonce}}',
'X-Signature: {{signature}}',
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
{
"id": "268",
"document": "111***77735",
"status": "pending",
"full_name": "Maria Pagadora Exemplo",
"social_name": "Maria Exemplo",
"email": "[email protected]",
"phone": "11987654321",
"birth_date": "1990-05-20",
"accepted_terms_at": "2025-01-15 10:30:00",
"notifications_enabled": false,
"email_verification_code": "123456",
"address": {
"zip_code": "01310100",
"street": "Avenida Exemplo",
"number": "1000",
"complement": "Sala 1"
},
"files": [
{
"type": "document",
"side": "front",
"status": "pending"
},
{
"type": "document",
"side": "back",
"status": "pending"
},
{
"type": "selfie",
"status": "pending"
}
],
"created_at": "2025-01-15T10:05:00Z",
"updated_at": "2025-01-15T11:00:00Z"
}