Rilasci del Web SDK
Monitorare la compatibilità del Web SDK di DEUNA, le modifiche pubbliche significative e un processo di aggiornamento sicuro per le integrazioni CDN fissate.
In questa pagina
La documentazione attuale fissa https://cdn.deuna.io/web-sdk/v1.7/index.js. Fissare un rilascio in produzione, verificarlo in sandbox e distribuire la modifica dell'URL tramite il normale processo di rilascio.
Flusso di aggiornamento#
01 · inventory
Registrare il comportamento corrente
Catturare l'URL dell'SDK, le esperienze abilitate, i callback, CSP e la matrice del browser.
02 · sandbox
Modificare la versione fissata
Aggiornare un ambiente controllato e cancellare la cache dell'applicazione.
03 · verify
Eseguire la matrice di pagamento
Testare le carte, i portafogli, gli APM, 3DS, chiusura, errori, larghezze mobili e accessibilità.
04 · release
Monitorare la produzione
Osservare gli errori del client e i risultati dei pagamenti sul backend insieme.
Rilasci notevoli#
v1.7.0 · 9 settembre 2026
Aggiornato
- Migrato il framework interno del widget.
- Aggiornato il gestore di pacchetti e gli strumenti di build utilizzati per pubblicare il bundle del browser.
Verificare durante l'aggiornamento
- Creazione di moduli, rendering del target integrato,
onResizeprecaricamento e chiusura. - Tutti i tipi di widget abilitati: Pagamento, Elementi, Voucher e Prossima Azione.
- CSP e caching dell'applicazione contro il nuovo bundle.
v1.6.1 · 2 settembre 2026
Aggiunto e protetto
- Migliorato il comportamento di reindirizzamento del popup della pagina padre e gli eventi di ciclo di vita del popup esterno.
- Aggiunto
errorApmMissingReferencesupporto per gli errori. - Aggiunto supporto per l'idempotenza per la protezione della doppia autorizzazione nei flussi supportati.
- Rafforzato la gestione dei popup e il comportamento cross-origin.
Verificare durante l'aggiornamento
- 3DS e ogni APM di reindirizzamento configurato nelle condizioni di popup del browser.
- Chiusura del cliente, chiusura del popup, timeout e comportamento di ritorno al checkout.
- Il tuo codice non dipende dalla lettura di un popup cross-origin.
v1.6.0 · 10 giugno 2026
- Aggiunto un'opzione di comportamento supportata per nascondere le carte dei clienti nelle esperienze pertinenti.
- Riprovare i flussi autenticati e di guest quando si modifica il comportamento di visibilità della carta salvata.
Linea pubblica precedente
La linea pubblica precedente ha stabilito il widget di pagamento, gli elementi, il vault di carte, la generazione di dati del dispositivo, Apple Pay, Google Pay e il framework del widget SDK. Aggiornare tramite sandbox anziché assumere il comportamento attuale di callback e popup su un bundle precedente.
Contratto di compatibilità#
| Superficie | Aspettative di aggiornamento |
|---|---|
| Percorso CDN principale/minore bloccato | Si modifica solo quando il commerciante aggiorna l'URL dello script. |
| Callback dedicati | Superficie di integrazione stabile preferita; compilare o testare ogni gestore dopo l'aggiornamento. |
| Payload di eventi grezzi | Specifici per l'esperienza e più propensi a contenere campi. Evitare l'uguaglianza esatta degli oggetti. |
| Nomi degli eventi | Potrebbero espandersi. Mantenere un fallback per eventi sconosciuti. |
| Interfaccia utente ospitata | Può evolversi all'interno del contratto del tema supportato. Testare screenshot come segnali, non come contratti DOM esatti. |
| Struttura DOM privata, iframe e shadow-root | Non è un'API di integrazione. Non interrogare o modificarla. |
Checklist di regressione#
- Verifica del successo e del fallimento sotto la CSP equivalente alla produzione.
initializeUna volta, più percorsi e isolatinewInstance()Utilizzare se applicabile.- Widget e elementi di pagamento in modalità modale e incorporata.
- Caricamento predefinito e on-demand.
- Controllato
isValid()esubmit()flow. - BIN, rate, elaborazione, successo, errore, chiusura, ridimensionamento e callback degli eventi.
- Disponibilità di Apple Pay e Google Pay, oltre all'avvio tramite gesto del cliente.
- Ciclo di vita esterno 3DS e APM.
- Visualizzazione o download di voucher e conferma d'ordine asincrona.
- Larghezza mobile di 320 px, utilizzo solo con tastiera, screen reader e riduzione del movimento.