Mudanças no Web SDK v1.2

• Data de lançamento: Início 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 v1.1 com opções de personalização aprimoradas e recursos expandidos de controle de fluxo de pagamento.

Opções avançadas de inicialização

Novos parâmetros de inicialização oferecem maior controle sobre o comportamento do SDK para implementações complexas.

1. Opcional options Parâmetro: Suporte para uma opção options parâmetro em Yuno.initializeproporcionando a você mais controle sobre o comportamento do SDK. Essa adição destina-se a equipes com casos de uso avançados ou requisitos personalizados de sessão e rastreamento.

Aprimorado continuePayment Método

A funcionalidade ampliada permite alterações dinâmicas na configuração durante a continuação do pagamento.

2. 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 a idiomas

Cobertura linguística internacional significativamente ampliada para implementações globais:

• 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)

Notas de implementação

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

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

• Aprimorado continuePayment: O método agora aceita substituições de configuração
• Inicialização avançada: Parâmetros opcionais para comportamento personalizado
• 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 capacidades:

// 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"
});

Migração da v1.1

Caminho de atualização suave, sem alterações significativas em relação à v1.1.

Atualização da 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. Considere o uso de parâmetros de inicialização opcionais para casos de uso avançados
4. Não há mudanças significativas - as implementações existentes continuam funcionando

O que está obsoleto

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

Nenhum recurso foi descontinuado na v1.2. Todas as funcionalidades anteriores continuam disponíveis e com suporte.