Fluxo simplificado

import { Client } from '@worldfy/security-sdk';

const client = new Client({
  publicKey: 'pk_live_sua_chave',
});
await client.initialize();

const result = await client.preparePayment({
  amount: 15000,
  currency: 'BRL',
  installments: 1,
  card: {
    number: '4000000000002701',
    holderName: 'COMPRADOR TESTE',
    expirationMonth: '12',
    expirationYear: '2030',
    cvv: '123',
  },
  customer: {
    name: 'Comprador Teste',
    email: 'teste@email.com',
    phone: '5511999999999',
  },
  address: {
    street: 'Rua Exemplo',
    number: '123',
    neighborhood: 'Centro',
    city: 'São Paulo',
    state: 'SP',
    zipCode: '01310100',
    country: 'BR',
  },
});

if (result.success) {
  // Envie ao backend para criar a cobrança
  await criarCobranca({
    payment_details: { token: result.token, installments: 1 },
    fraud_session_id: result.fraudSessionId,
    three_ds: result.threeds && {
      cavv: result.threeds.cavv,
      eci: result.threeds.eci,
      xid: result.threeds.xid,
      version: result.threeds.version,
      reference_id: result.threeds.referenceId,
    },
  });
} else {
  console.error(`Falha em: ${result.failedAt}`, result.error.message);
}

const result = await client.preparePayment(dados, {
  skipFraudAnalysis: false,
  skipThreeDS: false,
  threeDSTimeout: 120000,
  onStepChange: (event) => {
    console.log(`${event.step}: ${event.status}`);
  },
});

if (result.success) {
  result.token;          // "tok_abc123..."
  result.brand;          // "visa"
  result.lastFourDigits; // "2701"
  result.firstSixDigits; // "400000"
  result.fraudSessionId; // "550e8400-e29b-41d4-..." | undefined
  result.threeds;        // { status, cavv, eci, xid, ... } | undefined
  result.steps;          // resumo de cada etapa
  result.durationMs;     // tempo total em ms
}

if (!result.success) {
  result.error;          // Error — a exceção que causou a falha
  result.failedAt;       // "fraud_analysis" | "tokenization" | "three_ds"
  result.partialResult;  // dados das etapas que completaram antes da falha
  result.steps;          // resumo de cada etapa (incluindo a falha)
  result.durationMs;     // tempo total em ms
}

const result = await client.preparePayment(dados, {
  onStepChange: ({ step, status }) => {
    // step: 'fraud_analysis' | 'tokenization' | 'three_ds'
    // status: 'started' | 'completed' | 'skipped' | 'failed'

    switch (status) {
      case 'started':
        mostrarLoading(step);
        break;
      case 'completed':
        marcarConcluido(step);
        break;
      case 'skipped':
        marcarIgnorado(step);
        break;
      case 'failed':
        marcarErro(step);
        break;
    }
  },
});

function Checkout() {
  const [currentStep, setCurrentStep] = useState<string | null>(null);
  const [completedSteps, setCompletedSteps] = useState<string[]>([]);

  async function handlePay() {
    const result = await client.preparePayment(formData, {
      onStepChange: ({ step, status }) => {
        if (status === 'started') setCurrentStep(step);
        if (status === 'completed') {
          setCompletedSteps((prev) => [...prev, step]);
          setCurrentStep(null);
        }
      },
    });
    // ...
  }

  return (
    <div>
      <StepIndicator
        steps={['fraud_analysis', 'tokenization', 'three_ds']}
        current={currentStep}
        completed={completedSteps}
      />
      <button onClick={handlePay}>Pagar</button>
    </div>
  );
}

const result = await client.preparePayment(dados);

if (!result.success) {
  switch (result.failedAt) {
    case 'fraud_analysis':
      // Falha na coleta de fingerprint — pode tentar novamente
      // ou prosseguir sem antifraude (se merchant permitir)
      break;

    case 'tokenization':
      // Dados do cartão inválidos ou erro de API
      exibirErro('Verifique os dados do cartão');
      break;

    case 'three_ds':
      // 3DS falhou — token disponível em partialResult
      if (result.partialResult.token) {
        // Decisão do merchant: aceitar sem 3DS?
        const aceitar = await consultarBackend(result.partialResult);
        if (aceitar) {
          await criarCobranca({
            payment_details: { token: result.partialResult.token },
            fraud_session_id: result.partialResult.fraudSessionId,
          });
        }
      }
      break;
  }
}