Pessoa Juridica

A empresa (PJ) segue a mesma lógica de cadastro da Pessoa Física. O id retornado é utilizado como borrower_id na criação da proposta de crédito.

Importante: após o cadastro da empresa, é obrigatório vincular ao menos uma pessoa responsável pela assinatura antes de criar uma operação de crédito.

Cadastrar empresa

POST /banking/originator/business

Headers

Header	Obrigatório	Descrição
`Authorization`	Sim	`Bearer <token>`
`Content-Type`	Sim	`application/json`

Campos do body

Campos obrigatórios

Campo	Tipo	Descrição
`legal_name`	string	Razão social da empresa
`taxpayer_id`	string	CNPJ sem pontuação (`.` `-` `/`)
`name`	string	Nome do representante ou nome fantasia
`email_address`	string	E-mail da empresa
`foundation_date`	string	Data de abertura no formato `YYYY-MM-DD`
`incorporation_type`	string	Tipo de constituição. Valor aceito: `LTDA`
`tax_regime`	string	Regime tributário. Valor aceito: `SIMPLE`
`industry_classification`	string	Classificação da atividade econômica (CNAE)
`phone`	object	Telefone da empresa (ver abaixo)

Objeto phone

Campo	Tipo	Descrição
`country_code`	string	DDI. Ex.: `"55"` para Brasil
`area_code`	string	DDD. Ex.: `"11"` para São Paulo
`number`	string	Número do telefone sem formatação

Dados bancários para desembolso (obrigatório ao menos um)

Se ambos forem informados, o desembolso será realizado via chave Pix.

Opção 1 — Chave Pix

Campo	Tipo	Descrição
`pix.key`	string	Chave Pix
`pix.key_type`	string	Tipo da chave: `TAXPAYER_ID`, `EMAIL`, `PHONE_NUMBER`, `ALEATORY_KEY`

Sandbox: utilize a chave 4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab com key_type: ALEATORY_KEY para simular desembolsos.

Opção 2 — Conta bancária

Campo	Tipo	Descrição
`external_bank_account.bank_code`	string	Código do banco
`external_bank_account.bank_account`	string	Número da conta
`external_bank_account.bank_account_digit`	string	Dígito verificador da conta
`external_bank_account.bank_branch`	string	Agência
`external_bank_account.bank_account_type`	string	Tipo da conta. Ex.: `CACC`
`external_bank_account.ispb_code`	string	Código ISPB do banco

Campos opcionais relevantes

Campo	Tipo	Descrição
`address`	object	Endereço da empresa (mesma estrutura da PF)
`billing_address`	object	Endereço de cobrança, se diferente do endereço principal
`monthly_revenue`	number	Faturamento mensal
`share_capital`	number	Capital social
`external_id`	string	Identificador externo do originador
`custom_variables`	object	Variáveis customizadas do originador

Objeto address

Campo	Tipo	Descrição
`street_name`	string	Nome da rua
`street_number`	number	Número
`postal_code`	string	CEP sem formatação
`district`	string	Bairro
`city`	string	Cidade
`state_code`	string	UF. Ex.: `"SP"`
`country_code`	string	País no formato ISO. Ex.: `"BRA"`
`extra_info`	string	Complemento (opcional)

Exemplo de cadastro

curl --request POST \
  'https://sandbox.platform.flowfinance.com.br/banking/originator/business' \
  --header 'Authorization: Bearer <seu_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "legal_name": "Empresa Teste LTDA",
    "taxpayer_id": "00000000000100",
    "name": "Nome Representante",
    "email_address": "[email protected]",
    "foundation_date": "2020-01-01",
    "incorporation_type": "LTDA",
    "tax_regime": "SIMPLE",
    "industry_classification": "6499999",
    "phone": {
      "country_code": "55",
      "area_code": "11",
      "number": "999999999"
    },
    "pix": {
      "key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
      "key_type": "ALEATORY_KEY"
    },
    "address": {
      "street_name": "Alameda Xingu",
      "street_number": 350,
      "postal_code": "06455030",
      "district": "Alphaville",
      "city": "Barueri",
      "state_code": "SP",
      "country_code": "BRA",
      "extra_info": "Sala 101"
    }
  }'

Resposta (HTTP 201)

