Pular para o conteúdo principal
Todos os sistemas operacionaisNovidadesv1
Entrar
Web SDK

Lançamentos do SDK para Web

Acompanhe a compatibilidade do SDK para Web da DEUNA, alterações públicas notáveis e um processo de atualização seguro para integrações CDN fixas.

Última atualização: October 16, 2026
Nesta página

A documentação atual fixa https://cdn.deuna.io/web-sdk/v1.7/index.jsFixe um lançamento em produção, valide-o no sandbox e implemente a alteração da URL através do seu processo de lançamento normal.

Fluxo de atualização#

01 · inventory
Registre o comportamento atual
Capture a URL do SDK, experiências habilitadas, callbacks, CSP e a matriz do navegador.
02 · sandbox
Altere a versão fixada
Atualize um ambiente controlado e limpe os caches da aplicação.
03 · verify
Execute a matriz de pagamento
Teste cartões, carteiras, APMs, 3DS, fechar, erros, larguras móveis e acessibilidade.
04 · release
Monitore a produção
Observe os erros do cliente e os resultados de pagamento do backend juntos.

Lançamentos notáveis#

v1.7.0 · 9 de setembro de 2026Linha documentada atual

Atualizado

  • Migrou o framework interno do widget.
  • Atualizou o gerenciador de pacotes e as ferramentas de construção usadas para publicar o pacote do navegador.

Verifique durante a atualização

  • Criação de modais, renderização do alvo incorporado, onResize, pré-carregamento e fechamento.
  • Todos os tipos de widgets habilitados: Pagamento, Elementos, Voucher e Próxima Ação.
  • CSP e cache de aplicação contra o novo pacote fixo.
v1.6.1 · 2 de setembro de 2026Reforço de modais e idempotência

Adicionado e protegido

  • Melhorou o tratamento de redirecionamento de modais da página pai e os eventos de ciclo de vida de modais externos.
  • Adicionado errorApmMissingReference Suporte a erros.
  • Adicionado suporte a idempotência para proteção contra autorização duplicada nos fluxos suportados.
  • Reforçou o gerenciamento de modais e o comportamento de cross-origin.

Verifique durante a atualização

  • 3DS e todos os APM redirecionados configurados nas condições de popup no navegador.
  • Fechamento do cliente, fechamento do modal, timeout e comportamento de retorno para o checkout.
  • Seu código não depende da leitura de um modal cross-origin.
v1.6.0 · 10 de junho de 2026Comportamento de visibilidade da carta salva
  • Adicionou uma opção de comportamento suportada para ocultar as cartas dos clientes nas experiências aplicáveis.
  • Teste novamente os fluxos autenticados e de identidade de convidado sempre que alterar a visibilidade da carta salva.
Linha pública anteriorExperiências do Core Web SDK

A linha pública anterior estabeleceu o Widget de Pagamento, Elementos e o cofre de cartões, a geração de dados do dispositivo, Apple Pay, Google Pay e o framework do widget do SDK. Atualize através do sandbox em vez de assumir o comportamento atual de callback e popup em um pacote mais antigo.

Contrato de compatibilidade#

SuperfícieExpectativa de atualização
Rota CDN principal/secundária definidaApenas quando o comerciante atualiza a URL do script.
Callbacks dedicadosInterface de integração estável preferida; compilar ou testar todos os manipuladores após a atualização.
Payloads de eventos brutosEspecíficos para a experiência e mais propensos a conter campos. Evitar comparação de igualdade estrita de objetos.
Nomes de eventosPodem ser expandidos. Manter um fallback para eventos desconhecidos.
Interface de usuário hospedadaPode evoluir dentro do contrato de tema suportado. Testar capturas de tela como sinais, não contratos DOM exatos.
Estrutura DOM privada, iframe e shadow-rootNão é uma API de integração. Não consultar nem modificar.

Lista de verificação de regressão#

  • Sucesso e falha de carregamento sob o CSP equivalente à produção.
  • initialize Uma vez, múltiplas rotas e isoladas newInstance() Use, se aplicável.
  • Widget e elementos de pagamento em modo de janela modal e incorporado.
  • Pré-carregamento e abertura sob demanda.
  • Controlado isValid() e submit() flow.
  • BIN, parcelamento, processamento, sucesso, erro, fechar, redimensionar e callbacks de eventos.
  • Disponibilidade do Apple Pay e Google Pay, além do lançamento com gesto do cliente.
  • Ciclo de vida externo do 3DS e APM.
  • Exibição ou download de vouchers e confirmação de pedido assíncrona.
  • Largura de 320px para dispositivos móveis, uso apenas com teclado, tela de leitura e redução de movimento.
ComeçarCarregamento e configuração básica do CSP.Widget de pagamentoIntegração de pagamento atual.Eventos do SDKCatálogos de eventos atuais.