Skip to main content
Verifica se já existe uma organização registrada na plataforma com o CPF ou CNPJ informado. Útil para evitar duplicidades durante o onboarding de novos vendedores em plataformas multivendedor.

​
Autenticação

Requer Organization Access Token (OAT) via header Authorization: Bearer.

​
Parâmetros de Query

​
taxpayer_id
string
required
CPF ou CNPJ do vendedor (somente números). Exemplo: 12345678901 para CPF ou 12345678000195 para CNPJ.
​
seller_type
string
required
Tipo do vendedor. Valores aceitos: individual (pessoa física) ou business (pessoa jurídica).

​
Resposta

​
exists
boolean
Indica se já existe ao menos uma organização cadastrada com o taxpayer_id informado.
​
organizations
array
Lista de organizações encontradas para o taxpayer_id informado.

​
Exemplo

curl -X GET "https://api.chargefy.io/api/v1/sdk/organizations/check-existing?taxpayer_id=12345678901&seller_type=individual" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"

​
Resposta de Exemplo

{
  "exists": true,
  "organizations": [
    {
      "id": "org_01j9abc111",
      "name": "Vendedor Alpha",
      "avatar_url": "https://cdn.chargefy.io/avatars/org_01j9abc111.png"
    }
  ]
}