{
  "id": "00000000-0000-0000-0000-000000000000",
  "legal_name": "Empresa Teste LTDA",
  "taxpayer_id": "00000000000100",
  "name": "Nome Representante",
  "email_address": "[email protected]",
  "foundation_date": "2020-01-01",
  "incorporation_type": "LTDA",
  "tax_regime": "SIMPLE",
  "industry_classification": "6499999",
  "phone": {
    "country_code": "55",
    "area_code": "11",
    "number": "999999999"
  },
  "pix": {
    "key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
    "key_type": "ALEATORY_KEY"
  },
  "external_bank_account": null,
  "address": {
    "street_name": "Alameda Xingu",
    "street_number": 350,
    "postal_code": "06455030",
    "district": "Alphaville",
    "city": "Barueri",
    "state_code": "SP",
    "country_code": "BRA",
    "extra_info": "Sala 101"
  },
  "version": 0,
  "created_at": "2026-04-17T21:20:25.470689Z"
}

O campo id retornado deve ser utilizado como borrower_id na criação da proposta de crédito.

Consultar empresa

GET /banking/originator/business/{business_id}

Path parameter

Parâmetro	Tipo	Descrição
`business_id`	UUID	Identificador da empresa

Exemplo

curl --request GET \
  'https://sandbox.platform.flowfinance.com.br/banking/originator/business/00000000-0000-0000-0000-000000000000' \
  --header 'Authorization: Bearer <seu_token>'

Resposta (HTTP 200)

Retorna o objeto completo da empresa no mesmo formato da resposta do cadastro.

Listar empresas

GET /banking/originator/business

Query parameters (opcionais)

Parâmetro	Tipo	Descrição
`taxpayer_id`	string	Filtra pelo CNPJ da empresa
`page`	number	Página dos resultados
`size`	number	Quantidade de itens por página

Exemplo

curl --request GET \
  'https://sandbox.platform.flowfinance.com.br/banking/originator/business' \
  --header 'Authorization: Bearer <seu_token>'

Vincular responsável pela assinatura

Após o cadastro da empresa, é necessário vincular ao menos uma pessoa que irá assinar pelo CNPJ. Essa pessoa deve já estar cadastrada na plataforma como Pessoa Física.

POST /banking/originator/business/{business_id}/relations

Path parameter

Parâmetro	Tipo	Descrição
`business_id`	UUID	Identificador da empresa

Campos do body

Campo	Tipo	Obrigatório	Descrição
`id`	UUID	Sim	Identificador da Pessoa Física já cadastrada na plataforma
`type`	string	Sim	Tipo de vínculo. Valor aceito: `MANAGER`
`signer`	boolean	Sim	Indica se esta pessoa assina pelo CNPJ. Deve ser `true` para ao menos um vínculo
`share`	number	Não	Percentual de participação societária

Exemplo

curl --request POST \
  'https://sandbox.platform.flowfinance.com.br/banking/originator/business/00000000-0000-0000-0000-000000000000/relations' \
  --header 'Authorization: Bearer <seu_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "00000000-0000-0000-0000-000000000001",
    "type": "MANAGER",
    "signer": true,
    "share": null
  }'

Resposta (HTTP 201)

{
  "id": "00000000-0000-0000-0000-000000000001",
  "full_name": "Nome Completo",
  "taxpayer_id": "00000000000",
  "type": "MANAGER",
  "signer": true,
  "share": null,
  "version": 0
}

Consultar vínculos da empresa

GET /banking/originator/business/{business_id}/relations

Exemplo

curl --request GET \
  'https://sandbox.platform.flowfinance.com.br/banking/originator/business/00000000-0000-0000-0000-000000000000/relations' \
  --header 'Authorization: Bearer <seu_token>'

Resposta (HTTP 200)

Retorna lista com todos os vínculos cadastrados para a empresa.

Atualizar empresa

PUT /banking/originator/business/{business_id}

Atualiza os dados de uma empresa existente. O body aceita os mesmos campos do cadastro. Apenas os campos enviados serão atualizados.

Exemplo

curl --request PUT \
  'https://sandbox.platform.flowfinance.com.br/banking/originator/business/00000000-0000-0000-0000-000000000000' \
  --header 'Authorization: Bearer <seu_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "email_address": "[email protected]",
    "monthly_revenue": 50000
  }'

Resposta (HTTP 200)

Retorna o objeto completo da empresa com os dados atualizados e o campo version incrementado.