Tenants & Contas de Desenvolvedor

A gestão de contas permite controlar empresas filiais, clientes de plataformas SaaS e suas respectivas chaves de acesso à API.

---

POST Criar Nova Empresa (Tenant)

Registra uma nova empresa emissora sob a conta do integrador.

POST /v1/tenants

Requisição

cURL

curl --request POST \
  --url http://localhost:3333/v1/tenants \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: fylee_live_...' \
  --data '{
    "cnpj": "12345678000195",
    "razaoSocial": "NOVA EMPRESA COMERCIO LTDA",
    "nomeFantasia": "NOVA STORE",
    "inscricaoEstadual": "123456789110",
    "regimeTributario": "SIMPLES_NACIONAL",
    "endereco": {
      "logradouro": "Rua do Comércio",
      "numero": "500",
      "bairro": "Centro",
      "codigoMunicipio": "3550308",
      "municipio": "São Paulo",
      "uf": "SP",
      "cep": "01010000"
    }
  }'

Exemplo de Resposta (201 Created)

{
  "id": "ten_a9821873198",
  "cnpj": "12345678000195",
  "razaoSocial": "NOVA EMPRESA COMERCIO LTDA",
  "status": "ATIVO",
  "createdAt": "2026-10-07T10:30:00.000Z"
}

---

GET Listar Empresas do Integrador

Retorna todas as empresas cadastradas vinculadas à sua conta.

GET /v1/tenants

cURL

curl --request GET \
  --url http://localhost:3333/v1/tenants \
  --header 'x-api-key: fylee_live_...'

Exemplo de Resposta (200 OK)

{
  "data": [
    {
      "id": "ten_a9821873198",
      "cnpj": "12345678000195",
      "razaoSocial": "NOVA EMPRESA COMERCIO LTDA",
      "status": "ATIVO",
      "hasCertificate": true
    }
  ]
}