Skip to main content
Verifica se o CPF (pessoa física) ou CNPJ (pessoa jurídica) informado já está associado a uma ou mais organizações cadastradas como seller na Zoop. Usado no fluxo de onboarding embed para detectar organizações já existentes e oferecer a opção de vinculação.

​
Autenticação

Nenhuma autenticação necessária. Este endpoint é público, mas protegido por rate limit.

​
Parâmetros de Query

​
link_token
string
required
Token do link de onboarding gerado pela organização pai
​
taxpayer_id
string
required
CPF (pessoa física) ou CNPJ (pessoa jurídica) a ser verificado. Formatação é ignorada — apenas os dígitos são utilizados.
​
seller_type
string
required
Tipo do seller. Valores aceitos: individual (CPF) ou business (CNPJ).

​
Resposta

​
exists
boolean
Indica se o documento já está cadastrado como seller
​
organizations
array
Lista de organizações associadas ao documento (vazio se exists for false)

​
Exemplo

curl -X GET "https://api.chargefy.io/api/v1/embed/onboarding/check-existing?link_token=obl_abc123xyz&taxpayer_id=12345678901&seller_type=individual"

​
Resposta de Exemplo

{
  "exists": true,
  "organizations": [
    {
      "id": "org_xyz456",
      "name": "Empresa Exemplo Ltda",
      "avatar_url": "https://cdn.chargefy.io/avatars/org_xyz456.png"
    }
  ]
}