Skip to main content
Aciona a validação por inteligência artificial da organização com base nos detalhes submetidos. Se uma validação já estiver em andamento, aguarda o resultado em vez de iniciar uma nova. Se já existir uma revisão salva, retorna o resultado existente sem chamar a IA novamente. Após a validação:
  • PASS: status da organização é atualizado para active
  • FAIL: status é atualizado para denied e blocked_at é definido
  • UNCERTAIN: status permanece inalterado (requer revisão manual)

​
Autenticação

Requer token de usuário (JWT Supabase) via header Authorization: Bearer. O usuário deve pertencer à organização.

​
Parâmetros de Path

​
id
string
required
ID da organização

​
Pré-requisitos

A organização deve ter details_submitted_at definido e ao menos um dos campos preenchidos em details:
  • about
  • product_description
  • intended_use
  • business_type

​
Resposta

​
organization_id
string
ID da organização
​
verdict
string
Resultado: PASS, FAIL ou UNCERTAIN
​
risk_score
number
Pontuação de risco (0–100)
​
violated_sections
array
Seções dos termos violadas (vazio em caso de PASS)
​
reason
string
Explicação do resultado
​
timed_out
boolean
Se a validação atingiu o timeout
​
model
string
Modelo de IA utilizado
​
warning
string
Presente apenas se o resultado foi gerado mas houve falha ao salvar no banco

​
Erros

CódigoDescrição
400Detalhes da organização não foram submetidos ou estão incompletos
403Acesso negado à organização
404Organização não encontrada

​
Exemplo

curl -X POST "https://api.chargefy.io/api/v1/organizations/org_abc123/validate" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Resposta de Exemplo

{
  "organization_id": "org_abc123",
  "verdict": "PASS",
  "risk_score": 12,
  "violated_sections": [],
  "reason": "A organização apresenta atividade legítima e está em conformidade com os termos de uso.",
  "timed_out": false,
  "model": "claude-sonnet-4-6"
}