Web SDKのリリース
DEUNA Web SDKの互換性、主要な公開変更、および主要なCDN統合の安全なアップグレードプロセスを追跡する。
現在のドキュメント例は、固定されている。 https://cdn.deuna.io/web-sdk/v1.7/index.js本番環境でリリースを固定し、サンドボックスで検証し、通常のリリースプロセスを通じてURLの変更を適用する。
アップグレードフロー#
01 · inventory
現在の動作を記録する
SDK URL、有効な体験、コールバック、CSP、およびブラウザマトリックスをキャプチャする。
02 · sandbox
固定されたバージョンを変更する
1つの制御された環境をアップグレードし、アプリケーションキャッシュをクリアする。
03 · verify
支払いマトリックスを実行する
カード、ウォレット、APM、3DS、クローズ、エラー、モバイル幅、およびアクセシビリティをテストする。
04 · release
本番環境を監視する
クライアントエラーとバックエンドの支払い結果を同時に監視する。
主要なリリース#
v1.7.0 · 2026年9月9日
変更
- 内部のウィジェットフレームワークを移行
- ブラウザバンドルの公開に使用されるパッケージマネージャーとビルドツールを更新
アップグレード時に確認する
- モーダルの作成、埋め込みターゲットのレンダリング、
onResize、事前読み込み、およびクローズ。 - すべての有効なウィジェットタイプ:支払い、要素、バウチャー、および次のアクション。
- CSPとアプリケーションキャッシュを新しい固定バンドルに対して。
v1.6.1 · 2026年9月2日
追加および保護
- 親ページのポップアップリダイレクトの処理と外部ポップアップのライフサイクルイベントを改善
- 追加
errorApmMissingReferenceエラーサポート - サポートされているフローで、重複した認証保護のためのアイデンポテンツサポートを追加
- ポップアップ管理とクロスオリジン動作を強化
アップグレード時に確認する
- 3DSと、すべての構成されたAPMのリアルブラウザポップアップ条件でのリダイレクト。
- 顧客のクローズ、ポップアップのクローズ、タイムアウト、およびチェックアウトへの戻り動作。
- あなたのコードは、クロスオリジンポップアップを読み取る必要はありません。
v1.6.0 · 2026年6月10日
- 特定の環境での顧客カードの非表示をサポートする動作オプションを追加。
- 保存されたカードの表示設定を変更する際には、認証済みおよびゲストの認証フローを再テストしてください。
既存の公開API
既存の公開APIは、Payment Widget、Elements、カード vault、デバイスデータの生成、Apple Pay、Google Pay、およびSDKウィジェットフレームワークを確立しました。古いバンドルでの現在のコールバックおよびポップアップ動作を前提とせず、サンドボックスを通じてアップグレードしてください。
互換性契約#
| 表面 | アップグレードの期待 |
|---|---|
| CDNの主要/マイナーパスを固定 | 変更は、商人がスクリプトURLを更新した場合にのみ発生します。 |
| 専用コールバック | 推奨される安定した統合インターフェース。アップグレード後、すべてのハンドラをコンパイルまたは実行してください。 |
| 生のイベントペイロード | 経験固有で、より多くのフィールドを持つ可能性。厳密なオブジェクトの等価性を避けてください。 |
| イベント名 | 拡張可能。未知のイベントに対するフォールバックを維持。 |
| ホストされたUI | サポートされているテーマ契約内で進化可能。スクリーンショットを信号としてテストし、厳密なDOM契約ではありません。 |
| プライベートDOM、iframe、およびshadow-root構造 | 統合APIではありません。クエリまたは変更しないでください。 |
回帰チェックリスト#
- 本番環境相当のCSPの下での成功および失敗の確認。
initialize一度、複数のルート、および隔離newInstance()該当する場合に使用してください。- Payment WidgetおよびElementsをモダールおよび埋め込みモードで動作させる。
- 事前読み込みおよびオンデマンドの起動。
- 制御モード
isValid()およびsubmit()flow. - BIN、分割払い、処理、成功、エラー、終了、サイズ変更、およびイベントコールバック。
- Apple Pay および Google Pay のサポート、および顧客による手動での開始。
- 3DS および APM の外部ポップアップライフサイクル。
- Voucher の表示またはダウンロード、および非同期での注文確認。
- 320px のモバイル幅、キーボードのみでの使用、スクリーンリーダー対応、およびスムーズなアニメーションの制限。