SDK release notes
Web
iOS
Android
Flutter
V2.0.11
Release date: 2026.04.08
New
- Standalone constructor model:
- Added the merchantAppointParam parameter to the method to represent merchant‑specified parameters.
- Added a new event to the method, which fires when the billing address information changes.
- Added the name parameter to the event callback data in the method to indicate the payment method name.
- Factory pattern model:
- Added the method to load and initialize the antominstance, supporting both CDN and npm integration methods.
- Added the 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 method for initiating payments in saved‑card scenarios.
- Added the method to confirm and submit card setup requests, supporting a redirect strategy to control post‑binding navigation behavior.
- Added the method to destroy the antominstance.
- Added , , , , and methods returned by the elementinstance.
- 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.
Enhancements
- 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
- Fixed an issue where calling the method after invoking caused an error.
- Fixed an issue where calling the method in the express checkout scenario did not display an error message.
- Fixed an issue where the Google Pay button displayed an incorrect background color in dark mode on Chrome.
- Fixed an issue where the Apple Pay 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.
Deprecation
- Deprecated valuesChangedevent in the method.
- Deprecated log control printing.
Upgrade notes
- 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, you must first call to mount the element to the DOM.
V2.0.5
Release date: 2026.01.24
New
- Added the options.handleActions parameter to the method, indicating whether the SDK should automatically handle subsequent actions such as redirection or app invocation.
- Added the options.shippingInfo parameter to the method, used to submit shipping address information.
- Added the method for event listening.
- Added the appearance.accordion.showRadio CSS variable to Appearance customization, controlling whether radio buttons are displayed in the Accordion payment list.
- Added the appearance.variables.stroke-default CSS variable to Appearance customization, controlling the border style of inactive containers.
- Added the appearance.variables.stroke-active CSS variable to Appearance customization, controlling the border style of active containers.
Upgrade notes
- Compatibility: Custom redirect control (when options.handleActions is set to false) is only supported in scenarios other than card payments, Apple Pay, or Google Pay. When integrating card payments, Apple Pay, or Google Pay, this configuration should be excluded to avoid potential risks caused by future hot updates.
V1.47.1
Release date: 2025.11.21
New
- 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 for Payment Element card payment methods.
V1.47.0
Release date: 2025.11.19
New
- Added partial card installment payment capabilities in Checkout Page (CKP) and Payment Element.
Enhancements
- 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.
V2.3.0
Release date: 2026.07.06
Enhancements
- Added support for merchants to manage and sort in-app Element payment methods through Antom Dashboard.
- Added support for phased rollout after the frontend Element architecture upgrade.
- Added stage-specific timestamps to provide frontend applications with detailed process performance data.
V2.1.0
Release date: 2026.04.27
New
- Added an INVALID_REDIRECT_URLevent callback in the iOS SDK for cases where the front-end invocation ofonRedirect()fails to initiate a redirect.
V2.0.1
Release date: 2026.04.10
Enhancements
- Completed full compatibility updates for Xcode 26 on iOS.
Bug fixes
- Resolved incorrect resource images in iOS 2.0.0.
- Resolved potential naming conflicts for certain method definitions in iOS 2.0.0.
V2.0.0
Release date: 2026.03.30
New
- Added standalone card binding (Vaulting Element) capability.
- Added confirmPayment()method for Payment Element to support payments with stored cards.
Enhancements
- Implemented partial compatibility updates for Xcode 26 on iOS.
- Restructured the SDK to support minimal modular integration, allowing products to include only necessary components and optimize package size.
V1.53.0
Release date: 2026.03.13
Enhancements
- 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
Release date: 2026.02.09
Enhancements
- Optimized the pop‑up animation effect of the Payment Element checkout.
V1.50.0
Release date: 2026.02.02
Enhancements
- Optimized the tracking logic for Element event callbacks.
- Fixed the issue where the cashier in the sandbox environment mistakenly calls production workflows.
V1.49.0
Release date: 2025.12.29
New
- Fixed the issue where the Cancel button on the 3D channel page did not respond.
V1.47.0
Release date: 2025.11.19
New
- Added partial card installment payment capabilities in Checkout Page (CKP) and Payment Element.
Enhancements
- 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.
V2.3.1
Release date: 2026.07.21
Bug fixes
- Fixed an issue in the Android SDK where calling public APIs in an unexpected order could cause execution errors.
- Fixed an issue in the Android SDK where the showLoading configuration did not take effect after being set.
V2.3.0
Release date: 2026.07.06
Enhancements
- Added support for merchants to manage and sort in-app Element payment methods through Antom Dashboard.
- Added support for phased rollout after the frontend Element architecture upgrade.
- Added stage-specific timestamps to provide frontend applications with detailed process performance data.
V2.2.0
Release date: 2026.04.27
Enhancements
- Alipay-related code for the EasySafePay product has been migrated into the EasySafePay product resources, removing the need for separate integration.
V2.1.0
Release date: 2026.04.27
New
- Added an INVALID_REDIRECT_URLevent callback in the Android SDK for cases where the front-end invocation ofonRedirect()fails to initiate a redirect.
Enhancements
- The Android SDK's compileSdkVersionhas been upgraded to 35.
Bug fixes
- After the Android SDK launches the payment page, if an internal API call times out, it will no longer send the INITIALIZE_WEB_TIMEOUTevent code.
V2.0.0
Release date: 2026.03.30
New
- Added standalone card binding (Vaulting Element) capability.
- Added confirmPayment()method for Payment Element to support payments with stored cards.
Enhancements
- Restructured the SDK to support minimal modular integration, allowing products to include only necessary components and optimize package size.
V1.53.0
Release date: 2026.03.13
Enhancements
- 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
Release date: 2026.02.26
Enhancements
- 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
Release date: 2026.02.09
Enhancements
- Optimized the pop‑up animation effect of the Payment Element checkout.
V1.49.0
Release date: 2025.12.29
Enhancements
- 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
Release date: 2025.11.19
New
- Added partial card installment payment capabilities in Checkout Page (CKP) and Payment Element.
Enhancements
- 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.
V1.2.1
Release date: 2026.07.21
Bug fixes
- (Android) Fixed an issue in the SDK where calling public APIs in an unexpected order could cause execution errors.
- (Android) Fixed an issue in the SDK where the showLoading configuration did not take effect after being set.
V1.2.0
Release date: 2026.07.06
Enhancements
- (iOS) Completed full compatibility updates for Xcode 26.
- Upgraded the Native SDK dependency used by the Flutter SDK to version 2.3.0.
- Added support for merchants to manage and sort in-app Element payment methods through Antom Dashboard.
- Added support for phased rollout after the frontend Element architecture upgrade.
- Added stage-specific timestamps to provide frontend applications with detailed process performance data.
- (Android) Alipay-related code for the EasySafePay product has been migrated into the EasySafePay product resources, removing the need for separate integration.
- (Android) The Android SDK's compileSdkVersionhas been upgraded to 35.
- (iOS & Android) Added an INVALID_REDIRECT_URLevent callback in the Android SDK and iOS SDK for cases where the front-end invocation ofonRedirect()fails to initiate a redirect.
Bug fixes
- (Android) After the SDK launches the payment page, if an internal API call times out, it will no longer send the INITIALIZE_WEB_TIMEOUTevent code.
- (iOS) Resolved incorrect resource images in v2.0.0.
- (iOS) Resolved potential naming conflicts for certain method definitions in v2.0.0.
V1.1.0
Release date: 2026.03.30
New
- Added standalone card binding (Vaulting Element) capability.
- Added method for Payment Element to support payments with stored cards.
Enhancements
- (iOS) Implemented partial compatibility updates for Xcode 26.
- (iOS & Android) Restructured the SDK to support minimal modular integration, allowing products to include only necessary components and optimize package size.
- (Android) Optimized obfuscation rules to avoid affecting the host app.
- (Android) Renamed JS script resources to improve resource management stability.
- (iOS & Android) Optimized the pop‑up animation effect of the Payment Element.
- (iOS) Optimized the tracking logic for iOS Element event code callbacks.
Bug fixes
- Fixed an issue in Flutter multi-engine scenarios where the SDK might fail to obtain the Activity or Context correctly.
V1.0.1
Release date: 2025.12.30
Enhancements
- Upgraded the Native SDK dependency used by the Flutter SDK to version 1.49.0.
- (Android) Optimized the tracking logic for Element event code callbacks to improve the accuracy and stability of data collection.
Bug fixes
- (iOS) Fixed an issue in the Flutter SDK where the Cancel button on the 3D channel page did not respond.
V1.0.0
Release date: 2025.12.05
New
- Initial release of Payment Element Flutter SDK.