Acessar minha contaAbrir uma conta
PATCH/api/v2/baas/onboardings/{proposalId}/legal-persons/{personId}

Atualizar

Produto BaaS (parceiro). Scope: baas.onboarding-legal-persons.write. Campos obrigatorios do schema para concluir KYC e abertura de conta PJ. Guia: documentacao tecnica.

Parâmetros

AcceptObrigatório
header
Tipo:string
X-SignatureObrigatório
header

Assinatura HMAC-SHA256 da requisição (hex).

Tipo:string
X-TimestampObrigatório
header

Timestamp Unix (segundos, UTC) usado na assinatura.

Tipo:string
X-NonceObrigatório
header

Nonce único por requisição (anti-replay).

Tipo:string
proposalIdObrigatório
path
Tipo:string
personIdObrigatório
path
Tipo:string

Autenticação e headers

Requer Bearer token e assinatura HMAC obrigatórios. Scope: baas.onboarding-legal-persons.write.

HeaderObrigatórioDescrição
AuthorizationSimBearer {{access_token}}
AcceptSimapplication/json
X-SignatureSimAssinatura HMAC
X-TimestampSimTimestamp da assinatura
X-NonceSimNonce único por requisição

Path

ParâmetroDescrição
proposalIdID da proposta
personIdID da pessoa jurídica

Corpo (PATCH)

Todos os campos abaixo são obrigatórios para enviar o cadastro à análise KYC e abertura de conta.

CampoObrigatórioDescrição
business_nameSimRazão social, máx. 255
trading_nameSimNome fantasia, máx. 255
business_emailSimE-mail válido
contact_numberSim8 a 11 dígitos
monthly_revenueSimNumérico, mín. 0
company_typeSimLTDA, MEI, ME ou SA
accepted_terms_atSimY-m-d H:i:s
device.os_version_nameSimSO do dispositivo
email_verification_codeSimOTP de business_email (do GET imediato)
address.zip_codeSimCEP, 8 dígitos
address.streetSimmáx. 255
address.numberSimmáx. 255
address.citySimCidade
address.neighborhoodSimBairro
address.stateSimUF, 2 letras
address.complementNãoComplemento
filesSimMín. 2; tipos conforme company_type
owners[]SimResponsável com endereço, PEP e files[] (identidade + selfie)
owners[].filesSimMín. 3 por sócio (mesma regra PF)
device.os_name, device.os_version, device.ip_address, device.ip_address_local, device.engine_name, device.engine_version, device.platform_model, device.platform_vendor, device.firebase_token, device.latitude, device.longitudeSimObjeto device completo: Device

Documentos por company_type:

company_typefiles[].type obrigatórios
LTDAsocial_contract, proof_address
MEIproof_microentrepreneur, proof_address
MEproof_association, proof_address
SAproof_board_election, proof_address

Não envie valid_documents no body.

Erros comuns

CódigoCorpoCausa
404Company not foundPJ ou customer inexistente
422valid_documentsConjunto de arquivos não bate com company_type ou campo obrigatório ausente

Notas

