Mudanças no Web SDK v1.1

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

O que há de novo na v1.1

A versão 1.1 representa uma grande evolução do Web SDK da Yuno, introduzindo operações assíncronas, fluxos de pagamento aprimorados e melhorias significativas de desempenho para aplicativos modernos da Web.

Atualizações de métodos assíncronos

Os principais métodos do SDK agora suportam operações baseadas em promessas para melhor integração com estruturas JavaScript modernas.

1. Métodos baseados em promessas: Principais métodos, como initialize(), mountCheckout()e startCheckout() agora retornam Promises. Essa alteração oferece suporte a um melhor tratamento de fluxos dinâmicos, como 3DS, redirecionamentos do PayPal e renderização personalizada da interface do usuário.

// v1.1 async implementation
const yuno = await Yuno.initialize(PUBLIC_API_KEY)

Aprimorado continuePayment Método

O continuePayment torna-se essencial para lidar com fluxos de pagamento complexos e garantir a conclusão do pagamento.

2. Continuação de pagamentos críticos: Com a introdução de novos métodos de pagamento e fluxos dinâmicos no SDK v1.1, a continuePayment tornou-se mais importante para completar as experiências de pagamento do cliente após a criação do pagamento.

   • Quando usar: Quando a resposta da API inclui sdk_action_required: true, você deve ligar para continuePayment para retomar o processo
   • Manuseio automático: O SDK renderiza automaticamente as telas necessárias (autenticação 3DS, etapas da carteira externa)
   • Comportamento de retorno: Pode retornar um objeto de redirecionamento para tratamento do lado do comerciante; caso contrário, retorna null

Aprimoramentos do 3DS (5 de junho de 2025)

Processo de autenticação 3DS simplificado com maior confiabilidade e requisitos de integração simplificados.

3. Integração simplificada do 3DS: Fluxo 3DS atualizado para aumentar a confiabilidade e simplificar a integração:

   • Não há serviço de configuração separado: A coleta de dados e a configuração do 3DS agora estão incluídas na criação do pagamento
   • Transações assíncronas: Todas as transações 3DS usam redirecionamento para informações e desafios do dispositivo
   • Implementação necessária: Deve ser implementado continuePayment() e yunoPaymentResult() após a criação do pagamento
   • Otimização do desempenho: Acionadores do SDK collect etapa somente quando o 3DS for necessário

Melhorias no desempenho

Otimizações abrangentes em todas as operações do SDK para um processamento de pagamentos mais rápido e confiável.

4. Fluxos otimizados:
   • Redução de chamadas de API desnecessárias
   • Melhoria do desempenho geral
   • Melhor consistência visual
   • Recursos de segurança aprimorados

Comportamento dinâmico do Click-to-Pay (C2P)

Funcionalidade aprimorada de click-to-pay com experiência de usuário melhorada e suporte a comportamento dinâmico.

5. C2P aprimorado: Aprimoramentos abrangentes na funcionalidade click-to-pay:
   • Os Termos e Condições e os logotipos são atualizados dinamicamente com base no cartão
   • As opções C2P estão ocultas para cartões não compatíveis
   • Campo de número de telefone adicionado para registro
   • Configurações de conformidade para privacy e tnc (termos e condições) agora são passados junto com o cartão

Aprimoramentos da interface do usuário

Melhorias significativas no design do formulário de pagamento e na experiência do usuário.

6. Aprimoramentos na visualização de cartões registrados:

   • Os visuais genéricos dos cartões agora aparecem para Visa e Mastercard
   • A American Express exibe o CVV na frente do cartão
   • A visualização do cartão é invertida dinamicamente com base no foco do campo CVV
   • Os títulos dinâmicos se adaptam à entrada inserida pelos usuários
   • Seletor de parcelas reformulado para melhorar a experiência do usuário em dispositivos móveis e computadores
   • Estilo e comportamento consistentes em todas as plataformas

7. Aprimoramentos de layout:

   • Correção da sobreposição entre os campos de tipo de documento e de prestação
   • O layout agora se ajusta adequadamente durante a validação

8. Método de pagamento pré-selecionado:

   • Pré-seleciona automaticamente o último método de pagamento usado (ou o primeiro configurado)
   • Tratamento sem erros de métodos inválidos ou excluídos

9. Gerenciamento do método de pagamento registrado:

   • Os usuários agora podem remover métodos de pagamento salvos diretamente na interface do SDK

