API CPF e CNPJ para E-commerce: Redução de Chargebacks e Fraudes

# Node.js exemplo para validação checkout
const axios = require('axios');

async function validarDocumentoCheckout(documento, tipo, nomeDeclarado) {
  /**
   * Valida CPF/CNPJ durante checkout e-commerce
   * Retorna: { valido: boolean, mensagem: string, dados: object }
   */
  const docLimpo = documento.replace(/[^0-9]/g, '');
  const endpoint = tipo === 'cpf' ? 'cpf' : 'cnpj';

  try {
    const response = await axios.get(
      `https://api.cpfcnpj.com.br/${TOKEN}/${PACKAGE}/${docLimpo}`,
      { timeout: 15000 }
    );
    const resultado = response.data;

    // 1. Valida existência e situação
    if (!resultado.valido) {
      return {
        valido: false,
        mensagem: tipo === 'cpf'
          ? 'CPF inválido. Verifique os números digitados.'
          : 'CNPJ inválido. Verifique os números digitados.',
        bloqueiaCheckout: true
      };
    }

    // 2. Verifica situação cadastral
    const situacoesInvalidas = tipo === 'cpf'
      ? ['CANCELADO', 'SUSPENSO', 'NULO', 'CANCELADO POR MULTIPLICIDADE']
      : ['BAIXADA', 'INAPTA', 'SUSPENSA'];

    if (situacoesInvalidas.includes(resultado.situacao)) {
      return {
        valido: false,
        mensagem: `${tipo.toUpperCase()} está ${resultado.situacao}.
          Use outro documento ou regularize sua situação.`,
        bloqueiaCheckout: true,
        situacao: resultado.situacao
      };
    }

    // 3. Cross-valida nome (flexível para apelidos/abreviações)
    const nomeOficial = resultado.nome || resultado.razao_social;
    const scoreNome = calcularSimilaridadeNome(
      nomeDeclarado.toUpperCase(),
      nomeOficial.toUpperCase()
    );

    if (scoreNome < 0.40) {
      // Divergência muito alta - bloqueia
      return {
        valido: false,
        mensagem: `Nome declarado não confere com ${tipo.toUpperCase()}.
          Verifique se digitou corretamente.`,
        bloqueiaCheckout: true,
        scoreNome
      };
    }

    // 4. Sucesso - registra dados para NF-e
    await salvarDadosNFe({
      documento: docLimpo,
      nome: nomeOficial,
      endereco: resultado.endereco || null,
      dadosCompletos: resultado
    });

    return {
      valido: true,
      mensagem: 'Documento validado com sucesso.',
      bloqueiaCheckout: false,
      dados: resultado,
      scoreNome
    };

  } catch (error) {
    // Erro de API: permite checkout mas registra para revisão
    console.error('Erro validação API:', error);

    return {
      valido: true, // não bloqueia por falha técnica
      mensagem: 'Prosseguindo com validação padrão.',
      bloqueiaCheckout: false,
      falhaAPI: true
    };
  }
}