curl --request PATCH \
  --url 'https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/legal-persons/269' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'X-Timestamp: {{timestamp}}' \
  --header 'X-Nonce: {{nonce}}' \
  --header 'X-Signature: {{signature}}' \
  --data '{"contact_number":"11987654321","business_name":"Loja Exemplo LTDA","trading_name":"Loja Exemplo","business_email":"[email protected]","monthly_revenue":50000,"accepted_terms_at":"2025-01-15 10:30:00","notifications_enabled":false,"document":"43587980000107","password":"SenhaExemplo123","password_confirmation":"SenhaExemplo123","company_type":"LTDA","email_verification_code":"123456","device":{"os_version_name":"Android 14","os_name":"Android","os_version":"14.0.0","ip_address":"203.0.113.10","ip_address_local":"192.168.1.5","engine_name":"Exemplo Smartphone","engine_version":"exemplo-device-id-001","platform_model":"SM-S911B","platform_vendor":"Samsung","firebase_token":"exemplo-firebase-token","latitude":-23.5505,"longitude":-46.6333},"address":{"zip_code":"01310100","street":"Avenida Exemplo","number":"1000","complement":"Sala 1","city":"Sao Paulo","neighborhood":"Bela Vista","state":"SP"},"files":[{"type":"social_contract","path":"data:application/pdf;base64,exemplo-ficticio"},{"type":"proof_address","path":"data:image/jpeg;base64,exemplo-ficticio"}],"owners":[{"full_name":"Joao Recebedor Exemplo","social_name":"Joao Exemplo","email":"[email protected]","phone":"11976543210","document":"52998224725","birth_date":"1985-03-15","type":"partner","is_political_exposed":false,"address":{"zip_code":"01310100","street":"Avenida Exemplo","number":"1000","complement":"Sala 1","city":"Sao Paulo","neighborhood":"Bela Vista","state":"SP"},"files":[{"type":"document","path":"data:image/jpeg;base64,exemplo-ficticio","side":"front"},{"type":"document","path":"data:image/jpeg;base64,exemplo-ficticio","side":"back"},{"type":"selfie","path":"data:image/jpeg;base64,exemplo-ficticio"}]}]}'

const axios = require("axios");

const data = {
  "contact_number": "11987654321",
  "business_name": "Loja Exemplo LTDA",
  "trading_name": "Loja Exemplo",
  "business_email": "[email protected]",
  "monthly_revenue": 50000,
  "accepted_terms_at": "2025-01-15 10:30:00",
  "notifications_enabled": false,
  "document": "43587980000107",
  "password": "SenhaExemplo123",
  "password_confirmation": "SenhaExemplo123",
  "company_type": "LTDA",
  "email_verification_code": "123456",
  "device": {
    "os_version_name": "Android 14",
    "os_name": "Android",
    "os_version": "14.0.0",
    "ip_address": "203.0.113.10",
    "ip_address_local": "192.168.1.5",
    "engine_name": "Exemplo Smartphone",
    "engine_version": "exemplo-device-id-001",
    "platform_model": "SM-S911B",
    "platform_vendor": "Samsung",
    "firebase_token": "exemplo-firebase-token",
    "latitude": -23.5505,
    "longitude": -46.6333
  },
  "address": {
    "zip_code": "01310100",
    "street": "Avenida Exemplo",
    "number": "1000",
    "complement": "Sala 1",
    "city": "Sao Paulo",
    "neighborhood": "Bela Vista",
    "state": "SP"
  },
  "files": [
    {
      "type": "social_contract",
      "path": "data:application/pdf;base64,exemplo-ficticio"
    },
    {
      "type": "proof_address",
      "path": "data:image/jpeg;base64,exemplo-ficticio"
    }
  ],
  "owners": [
    {
      "full_name": "Joao Recebedor Exemplo",
      "social_name": "Joao Exemplo",
      "email": "[email protected]",
      "phone": "11976543210",
      "document": "52998224725",
      "birth_date": "1985-03-15",
      "type": "partner",
      "is_political_exposed": false,
      "address": {
        "zip_code": "01310100",
        "street": "Avenida Exemplo",
        "number": "1000",
        "complement": "Sala 1",
        "city": "Sao Paulo",
        "neighborhood": "Bela Vista",
        "state": "SP"
      },
      "files": [
        {
          "type": "document",
          "path": "data:image/jpeg;base64,exemplo-ficticio",
          "side": "front"
        },
        {
          "type": "document",
          "path": "data:image/jpeg;base64,exemplo-ficticio",
          "side": "back"
        },
        {
          "type": "selfie",
          "path": "data:image/jpeg;base64,exemplo-ficticio"
        }
      ]
    }
  ]
};

axios({
  method: "patch",
  url: "https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/legal-persons/269",
  headers: {
    "Content-Type": "application/json",
    Accept: "application/json",
    Authorization: "Bearer {{access_token}}",
    "X-Timestamp": "{{timestamp}}",
    "X-Nonce": "{{nonce}}",
    "X-Signature": "{{signature}}",
  },
  data,
})
  .then((response) => console.log(JSON.stringify(response.data)))
  .catch((error) => console.log(error.response?.data || error.message));

