> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /api/v1/accounts/onboarding/business

> Cadastra um seller Pessoa Jurídica (CNPJ) no gateway de pagamentos para habilitar recebimentos

Cria um seller do tipo Pessoa Jurídica (PJ) no gateway de pagamentos Zoop e o associa à conta e organização informadas. É necessário informar os dados da empresa e ao menos um sócio/responsável (dono). Quando o seller é aprovado (`status: active`), cobranças e saques são habilitados automaticamente.

> [!NOTE]
>
> O usuário autenticado precisa ser o administrador (`admin_id`) da conta informada.

## Autenticação

Requer autenticação via **Supabase JWT** (usuário autenticado).

## Corpo da Requisição

**account\_id** `string` *required*

ID da conta (`accounts`) à qual o seller será vinculado.

**organizationId** `string` *required*

ID da organização do usuário.

**documentNumber** `string` *required*

CNPJ da empresa (com ou sem formatação).

**businessName** `string` *required*

Razão social da empresa.

**tradingName** `string` *required*

Nome fantasia da empresa (até 22 caracteres — usado como `statement_descriptor`).

**contactNumber** `string` *required*

Telefone comercial no formato brasileiro (ex: `1133334444`).

**businessEmail** `string` *required*

E-mail comercial da empresa.

**businessOpeningDate** `string`

Data de abertura da empresa no formato `YYYY-MM-DD`.

**website** `string`

Site da empresa.

**companyType** `string`

Tipo societário da empresa (ex: `ltda`, `sa`, `mei`).

**mcc** `string` (default: 5999)

Código de categoria do comerciante (Merchant Category Code). Padrão: `5999` (varejo em geral).

**address** `object` *required*

Endereço comercial da empresa.

**Propriedades**

**street** `string` *required*

Logradouro

**number** `string` *required*

Número

**addressComplement** `string`

Complemento

**neighborhood** `string` *required*

Bairro

**city** `string` *required*

Cidade

**state** `string` *required*

Estado (UF, ex: `SP`)

**postalCode** `string` *required*

CEP (ex: `01310100`)

**owners** `array` *required*

Lista de sócios/responsáveis. Deve conter ao menos um item. O primeiro item é o sócio principal.

**Propriedades de cada sócio**

**fullName** `string` *required*

Nome completo

**email** `string` *required*

E-mail

**phoneNumber** `string` *required*

Telefone (formato brasileiro)

**documentNumber** `string` *required*

CPF do sócio

**birthDate** `string` *required*

Data de nascimento (`YYYY-MM-DD`)

**address** `object` *required*

Endereço residencial do sócio (mesmos campos do endereço da empresa).

## Resposta

**success** `boolean`

`true` quando o seller foi criado com sucesso.

**seller** `object`

Dados do seller criado.

**Propriedades**

**sellerId** `string`

ID do seller no gateway

**status** `string`

Status no gateway: `pending`, `active`, `action_required`

**polarStatus** `string`

Status mapeado para o padrão Chargefy

**type** `string`

Sempre `business`

**createdAt** `string`

Data de criação (ISO 8601)

**account** `object`

Dados resumidos da conta atualizada.

**Propriedades**

**id** `string`

ID da conta

**status** `string`

Status da conta

**country** `string`

País (ex: `BR`)

**currency** `string`

Moeda (ex: `BRL`)

## Exemplo

```bash cURL theme={null}
curl -X POST "https://api.chargefy.io/api/v1/accounts/onboarding/business" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_abc123",
    "organizationId": "org_xyz456",
    "documentNumber": "12345678000190",
    "businessName": "Empresa Exemplo LTDA",
    "tradingName": "Exemplo",
    "contactNumber": "1133334444",
    "businessEmail": "contato@empresa.com",
    "address": {
      "street": "Av. Paulista",
      "number": "1000",
      "neighborhood": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "postalCode": "01310100"
    },
    "owners": [
      {
        "fullName": "Maria Souza",
        "email": "maria@empresa.com",
        "phoneNumber": "11999997777",
        "documentNumber": "98765432100",
        "birthDate": "1980-03-22",
        "address": {
          "street": "Rua dos Pinheiros",
          "number": "200",
          "neighborhood": "Pinheiros",
          "city": "São Paulo",
          "state": "SP",
          "postalCode": "05422010"
        }
      }
    ]
  }'
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';

const chargefy = new Chargefy({
  accessToken: process.env.CHARGEFY_ACCESS_TOKEN,
});

const result = await chargefy.accounts.onboarding.createBusiness({
  accountId: 'acc_abc123',
  organizationId: 'org_xyz456',
  documentNumber: '12345678000190',
  businessName: 'Empresa Exemplo LTDA',
  tradingName: 'Exemplo',
  contactNumber: '1133334444',
  businessEmail: 'contato@empresa.com',
  address: { /* ... */ },
  owners: [{ /* ... */ }],
});
```

## Resposta de Exemplo

```json theme={null}
{
  "success": true,
  "seller": {
    "sellerId": "seller_biz789",
    "status": "pending",
    "polarStatus": "onboarding",
    "type": "business",
    "createdAt": "2026-03-20T10:00:00Z"
  },
  "account": {
    "id": "acc_abc123",
    "status": "active",
    "country": "BR",
    "currency": "BRL"
  }
}
```

## Erros

| Status | Descrição |
| - | - |
| `400` | Dados inválidos (CNPJ, telefone, e-mail, CEP, UF ou CPF do sócio inválidos) |
| `400` | A conta já possui um seller cadastrado |
| `400` | Nenhum sócio informado (`owners` vazio) |
| `403` | Usuário não tem acesso à organização ou não é admin da conta |
| `403` | Organização bloqueada ou com acesso negado |
| `404` | Conta ou organização não encontrada |
| `503` | Gateway de pagamento não configurado |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.