Mudanças no Web SDK v1.0

• Data de lançamento: Início de 2025
• Status: Versão original (substituída pela v1.1)

O que há de novo na v1.0

A versão inicial do Web SDK da Yuno apresenta recursos abrangentes de integração de pagamentos com suporte para vários tipos de SDK, métodos de pagamento e abordagens de integração.

Lançamento inicial

A versão básica do SDK Web da Yuno oferece funcionalidade completa de processamento de pagamentos em diferentes padrões de integração.

Recursos principais do SDK

O Yuno v1.0 inclui quatro abordagens distintas de SDK para atender a diferentes necessidades de integração:

1. SDK de checkout completo: Formulário de pagamento completo com vários métodos de pagamento e interface de usuário completa
2. Lite Checkout SDK: Fluxo de pagamento simplificado para integrações mais simples
3. Seamless SDK: Componentes de pagamento personalizáveis para experiências de marca
4. Headless SDK: abordagem API-first para implementações de interface do usuário personalizadas

Suporte a métodos de pagamento

Suporte abrangente para métodos de pagamento globais e regionais:

• Cartões de crédito e débito
• Carteiras digitais (PayPal, Apple Pay, Google Pay)
• Transferências bancárias e débitos diretos
• Métodos de pagamento locais por região
• Várias moedas e países

Métodos de integração

Opções flexíveis de implementação para se adequar a diferentes fluxos de trabalho de desenvolvimento:

• Tag de script HTML: Inclusão de script simples para configuração rápida
• JavaScript dinâmico: Carregamento programático para configurações avançadas
• Módulo NPM: Suporte à integração de estruturas JavaScript modernas

Suporte a vários idiomas

Suporte internacional inicial em sete idiomas:

• Espanhol (es)
• Inglês (en)
• Português (pt)
• Filipino (fil)
• Indonésio (id)
• Malaio (ms)
• Tailandês (th)

Implementação

Etiqueta de script

Integração simples usando a inclusão de tags de script HTML padrão:

<script src="https://sdk-web.y.uno/v1/static/js/main.min.js"></script>

Uso básico

Inicialização síncrona padrão e processo de checkout para a v1.0:

// v1.0 synchronous initialization
const yuno = Yuno.initialize(PUBLIC_API_KEY)

yuno.startCheckout({
  checkoutSession: "438413b7-4921-41e4-b8f3-28a5a0141638",
  elementSelector: "#root",
  country_code: "FR",
  language: "fr",
  showLoading: true,
  issuersFormEnable: true,
  showPaymentStatus: true,
  card: {
    isCreditCardProcessingOnly: true,
  },
  onLoading: (args) => {
    console.log(args);
  },
  yunoPaymentMethodSelected: () => {
    console.log("Payment method selected");
  },
  yunoPaymentResult: (status) => {
    console.log("Payment result:", status);
  },
  yunoError: (message, data) => {
    console.error("Payment error:", message, data);
  },
});

Principais métodos

Métodos principais disponíveis na versão inicial v1.0:

• Yuno.initialize(): Initialize o SDK com a chave de API pública
• startCheckout(): Iniciar o processo de pagamento com a configuração
• mountCheckout(): Montar o formulário de pagamento no elemento DOM especificado
• startPayment(): Iniciar o fluxo de pagamento após a seleção do cliente

O que está obsoleto

Esta é a versão inicial - não há recursos obsoletos no lançamento.

Notas de migração

Das versões beta anteriores

Se estiver atualizando a partir de qualquer versão de pré-lançamento ou beta:

1. Atualize a fonte do script para o URL da versão estável v1.0
2. Certifique-se de que todas as chamadas de método usem as assinaturas finais da API v1.0
3. Verifique se a criação da sessão de checkout segue o formato estável da API
4. Teste completamente os fluxos de pagamento em seu ambiente sandbox

Olhando para o futuro

Embora a v1.0 forneça uma base sólida, saiba que:

• A versão 1.1 apresenta métodos assíncronos: As versões futuras passarão a usar APIs baseadas em promessas
• Fluxos de pagamento aprimorados: Versões posteriores adicionarão métodos aprimorados de continuação de pagamento
• Alterações na integração do 3DS: As versões futuras simplificarão a configuração e o manuseio do 3DS

Para obter as informações mais atualizadas, consulte sempre a documentação mais recente do SDK e considere o planejamento para futuras migrações de versão.