import json
import requests

url = "https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/legal-persons/269"
payload = {
        "contact_number": "11987654321",
        "business_name": "Loja Exemplo LTDA",
        "trading_name": "Loja Exemplo",
        "business_email": "[email protected]",
        "monthly_revenue": 50000,
        "accepted_terms_at": "2025-01-15 10:30:00",
        "notifications_enabled": False,
        "document": "43587980000107",
        "password": "SenhaExemplo123",
        "password_confirmation": "SenhaExemplo123",
        "company_type": "LTDA",
        "email_verification_code": "123456",
        "device": {
            "os_version_name": "Android 14",
            "os_name": "Android",
            "os_version": "14.0.0",
            "ip_address": "203.0.113.10",
            "ip_address_local": "192.168.1.5",
            "engine_name": "Exemplo Smartphone",
            "engine_version": "exemplo-device-id-001",
            "platform_model": "SM-S911B",
            "platform_vendor": "Samsung",
            "firebase_token": "exemplo-firebase-token",
            "latitude": -23.5505,
            "longitude": -46.6333
        },
        "address": {
            "zip_code": "01310100",
            "street": "Avenida Exemplo",
            "number": "1000",
            "complement": "Sala 1",
            "city": "Sao Paulo",
            "neighborhood": "Bela Vista",
            "state": "SP"
        },
        "files": [
            {
                "type": "social_contract",
                "path": "data:application/pdf;base64,exemplo-ficticio"
            },
            {
                "type": "proof_address",
                "path": "data:image/jpeg;base64,exemplo-ficticio"
            }
        ],
        "owners": [
            {
                "full_name": "Joao Recebedor Exemplo",
                "social_name": "Joao Exemplo",
                "email": "[email protected]",
                "phone": "11976543210",
                "document": "52998224725",
                "birth_date": "1985-03-15",
                "type": "partner",
                "is_political_exposed": False,
                "address": {
                    "zip_code": "01310100",
                    "street": "Avenida Exemplo",
                    "number": "1000",
                    "complement": "Sala 1",
                    "city": "Sao Paulo",
                    "neighborhood": "Bela Vista",
                    "state": "SP"
                },
                "files": [
                    {
                        "type": "document",
                        "path": "data:image/jpeg;base64,exemplo-ficticio",
                        "side": "front"
                    },
                    {
                        "type": "document",
                        "path": "data:image/jpeg;base64,exemplo-ficticio",
                        "side": "back"
                    },
                    {
                        "type": "selfie",
                        "path": "data:image/jpeg;base64,exemplo-ficticio"
                    }
                ]
            }
        ]
    }
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "X-Timestamp": "{{timestamp}}",
    "X-Nonce": "{{nonce}}",
    "X-Signature": "{{signature}}",
}
response = requests.patch(url, headers=headers, data=json.dumps(payload))
print(response.text)

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/legal-persons/269',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'PATCH',
  CURLOPT_POSTFIELDS => '{"contact_number":"11987654321","business_name":"Loja Exemplo LTDA","trading_name":"Loja Exemplo","business_email":"[email protected]","monthly_revenue":50000,"accepted_terms_at":"2025-01-15 10:30:00","notifications_enabled":false,"document":"43587980000107","password":"SenhaExemplo123","password_confirmation":"SenhaExemplo123","company_type":"LTDA","email_verification_code":"123456","device":{"os_version_name":"Android 14","os_name":"Android","os_version":"14.0.0","ip_address":"203.0.113.10","ip_address_local":"192.168.1.5","engine_name":"Exemplo Smartphone","engine_version":"exemplo-device-id-001","platform_model":"SM-S911B","platform_vendor":"Samsung","firebase_token":"exemplo-firebase-token","latitude":-23.5505,"longitude":-46.6333},"address":{"zip_code":"01310100","street":"Avenida Exemplo","number":"1000","complement":"Sala 1","city":"Sao Paulo","neighborhood":"Bela Vista","state":"SP"},"files":[{"type":"social_contract","path":"data:application/pdf;base64,exemplo-ficticio"},{"type":"proof_address","path":"data:image/jpeg;base64,exemplo-ficticio"}],"owners":[{"full_name":"Joao Recebedor Exemplo","social_name":"Joao Exemplo","email":"[email protected]","phone":"11976543210","document":"52998224725","birth_date":"1985-03-15","type":"partner","is_political_exposed":false,"address":{"zip_code":"01310100","street":"Avenida Exemplo","number":"1000","complement":"Sala 1","city":"Sao Paulo","neighborhood":"Bela Vista","state":"SP"},"files":[{"type":"document","path":"data:image/jpeg;base64,exemplo-ficticio","side":"front"},{"type":"document","path":"data:image/jpeg;base64,exemplo-ficticio","side":"back"},{"type":"selfie","path":"data:image/jpeg;base64,exemplo-ficticio"}]}]}',
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    '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": "269",
  "document": "43587980000107",
  "status": "completed",
  "business_name": "Loja Exemplo LTDA",
  "trading_name": "Loja Exemplo",
  "business_email": "[email protected]",
  "contact_number": "11987654321",
  "company_type": "LTDA",
  "monthly_revenue": 50000,
  "accepted_terms_at": "2025-01-15 10:30:00",
  "notifications_enabled": false,
  "updated_at": "2025-01-15T12:20:00Z"
}

