Skip to main content
Cria um seller do tipo Pessoa Física (PF) no gateway de pagamentos Zoop e o associa à conta e organização informadas. Após o cadastro bem-sucedido, a conta passa a ter zoop_seller_id definido. 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.
​
fullName
string
required
Nome completo do titular.
​
email
string
required
E-mail do titular.
​
phoneNumber
string
required
Telefone celular no formato brasileiro (ex: 11999998888).
​
documentNumber
string
required
CPF do titular (com ou sem formatação).
​
birthDate
string
required
Data de nascimento no formato YYYY-MM-DD.
​
motherName
string
Nome completo da mãe do titular (usado para antifraude).
​
socialName
string
Nome social do titular (opcional).
​
isPoliticallyExposedPerson
boolean
Indica se o titular é uma pessoa politicamente exposta (PEP).
​
mcc
string
default:"5999"
Código de categoria do comerciante (Merchant Category Code). Padrão: 5999 (varejo em geral).
​
address
object
required
Endereço do titular.

​
Resposta

​
success
boolean
true quando o seller foi criado com sucesso.
​
seller
object
Dados do seller criado.
​
account
object
Dados resumidos da conta atualizada.

​
Exemplo

curl -X POST "https://api.chargefy.io/api/v1/accounts/onboarding/individual" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_abc123",
    "organizationId": "org_xyz456",
    "fullName": "João da Silva",
    "email": "[email protected]",
    "phoneNumber": "11999998888",
    "documentNumber": "12345678901",
    "birthDate": "1985-06-15",
    "address": {
      "street": "Rua das Flores",
      "number": "42",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "postalCode": "01310100"
    }
  }'

​
Resposta de Exemplo

{
  "success": true,
  "seller": {
    "sellerId": "seller_xyz456",
    "status": "pending",
    "polarStatus": "onboarding",
    "type": "individual",
    "createdAt": "2026-03-20T10:00:00Z"
  },
  "account": {
    "id": "acc_abc123",
    "status": "active",
    "country": "BR",
    "currency": "BRL"
  }
}

​
Erros

StatusDescrição
400Dados inválidos (CPF, telefone, e-mail, CEP ou UF inválidos)
400A conta já possui um seller cadastrado
403Usuário não tem acesso à organização ou não é admin da conta
403Organização bloqueada ou com acesso negado
404Conta ou organização não encontrada
503Gateway de pagamento não configurado