GET /api/v1/accounts/onboarding/check

Verifica se já existe um seller cadastrado para um determinado CPF ou CNPJ

Consulta se um seller (vendedor) já está registrado no gateway de pagamentos ou no banco de dados para o número de documento informado. Útil para evitar duplicidade antes de iniciar o processo de onboarding.

​

Autenticação

Requer autenticação via Supabase JWT (usuário autenticado). O usuário deve ter acesso à organização informada.

​

Parâmetros de Query

documentNumber · string · required

CPF (Pessoa Física) ou CNPJ (Pessoa Jurídica) do seller a verificar. Pode ser enviado com ou sem formatação.

accountId · string · required

ID da conta (accounts) associada à organização do usuário.

​

Resposta

exists · boolean

true se o seller já está cadastrado, false caso contrário.

seller · object

Presente apenas quando exists é true.

Show Propriedades

sellerId · string

ID do seller no gateway de pagamento

status · string

Status do seller (ex: pending, active, action_required)

type · string

Tipo do seller: individual ou business

createdAt · string

Data de criação (ISO 8601)

updatedAt · string

Data da última atualização (ISO 8601)

​

Exemplo

cURL

curl -X GET "https://api.chargefy.io/api/v1/accounts/onboarding/check?documentNumber=12345678901&accountId=acc_abc123" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"

​

Resposta de Exemplo

{
  "exists": true,
  "seller": {
    "sellerId": "seller_xyz456",
    "status": "pending",
    "type": "individual",
    "createdAt": "2026-03-01T10:00:00Z",
    "updatedAt": "2026-03-15T14:30:00Z"
  }
}

​

Quando seller não existe

{
  "exists": false
}

​

Erros

Status	Descrição
400	documentNumber ou accountId não informados
403	Usuário não tem acesso à organização
404	Conta não encontrada