Skip to main content
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.

Exemplo

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

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