Conta Escrow
Como abrir uma conta escrow para uma empresa parceira, incluindo o cadastro de KYB (empresa e sócios).
O que é
Uma conta escrow é aberta no sistema bancário para custodiar e repassar automaticamente os valores de uma empresa parceira. Diferente do CaaS — onde a infraestrutura de contas escrow é interna e implícita ao fluxo do empréstimo — na LaaS a criação de conta escrow é um endpoint self-service, com cadastro completo de KYB (Know Your Business) da empresa e de seus sócios.
Criando uma conta escrow
POST /escrow-accountsO corpo (CreateEscrowAccountRequest) tem três blocos: company, integration e tracking.
company (EscrowCompanyRequest)
company (EscrowCompanyRequest)| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
companyDocument | string | Sim | CNPJ da empresa (somente dígitos, 14 caracteres). |
companyName | string | Sim | Razão social. |
email | string | Sim | E-mail de contato da empresa. |
legalNatureCode | string | Sim | Código de natureza jurídica (tabela IBGE), ex: "2062" para Ltda. |
cnae | string | Sim | Código CNAE principal (7 dígitos). |
revenue | decimal ou null | Não | Receita bruta anual em reais. |
foundedIn | datetime ou null | Não | Data de constituição da empresa. |
stateRegistration | string ou null | Não | Inscrição estadual. |
simplesNacional | boolean ou null | Não | Se a empresa é optante do Simples Nacional. |
phone | EscrowPhoneRequest | Sim | Telefone de contato (areaCode + phoneNumber). |
address | EscrowAddressRequest | Sim | Endereço da empresa (zipCode, cityCode, street, number, complement, neighborhood, addressType). |
shareholders | array de EscrowShareholderRequest | Sim | Sócios ou administradores da empresa. |
shareholders[] (EscrowShareholderRequest)
shareholders[] (EscrowShareholderRequest)| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome completo do sócio. |
documentNumber | string | Sim | CPF do sócio (somente dígitos, 11 caracteres). |
email | string | Sim | E-mail do sócio. |
birthDate | datetime ou null | Não | Data de nascimento. |
isPep | boolean | Sim | Se é Pessoa Exposta Politicamente (PEP). |
phone | EscrowPhoneRequest | Sim | Telefone do sócio. |
address | EscrowAddressRequest | Sim | Endereço do sócio. |
sharePercentage | decimal ou null | Não | Percentual de participação societária, ex: 50.0. |
Resposta (EscrowAccount)
EscrowAccount)| Campo | Tipo | Descrição |
|---|---|---|
partnerId | uuid | Parceiro proprietário da conta. |
externalId | uuid | UUID externo da conta no sistema bancário. |
companyDocument | string | CNPJ da empresa titular. |
status | string | Status atual da conta no sistema bancário. |
branch / branchDigit | string | Agência e dígito. |
account / accountDigit | string | Conta e dígito. |
bank | EscrowBankInfo | Dados do banco custodiante (bankId, code, brazilianPaymentSystemId). |
id | uuid | Identificador da conta na LaaS. |
Depois da criação
O evento de webhook ESCROW_ACCOUNT_CREATED é disparado assim que a conta é aberta com sucesso no sistema bancário.
Updated 19 days ago
Did this page help you?