curl --request PATCH \
  --url 'https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/legal-persons/269' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'X-Timestamp: {{timestamp}}' \
  --header 'X-Nonce: {{nonce}}' \
  --header 'X-Signature: {{signature}}' \
  --data '{"contact_number":"11987654321","business_name":"Loja Exemplo LTDA","trading_name":"Loja Exemplo","business_email":"[email protected]","monthly_revenue":50000,"accepted_terms_at":"2025-01-15 10:30:00","company_type":"MEI","device":{"os_version_name":"Android 14"},"address":{"zip_code":"01310100","street":"Avenida Exemplo","number":"1000","city":"Sao Paulo","neighborhood":"Bela Vista","state":"SP"},"files":[{"type":"proof_microentrepreneur","path":"data:application/pdf;base64,exemplo-ficticio"},{"type":"proof_address","path":"data:image/jpeg;base64,exemplo-ficticio"}]}'

curl --request PATCH \
  --url 'https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/legal-persons/269' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'X-Timestamp: {{timestamp}}' \
  --header 'X-Nonce: {{nonce}}' \
  --header 'X-Signature: {{signature}}' \
  --data '{"contact_number":"11987654321","business_name":"Loja Exemplo LTDA","trading_name":"Loja Exemplo","business_email":"[email protected]","monthly_revenue":50000,"accepted_terms_at":"2025-01-15 10:30:00","company_type":"ME","device":{"os_version_name":"Android 14"},"address":{"zip_code":"01310100","street":"Avenida Exemplo","number":"1000","city":"Sao Paulo","neighborhood":"Bela Vista","state":"SP"},"files":[{"type":"proof_association","path":"data:application/pdf;base64,exemplo-ficticio"},{"type":"proof_address","path":"data:image/jpeg;base64,exemplo-ficticio"}]}'

curl --request PATCH \
  --url 'https://api-h.nuvende.com.br/api/v2/baas/onboardings/352/legal-persons/269' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'X-Timestamp: {{timestamp}}' \
  --header 'X-Nonce: {{nonce}}' \
  --header 'X-Signature: {{signature}}' \
  --data '{"contact_number":"11987654321","business_name":"Loja Exemplo LTDA","trading_name":"Loja Exemplo","business_email":"[email protected]","monthly_revenue":50000,"accepted_terms_at":"2025-01-15 10:30:00","company_type":"SA","device":{"os_version_name":"Android 14"},"address":{"zip_code":"01310100","street":"Avenida Exemplo","number":"1000","city":"Sao Paulo","neighborhood":"Bela Vista","state":"SP"},"files":[{"type":"proof_board_election","path":"data:application/pdf;base64,exemplo-ficticio"},{"type":"proof_address","path":"data:image/jpeg;base64,exemplo-ficticio"}]}'

{
  "message": "Company not found"
}

{
  "message": "Invalid documents from company type"
}