Criar uma Empresa

Cria o cadastro de uma nova Empresa na Plataforma, vinculada a um Originador, que representa uma companhia participante do processo de contratação de crédito.

Uma Empresa pode assumir diferentes funções dentro das solicitações, e os dados exigidos podem variar conforme as configurações do Produto.

Este endpoint permite registrar:

• Informações cadastrais da empresa

• Endereço principal e de cobrança

• Dados bancários externos

• Chave PIX (opcional)

• Variáveis personalizadas

---

Descrição

Este endpoint permite cadastrar uma nova empresa na Plataforma, criando sua identidade jurídica e operacional para participação em processos de crédito.

A operação cria um novo recurso e retorna os dados persistidos da empresa cadastrada.

---

Método HTTP

POST

---

URL

https://sandbox.platform.flowfinance.com.br/banking/originator/business

---

Headers

---

Body Parameters

Dados Principais da Empresa

---

Phone (Objeto)

---

Address (Objeto)

---

Billing Address (Objeto)

Objeto opcional com a mesma estrutura de Address, utilizado para dados de cobrança.

---

Pix (Objeto – Opcional)

---

External Bank Account (Objeto)

---

Exemplo de Requisição

POST /api/v1/companies
Authorization: Bearer {token}
Content-Type: application/json

{
  "legal_name": "EMPRESA TESTE LTDA",
  "taxpayer_id": "12345678000195",
  "incorporation_type": "LTDA",
  "tax_regime": "SIMPLE",
  "industry_classification": "6619302",
  "foundation_date": "2019-03-12",
  "email_address": "[email protected]",
  "phone": {
    "country_code": "55",
    "area_code": "11",
    "number": "998877665"
  },
  "address": {
    "street_name": "Rua do Guapuruvú",
    "street_number": 61,
    "postal_code": "88062294",
    "district": "Lagoa da Conceição",
    "city": "Florianópolis",
    "state_code": "SC",
    "country_code": "BRA"
  },
  "external_bank_account": {
    "bank_code": "0260",
    "bank_branch": "1234",
    "bank_account": "123456",
    "bank_account_digit": "7"
  },
  "pix": {
    "key_type": "TAXPAYER_ID",
    "key": "12345678000195"
  }
}

---

Resposta de Sucesso

Status: 201 Created

Retorna os dados completos da empresa cadastrada.

{
  "id": "99fa962c-8e3c-43dc-9abb-72ed12efce3d",
  "legal_name": "EMPRESA TESTE LTDA",
  "taxpayer_id": "12345678000195",
  "phone": {
    "country_code": "55",
    "area_code": "11",
    "number": "998877665",
    "formatted_number": "+5511998877665"
  },
  "incorporation_type": "LTDA",
  "tax_regime": "SIMPLE",
  "industry_classification": "6619302",
  "email_address": "[email protected]",
  "address": {
    "street_name": "Rua do Guapuruvú",
    "street_number": 61,
    "postal_code": "88062294",
    "district": "Lagoa da Conceição",
    "city": "Florianópolis",
    "state_code": "SC",
    "country_code": "BRA"
  },
  "pix": {
    "key": "12345678000195",
    "key_type": "TAXPAYER_ID"
  },
  "external_bank_account": {
    "bank_code": "0260",
    "bank_account": "123456",
    "bank_account_digit": "7",
    "bank_branch": "1234"
  },
  "created_at": "2026-01-20T01:33:36.585225Z"
}

---

Códigos de Retorno