# SDK release notes

> This document outlines the new features, enhancements, and bug fixes included in this release.

  

<!-- ToggleTab query="platform" -->

**Tab: Web**

## V2.0.11 {#jqMFv}

 Release date: 2026.04.08

### New features {#hsfXw}

 - Standalone constructor model:
- Added the [*merchantAppointParam*](https://yuque.antfin.com/zgy01855417/hgbbbf/nfm6fav3zqcug7q7#KJPse) parameter to the `[mount()](https://docs.antom.com/ac/sdks/web_mount.md)` method to represent merchant‑specified parameters.
  - Added a new `[billingAddressChanged](https://docs.antom.com/ac/sdks/web_on.md#c2hJp)` event to the `[on()](https://docs.antom.com/ac/sdks/web_on.md)` method, which fires when the billing address information changes.
  - Added the *name* parameter to the `[paymentMethodChanged](https://docs.antom.com/ac/sdks/web_on.md#Vherk)` event callback data in the `[on()](https://docs.antom.com/ac/sdks/web_on.md)` method to indicate the payment method name.
- Factory pattern model:
- Added the `[loadAntom()](https://docs.antom.com/ac/sdks/web_loadAntom.md)` method to load and initialize the `antom` instance, supporting both CDN and npm integration methods.
  - Added the `[antom.createElement()](https://docs.antom.com/ac/sdks/web_antom-createElement.md)` method to create a standalone card‑vaulting element (`VaultingElement`) or a CVV input element (`CVVElement`), with support for custom appearance and multilingual configuration.
  - Added the `[antom.confirmPayment()](https://docs.antom.com/ac/sdks/web_antom-confirmPayment.md)` method for initiating payments in saved‑card scenarios.
  - Added the `[antom.confirmCardSetup()](https://docs.antom.com/ac/sdks/web_antom-confirmCardSetup.md)` method to confirm and submit card setup requests, supporting a redirect strategy to control post‑binding navigation behavior.
  - Added the `[antom.destroy()](https://docs.antom.com/ac/sdks/web_antom-destroy.md)` method to destroy the `antom` instance.
  - Added `[element.on()](https://docs.antom.com/ac/sdks/web_element-on.md)`, `[element.mount()](https://docs.antom.com/ac/sdks/web_element-mount.md)`, `[element.unmount()](https://docs.antom.com/ac/sdks/web_element-unmount.md)`, `[element.destroy()](https://docs.antom.com/ac/sdks/web_element-destroy.md)`, and `[element.updateConfig()](https://docs.antom.com/ac/sdks/web_element-updateConfig.md)` methods returned by the `element` instance.
- Added pre-quote functionality to the Element component, supporting both APO and Antom business scenarios.
- Enabled buyers to switch processing currencies. Merchants can call the price inquiry API to fetch real-time exchange rate.
- Added support for displaying descriptions of payment methods.

### Enhanced features {#JHoBc}

 - Optimized the 3D Secure popup by adding a loading state while the iframe is being loaded.
- Improved the 3D Secure popup interface for better adaptation to dark backgrounds.
- Enhanced the display of card icons in saved card scenarios, fixing the issue of blurry icons in dark themes, and unified the card icon background color with the payment list to a consistent white background.
- Optimized the visual style of the Element Tabs component.
- Optimized the desensitization display of the card number input field. Merchants can now specify how card numbers are masked when displayed in the Card Element module.

### Bug fixes {#ozsBP}

 - Fixed an issue where calling the   `[on()](https://docs.antom.com/ac/sdks/web_on.md)`   method after invoking   `[mount()](https://docs.antom.com/ac/sdks/web_mount.md)`   caused an error.
- Fixed an issue where calling the   `[on()](https://docs.antom.com/ac/sdks_zh-cn/web_on.md)`   method in the express checkout scenario did not display an error message.
- Fixed an issue where the   [Google Pay](https://docs.antom.com/ac/antomop/googlepay.md)   button displayed an incorrect background color in dark mode on Chrome.
- Fixed an issue where the   [Apple Pay](https://docs.antom.com/ac/antomop/applepay.md)   integration in the SDK used hardcoded production environment parameters, ensuring the environment now correctly switches based on the configuration.
- Fixed an issue where the background page scrolled simultaneously when scrolling a popup.

### **Removed features** {#BZaUD}

 - Removed   `valuesChanged`   event in the   `[on()](https://docs.antom.com/ac/sdks/web_on.md)`  method.
- Removed log control printing.

### **Upgrade notes** {#zBIcK}

 - The newly added factory pattern methods operate independently from the existing    AMSElement    pattern integration. This ensures full backward compatibility and will not impact any current implementations.
- Before calling  `[antom.confirmCardSetup()](https://docs.antom.com/ac/sdks_zh-cn/web_antom-confirmCardSetup.md)`  , you must first call   `[element.mount()](https://docs.antom.com/ac/sdks_zh-cn/web_element-mount.md)`   to mount the element to the DOM.

## V2.0.5 {#hgVAG}

 Release date: 2026.01.24

### New features {#XcdoK}

 - Added the   [*options.handleActions*](https://docs.antom.com/ac/sdks/web_submitPayment.md#yVmLP)   parameter to the   `[submitPayment()](https://docs.antom.com/ac/sdks/web_submitPayment.md)`   method, indicating whether the SDK should automatically handle subsequent actions such as redirection or app invocation.
- Added the   [*options.shippingInfo*](https://docs.antom.com/ac/sdks/web_submitPayment.md#Am5lZ)   parameter to the   `[submitPayment()](https://docs.antom.com/ac/sdks/web_submitPayment.md)`   method, used to submit shipping address information.
- Added the   `[on()](https://docs.antom.com/ac/sdks/web_on.md)`   method for event listening.
- Added the     *appearance.accordion.showRadio*     CSS variable to   [Appearance    customization](https://docs.antom.com/ac/cashierpay/appearance.md)  , controlling whether radio buttons are displayed in the Accordion payment list.
- Added the     *appearance.variables.stroke-default*     CSS variable to   [Appearance customization](https://docs.antom.com/ac/cashierpay/appearance.md)  , controlling the border style of inactive containers.
- Added the     *appearance.variables.stroke-active*     CSS variable to   [Appearance customization](https://docs.antom.com/ac/cashierpay/appearance.md)  , controlling the border style of active containers.

### **Upgrade notes** {#BpxUw}

 - Compatibility: Custom redirect control (when   [*options.handleActions*](https://docs.antom.com/ac/sdks/web_submitPayment.md#yVmLP)   is set to   `false`  ) is only supported in scenarios other than card payments,   [Apple Pay](https://docs.antom.com/ac/antomop/applepay.md)  , or   [Google Pay](https://docs.antom.com/ac/antomop/googlepay.md)  . When integrating card payments,   [Apple Pay](https://docs.antom.com/ac/antomop/applepay.md)  , or   [Google Pay](https://docs.antom.com/ac/antomop/googlepay.md)  , this configuration should be excluded to avoid potential risks caused by future hot updates.

  

## V1.47.1 {#EfjMX}

 Release date: 2025.11.21

### New features {#wdAZC}

 - Added Luhn algorithm validation for card number entry in the Payment Element card payment.
- Added the ability to customize the hiding of card brands via the   [Appearance customization](https://docs.antom.com/ac/cashierpay/appearance.md)   for Payment Element card payment methods.

## V1.47.0 {#DMS8R}

 Release date: 2025.11.19

### New features {#L0otj}

 - Added partial card installment payment capabilities in Checkout Page (CKP) and Payment Element.

### Enhanced features {#JtzkY}

 - Enhanced form error message display.
- Enhanced    the judgment capability of        *customUserAgent*     to avoid false positives.
- Enhanced the EasySafePay interface redirection capability to improve the redirection success rate.

**Tab: iOS**

## V1.53.0 {#VHjYX}

 Release date: 2026.03.13

### Enhanced features {#TkdmS}

 - Optimized     *sessionData*     parameter passing logic: The SDK now sends full     *sessionData*     to the frontend instead of partial data, and the backend routes requests to different system architectures based on whether the     *sessionData*     is full or partial.

## V1.51.0 {#QcH47}

 Release date: 2026.02.09

### Enhanced features {#ZTnuk}

 - Optimized the pop‑up animation effect of the Payment Element checkout.

## V1.50.0 {#UpPzh}

 Release date: 2026.02.02

### Enhanced features {#RzT7N}

 - Optimized the tracking logic for Element event callbacks.
- Optimized the     *sessionData*     parameter passing logic of the Element   `sdkAction.query`   method to ensure all data is fully transmitted.
- Fixed the issue where the cashier in the sandbox environment mistakenly calls production workflows.

## V1.49.0 {#UDUGc}

 Release date: 2025.12.29

### New features {#a3xnh}

 - Added the     *notRedirectAfterComplete*     parameter to the   `action.query`   method in the Payment Element iOS request.
- Fixed the issue where the     **Cancel**     button on the 3D channel page did not respond.

## V1.47.0 {#dTq0X}

 Release date: 2025.11.19

### New features {#mBhzN}

 - Added partial card installment payment capabilities in Checkout Page (CKP) and Payment Element.

### Enhanced features {#JJ03F}

 - Enhanced form error message display.
- Enhanced    the judgment capability of        *customUserAgent*     to avoid false positives.
- Enhanced the EasySafePay interface redirection capability to improve the redirection success rate.

**Tab: Android**

## V1.53.0 {#VHjYX}

 Release date: 2026.03.13

### Enhanced features {#TkdmS}

 - Optimized     *sessionData*     parameter passing logic: The SDK now sends full     *sessionData*     to the frontend instead of partial data, and the backend routes requests to different system architectures based on whether the     *sessionData*     is full or partial.

## V1.52.0 {#mwaDV}

 Release date: 2026.02.26

### Enhanced features {#GIuSk}

 - Modified the names of JavaScript files in the project. The specific changes are as follows:

   - h5_bridge.js changed to antom_h5_bridge.js
  - h5_performance.js changed to antom_h5_performance.js

## V1.51.0 {#H79u1}

 Release date: 2026.02.09

### Enhanced features {#rl81v}

 - Optimized the pop‑up animation effect of the Payment Element checkout.

## V1.50.0 {#wNMCp}

 Release date: 2026.02.02

### Enhanced features {#g1YO7}

 - Optimized the     *sessionData*     parameter passing logic of the Element   `sdkAction.query`   method to ensure all data is fully transmitted.

## V1.49.0 {#ZRsLl}

 Release date: 2025.12.29

### Enhanced features {#HFkyd}

 - Optimized event code callback tracking for Payment Element Android.
- Fixed an issue where the 3D Secure verification callback (POST Redirect) URL for card payments was abnormal in Android embedded scenarios.
- Optimized the EasySafePay SDK code and fixed potential null pointer issues.

## V1.47.0 {#qNGNF}

 Release date: 2025.11.19

### New features {#ovXXE}

 - Added partial card installment payment capabilities in Checkout Page (CKP) and Payment Element.

### Enhanced features {#s2uNP}

 - Enhanced form error message display.
- Enhanced    the judgment capability of        *customUserAgent*     to avoid false positives.
- Enhanced the EasySafePay interface redirection capability to improve the redirection success rate.

<!-- /ToggleTab -->