💳 CartHero SDK — 3DS 2.x Integration Guide#

⚠️ Importante: o integrador não precisa saber qual adquirente ou provedor 3DS está sendo usado. Isso é resolvido internamente pelo SDK e/ou pelo seu servidor principal.

🚀 Como Incluir#

Opção A — Modo Moderno (ES Modules)#

Opção B — Modo Global (window.ch)#

⚙️ API#

createCh(): ChInstance#

.setBackendUrl(url: string): this#

.setPublicToken(token: string): this#

.encrypt(card: CardData, context: PaymentContext): Promise<PaymentResult>#

// Dados do cartão
type CardData = {
  number: string;
  expMonth: string;
  expYear: string;
  cvv?: string;
};

// Contexto do pagamento
type PaymentContext = {
  amount: number; // em centavos
  currency: string; // "BRL", "USD", ...
  orderId: string;
  customer?: { email?: string; name?: string; phone?: string; };
  returnUrl?: string;
};

// Resultado esperado
type PaymentResult = {
  token: string;
  status?: 'authenticated' | 'frictionless' | 'attempted' | 'failed' | 'error';
  eci?: string;
  cavv?: string;
  xid?: string;
  version?: string;
};

🔐 Comportamento do 3DS#

Nenhuma etapa extra é necessária além do mostrado.

✅ Requisitos do Checkout#

📦 Exemplo Completo (HTML)#

🔒 Segurança e Boas Práticas#

🧰 Soluções de Problemas#

📌 Resumo Final#