Não Caia
Integração

Onde usar a API

4 casos concretos com código pronto. Copie, ajuste, suba.

🏦

Banco digital — alertar antes do PIX/TED

Problema: Cliente vai transferir pra alguém novo. Você quer mostrar warning se o destinatário tem padrão de golpe (CPF associado a fraude, email/site suspeito).

ROI: ROI 20-30x: 1 cliente evita perder R$5.000 num PIX golpe = paga vários meses do plano Business

async function flagPixDestination(destinationKey) {
  const r = await fetch('https://www.naocaia.com.br/api/v1/check', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.NAOCAIA_KEY}`,
      'Content-Type': 'application/json',
      'Idempotency-Key': `pix-${destinationKey}-${todayISO()}`,
    },
    body: JSON.stringify({ query: destinationKey, type: 'company' }),
  })
  const data = await r.json()
  return {
    block: data.score <= 19,                      // POSSIVEL_GOLPE
    warn: data.score <= 39,                       // PROVAVEL_GOLPE
    message: data.summary,
    redFlags: data.red_flags,
  }
}
🛒

Marketplace — verificar seller no cadastro

Problema: Novo vendedor cadastra produto. Você quer saber se a empresa é real antes de liberar venda ou repasse de pagamento.

ROI: Bloqueia ~70% dos cadastros golpistas no funil — reduz chargeback e calote

import requests, os

def verify_new_seller(cnpj_or_instagram):
    r = requests.post(
        "https://www.naocaia.com.br/api/v1/check",
        headers={"Authorization": f"Bearer {os.environ['NAOCAIA_KEY']}"},
        json={
            "query": cnpj_or_instagram,
            "type": "instagram" if cnpj_or_instagram.startswith("@") else "company",
        },
        timeout=30,
    )
    data = r.json()
    if data["score"] < 40:
        return {"action": "MANUAL_REVIEW", "reason": data["summary"]}
    if data["score"] < 70:
        return {"action": "LIMITED_VOLUME", "reason": "score moderado"}
    return {"action": "APPROVE"}
📞

SDR / Comercial — qualificar lead antes de discar

Problema: Lead inbound chega via formulário. Você quer descartar empresas-fantasma antes de gastar 30 min de SDR.

ROI: Time comercial economiza 20% do tempo. Lead quality score sobe.

# Webhook recebe lead → enriquece com verdict antes de criar deal no CRM
curl -X POST https://www.naocaia.com.br/api/v1/check \
  -H "Authorization: Bearer $NAOCAIA_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$LEAD_DOMAIN\",\"type\":\"domain\"}" \
  | jq '{tier: (if .score>=70 then "A" elif .score>=40 then "B" else "C" end), score, verdict}'
🛡️

Anti-fraude — sinal complementar a ClearSale/Konduto

Problema: Sua engine de risco precisa de mais um sinal pra discriminar borderlines. Não Caia cobre fraude no Brasil que tools globais não enxergam.

ROI: Adiciona 1 feature ao modelo. Reduz false-positive de bloqueios e false-negative de aprovação.

function naoCaiaFeature(string $sellerDomain): array {
    $ch = curl_init('https://www.naocaia.com.br/api/v1/check');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . getenv('NAOCAIA_KEY'),
            'Content-Type: application/json',
        ],
        CURLOPT_POSTFIELDS => json_encode([
            'query' => $sellerDomain, 'type' => 'domain',
        ]),
    ]);
    $r = json_decode(curl_exec($ch), true);
    return [
        'naocaia_score' => $r['score'] ?? null,
        'naocaia_verdict' => $r['verdict'] ?? null,
        'naocaia_redflag_count' => count($r['red_flags'] ?? []),
    ];
}

Pronto pra começar?

Crie sua API key e teste em 2 minutos. Trial com 3 consultas vitalícias grátis.