Lite Web SDK v1.2 Changelog

• Data de lançamento: Abril de 2025
• Status: Versão anterior (substituída pela v1.3)

O que há de novo na v1.2

A versão 1.2 baseia-se na estrutura simplificada da Lite v1.1, com capacidades aprimoradas de controle do fluxo de pagamentos e suporte a idiomas internacionais significativamente ampliado.

Aprimorado continuePayment Método

A funcionalidade expandida permite alterações dinâmicas na configuração durante a continuação do pagamento, para implementações mais flexíveis.

1. Estendido continuePayment Funcionalidade: A partir da versão 1.2.0, o continuePayment agora aceita propriedades adicionais que antes só estavam disponíveis em startCheckout. Isso permite que você substitua configurações específicas ao continuar um pagamento.

Novo continuePayment Propriedades

A lista completa de opções de configuração agora está disponível em continuePayment:

continuePayment({
  checkoutSession?: string
  showPaymentStatus?: boolean
  yunoPaymentResult?: (status: string) => void
  yunoError?: (message: string, data?: unknown) => void
  countryCode?: string
  language?: string
})

Parâmetros aprimorados:

• checkoutSession: Substituir a sessão de checkout para o pagamento atual
• showPaymentStatus: Controle se a página Status de pagamento do Yuno deve ser exibida
• yunoPaymentResult: Retorno de chamada personalizado para tratamento de resultados de pagamento
• yunoError: Callback de tratamento de erros personalizado
• countryCode: Especifique o código do país durante a continuação do pagamento
• languageDefina a preferência de idioma durante a continuação do pagamento.

Suporte ampliado ao idioma

Cobertura linguística internacional significativamente ampliada para Lite SDK globais Lite SDK :

• Principais idiomas: Espanhol (es), português (pt), indonésio (id), malaio (ms), tailandês (th)
• Idiomas asiáticos: Filipino (fil), chinês tradicional (zh-TW), chinês simplificado (zh-CN), vietnamita (vi), coreano (ko), japonês (ja)
• Idiomas europeus: Francês (fr), polonês (pl), italiano (it), alemão (de), russo (ru), turco (tr), holandês (nl), sueco (sv)

Mudanças na implementação

Considerações importantes para a implementação e migração do Lite v1.2.

Principais alterações em relação à v1.1

• Aprimorado continuePayment: O método agora aceita substituições de configuração
• Opções de idioma ampliadas: suporte para 18 idiomas contra 7 na versão 1.1
• Compatibilidade com versões anteriores: Todas as funcionalidades da v1.1 continuam sendo suportadas

Etiqueta de script

Atualização da fonte do script para a funcionalidade da versão 1.2:

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

Exemplo de uso

Demonstração de aprimoramento continuePayment recursos no Lite SDK:

// Enhanced continuePayment with configuration override
yuno.continuePayment({
  checkoutSession: "438413b7-4921-41e4-b8f3-28a5a0141638",
  showPaymentStatus: true,
  yunoPaymentResult: (status) => {
    console.log("Payment completed with status:", status);
  },
  yunoError: (message, data) => {
    console.error("Payment error:", message, data);
  },
  countryCode: "US",
  language: "en"
});

Exemplo de implementação completa

Implementação completa do Lite v1.2 mostrando recursos aprimorados:

// Lite v1.2 implementation with enhanced continuePayment
const yuno = await Yuno.initialize(PUBLIC_API_KEY)

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

// Enhanced continuePayment with overrides
if (paymentResponse.sdk_action_required) {
  const result = await yuno.continuePayment({
    countryCode: "DE",
    language: "de",
    showPaymentStatus: false,
    yunoPaymentResult: (status) => {
      console.log("Payment continued with result:", status);
    }
  });
}

Migração da v1.1

Atualização tranquila, sem alterações significativas em relação à versão Lite v1.1.

Atualização da versão Lite v1.1 para a v1.2:

1. Atualizar a fonte do script para a versão 1.2
2. Opcionalmente, aproveite o novo continuePayment parâmetros para controle aprimorado
3. Aproveite o suporte ampliado a idiomas para implementações internacionais.
4. Não há mudanças significativas - as implementações existentes continuam funcionando

Cronograma de migração

• Sandbox: Alterações ativas a partir de 5 de junho de 2025
• Produção: Alterações ativas a partir de 5 de setembro de 2025

O que está obsoleto

Versão totalmente compatível com versões anteriores, sem recursos obsoletos.

Nenhum recurso foi descontinuado na versão Lite v1.2. Todas as funcionalidades anteriores continuam disponíveis e são suportadas.

Benefícios Lite SDK

O Lite Web SDK .2 mantém sua abordagem simplificada e, ao mesmo tempo, adiciona recursos poderosos:

• Complexidade simplificada: recursos aprimorados sem opções de configuração excessivas
• Alcance global: suporte linguístico ampliado para mercados internacionais
• Fluxos flexíveis: Aprimorado continuePayment para cenários de pagamento dinâmicos
• Migração fácil: atualizações compatíveis com versões anteriores a partir da v1.1

📘

Foco no Lite SDK

O Lite Web SDK .2 continua a fornecer funcionalidades essenciais de pagamento com recursos aprimorados. Para comerciantes que precisam de recursos mais avançados ou opções de personalização, considere o Full Web SDK para obter soluções abrangentes de processamento de pagamentos.

📘

Recursos adicionais

Para obter orientações e exemplos de implementação, consulte a Lite Web SDK e o repositório GitHub para obter mais informações.