10. Entrada de cartão em linha:

    • Os usuários agora podem inserir os detalhes do cartão diretamente abaixo da opção Cartão
    • Compatibilidade total com os fluxos existentes, como parcelas e seletor de cartões
    • Os campos persistem ao trocar de método

Melhorias técnicas

Aprimoramentos de back-end e integração para maior confiabilidade e funcionalidade.

11. ID do cliente de fallback do PayPal:

    • Quando o PayPal clientId não for fornecido na configuração do comerciante, o SDK usará o fallback do paymentByCheckoutSession resposta endpoint

12. Estilo de checkout flexível:

    • Os elementos de ações flexíveis agora suportam estilos personalizados passados por meio do UI no objeto getPaymentByCheckout resposta
    • Garante um design consistente em todas as plataformas e dispositivos

13. Remoção de campo obsoleto:

    • Removido o gender do SDK e da configuração dos campos obrigatórios

14. Atualizações da tela de status:

    • Aprimoramentos visuais em todas as telas de status, proporcionando uma aparência mais limpa

Aprimoramentos na segurança e nos métodos de pagamento

Novas integrações de segurança e suporte ampliado a métodos de pagamento.

15. Novas integrações de segurança:

    • Airwallex: adiciona uma camada de segurança adicional para a Web
    • Forter (Web): Proteção aprimorada de pagamentos graças à tecnologia de prevenção de fraudes da Forter
    • Checkout 3DS: Suporte ao novo provedor 3D Secure. Renderiza a página de autenticação quando o provedor de transação é checkout3ds
    • Unlimit 3DS: Introduziu o suporte 3DS para pagamentos Unlimit, aprimorando a autenticação e a prevenção de fraudes

16. Melhorias nos pagamentos brasileiros:

    • Cartões híbridos: Agora são processados como crédito por padrão, melhorando a conversão para os comerciantes baseados no Brasil
    • Novo método de pagamento por boleto bancário: O Boleto Bancário agora está disponível para todos os comerciantes que operam no Brasil, expandindo as opções de pagamento locais e melhorando a conversão para usuários que preferem métodos off-line

Mudanças na implementação

Mudanças significativas na arquitetura que exigem atualizações nas integrações existentes.

Mudanças significativas em relação à v1.0

• Métodos assíncronos: Todos os principais métodos agora retornam Promessas e exigem await
• continuePayment importância: Agora é fundamental para os fluxos de conclusão de pagamento
• Mudanças no fluxo do 3DS: Não é mais necessária uma configuração separada do 3DS

Etiqueta de script

Atualizado o código-fonte do script para a versão 1.1 com a nova estrutura de URL:

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

Exemplo de migração

Comparação mostrando as principais diferenças entre as implementações da v1.0 e da v1.1:

// v1.0 (synchronous)
const yuno = Yuno.initialize(PUBLIC_API_KEY);
yuno.startCheckout(config);

// v1.1 (asynchronous) 
const yuno = await Yuno.initialize(PUBLIC_API_KEY);
await yuno.startCheckout(config);

// Essential: Implement continuePayment for dynamic flows
if (paymentResponse.sdk_action_required) {
  const result = await yuno.continuePayment();
  // Handle result appropriately
}

Migração da v1.0

Etapas essenciais para atualizar as implementações existentes da v1.0 para a v1.1.

Alterações necessárias:

1. Atualizar a fonte do script para a v1.1
2. Adicionar await para initialize(), mountCheckout()e startCheckout() chamadas
3. Implementar continuePayment() tratamento de fluxos de pagamento dinâmicos
4. Garantir yunoPaymentResult() callback está configurado corretamente
5. Remover todas as chamadas de serviço de configuração do 3DS separadas

Linha do tempo:

• 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

📘

Recursos adicionais

Para obter orientação e exemplos de implementação, visite a página de documentação do Web SDK e o repositório do GitHub para obter mais informações.

O que foi descontinuado na v1.1

Recursos e padrões que não são mais recomendados ou suportados na v1.1.

• Serviço separado de configuração de 3DS: Não é mais necessário; integrado à criação do pagamento
• Chamadas de métodos síncronos: Os métodos agora retornam Promessas e devem usar await
• Manuseio manual do 3DS: O SDK agora lida com fluxos 3DS automaticamente