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.

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.

Show 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.

Show 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.

Show 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.

Show Propriedades

id · string

ID da conta

status · string

Status da conta

country · string

País (ex: BR)

currency · string

Moeda (ex: BRL)

​

Exemplo

cURL

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": "[e-mail]",
    "address": {
      "street": "Av. Paulista",
      "number": "1000",
      "neighborhood": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "postalCode": "01310100"
    },
    "owners": [
      {
        "fullName": "Maria Souza",
        "email": "[e-mail]",
        "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"
        }
      }
    ]
  }'

​

Resposta de Exemplo

{
  "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