Quickstart do SDK de KYC Hospedado

import { createSessionClient } from '@noviuz/kyc-server/bearer';

const kyc = createSessionClient({
  baseUrl: process.env.NOVIUZ_KYC_API_BASE ?? 'https://api.noviuz.com',
  secretKey: process.env.NOVIUZ_KYC_SECRET_KEY!,
});

/**
 * Endpoint do seu backend autenticado chamado pelo seu frontend.
 */
export async function handleStartVerification(userId: string, attemptId: string) {
  // Idempotência estável: repetir com o mesmo ID retorna a mesma sessão
  const idempotencyKey = `kyc:${userId}:${attemptId}`;

  const session = await kyc.mintSession(
    {
      customerType: 'individual', // 'individual' (PF) ou 'business' (PJ)
    },
    {
      idempotencyKey,
    }
  );

  // Retorne apenas o sessionId para o frontend
  return { sessionId: session.sessionId };
}

import React, { useState } from 'react';
import { NoviuzKyc } from '@noviuz/kyc-js';

export function VerificationButton({ userId }: { userId: string }) {
  const [loading, setLoading] = useState(false);

  const startKyc = async () => {
    setLoading(true);
    try {
      // 1. Solicita a sessão à rota autenticada do SEU backend
      const res = await fetch('/api/kyc/start-session', { method: 'POST' });
      const { sessionId } = await res.json();

      // 2. Abre a modal hospedada oficial da Noviuz
      NoviuzKyc.open({
        sessionId,
        onSuccess: ({ sessionId }) => {
          // Notificação visual de conclusão pelo usuário
          console.log('Fluxo visual concluído pelo cliente:', sessionId);
          notifyBackendToReconcile(sessionId);
        },
        onReview: ({ sessionId }) => {
          console.log('Submetido para análise manual:', sessionId);
          notifyBackendToReconcile(sessionId);
        },
        onError: (error) => {
          console.error('Erro na experiência de verificação:', error.code, error.message);
        },
      });
    } finally {
      setLoading(false);
    }
  };

  return (
    <button onClick={startKyc} disabled={loading}>
      {loading ? 'Iniciando...' : 'Verificar Identidade'}
    </button>
  );
}

import { createSessionClient } from '@noviuz/kyc-server/bearer';

const kyc = createSessionClient({
  baseUrl: process.env.NOVIUZ_KYC_API_BASE ?? 'https://api.noviuz.com',
  secretKey: process.env.NOVIUZ_KYC_SECRET_KEY!,
});

export async function reconcileVerification(sessionId: string) {
  try {
    const result = await kyc.getResult(sessionId);

    switch (result.status) {
      case 'approved':
        // Verificação aprovada com sucesso!
        // result.euid contém o identificador patrimonial único gerado
        console.log(`✅ Usuário aprovado com EUID: ${result.euid}`);
        await activateUserAccount({ sessionId, euid: result.euid });
        return { status: 'approved', euid: result.euid };

      case 'under_review':
        // Encaminhado para a mesa de compliance (análise humana)
        console.log(`⏳ Em análise manual: ${sessionId}`);
        await markUserUnderReview({ sessionId });
        return { status: 'under_review' };

      case 'rejected':
      case 'cancelled':
      case 'expired':
        // Reprovado, cancelado pelo usuário ou sessão expirada (410)
        console.log(`❌ Verificação não concluída: ${result.status}`);
        await markUserFailed({ sessionId, status: result.status });
        return { status: result.status };
    }
  } catch (error: any) {
    if (error.status === 409) {
      // 409 NOT_TERMINAL: O usuário ainda está completando etapas
      console.log('Sessão ainda em andamento. Aguarde antes de reconsultar.');
      return { status: 'in_progress' };
    }
    throw error;
  }
}