SDK 发布说明
Web
V2.0.11
发布日期：2026.04.08
新增功能
- 独立构造类模型：
- 在 mount() 方法中新增 merchantAppointParam 参数，表示商户指定参数。
- 在 on() 方法中新增 billingAddressChanged 事件，聚焦账单地址（billingAddress）变化。
- 在 on() 方法的 paymentMethodChanged 事件回调数据中新增 name 字段，表示支付方式名称。
- 工厂模型：
- 新增 loadAntom() 方法，用于加载并初始化 antom 实例，支持 CDN 与 npm 两种集成方式。
- 新增 antom.createElement() 方法，用于创建独立绑卡元素（VaultingElement）或创建 CVV 输入元素（CVVElement），支持自定义外观及多语言配置。
- 新增 antom.confirmPayment() 方法，用于已存卡场景下发起支付。
- 新增 antom.confirmCardSetup() 方法，用于确认并提交卡片绑定请求，支持 redirect 策略控制绑卡完成后的跳转行为。
- 新增 antom.destroy() 方法，销毁 antom 实例。
- 新增 element 实例返回的 element.on()、 element.mount()、 element.unmount()、 element.destroy()、 element.updateConfig() 方法。
- 新增 Element 组件前置报价功能，覆盖 APO 与 Antom 业务场景。
- 支持买家切换支付币种，商家可调用询价接口获取实时汇率信息。
- 新增支付方式描述文案展示。
优化功能
- 优化 3D Secure 弹窗，在加载 iframe 时增加了加载状态显示。
- 优化 3D Secure 弹窗界面，使其更好地适配深色背景。
- 优化已存卡场景中卡图标的显示效果，解决在深色主题下卡图标显示模糊的问题，并将卡图标的背景色与支付列表保持一致，统一为白色背景。
- 优化 Element Tabs 组件视觉样式。
- 优化卡号输入框脱敏显示，卡要素模块中的卡号输入框现已支持商户指定卡号的脱敏反显。
修复功能
- 修复了 SDK 调用 mount() 方法后调用 on() 方法报错的问题。
- 修复了 express_checkout 场景下调用 on() 方法未提示错误的问题。
- 修复 Chrome 浏览器深色模式下，Google Pay 支付按钮背景色显示异常。
- 修复 SDK 中 Apple Pay 使用写死的 Prod 环境参数的问题，使环境参数能够根据配置正确切换。
- 修复弹窗滚动时，背景页面会同步滚动的问题。
移除功能
- 删除on()方法中的 valuesChanged 事件。
- 移除日志管控打印。
升级注意事项
- 新增工厂模型方法与独立构造类模型方法集成方式相互独立，不影响存量功能。
- 调用antom.confirmCardSetup() 前必须先调用 element.mount() 将元素挂载到 DOM。
V2.0.5
发布日期：2026.01.24
新增功能
- submitPayment()方法新增 options.handleActions 参数，表示是否由 SDK 自动处理跳转/唤端等后续动作。
- submitPayment() 方法新增 options.shippingInfo 参数，用于提交收货地址等信息。
- 新增 on() 方法，用于监听事件。
- 自定义外观样式新增 appearance.accordion.showRadio CSS 变量，用于控制手风琴（Accordion）类型支付列表中是否显示单选按钮。
- 自定义外观样式新增 appearance.variables.stroke-default CSS 变量，用于控制未激活容器边框样式。
- 自定义外观样式新增 appearance.variables.stroke-active CSS 变量，用于控制激活容器边框样式。
升级注意事项
- 兼容性：自定义跳转控制（当 options.handleActions 为 false 时）仅适用于除了卡、Apple Pay、Google Pay 以外的场景。在集成卡支付、 Apple Pay 或 Google Pay 时应排除该配置，以避免后续热更新带来的潜在风险。
V1.47.1
发布日期：2025.11.21
新增功能
- 新增 Payment Element 卡支付卡号填写 Luhn 规则校验。
- 新增 Payment Element 卡支付方式通过自定义外观样式定制卡品牌隐藏能力。
V1.47.0
发布日期：2025.11.19
新增功能
- 新增 Checkout Page (CKP) 和 Payment Element 部分卡分期支付能力。
优化功能
- 优化表单错误提示。
- 优化 customUserAgent 的判断能力，避免误判。
- 优化快捷支付接口跳转能力，提高跳转成功率。
iOS
V2.3.0
发布日期：2026.07.06
优化功能
- 支持商户通过 Antom Dashboard 门户自助管理与排序 App 内集成的 Element 支付方式。
- 支持前端 Element 架构升级后的灰度放量。
- 新增阶段性时间戳，为前端应用提供详细的流程性能数据。
V2.1.0
发布日期：2026.04.27
优化功能
- 前端调用 onRedirect() 发起跳转失败时，iOS SDK 新增 INVALID_REDIRECT_URL 事件码回调。
V2.0.1
发布日期：2026.04.10
优化功能
- iOS 代码全面适配 Xcode 26。
修复功能
- 修复 iOS 2.0.0 版本中部分资源图片不正确的问题。
- 修复 iOS 2.0.0 版本中部分方法名可能发生命名冲突的问题。
V2.0.0
发布日期：2026.03.30
新增功能
- Element 新增独立绑卡能力（VaultElement）。
- Payment Element 新增 confirmPayment() 方法，支持已存卡支付能力。
优化功能
- iOS 部分代码完成 Xcode 26 的适配。
- 对 SDK 结构进行拆分，可根据产品进行最小化模块集成，以优化包体积。
V1.53.0
发布日期：2026.03.13
优化功能
- 优化 sessionData 传参逻辑： SDK 发送给前端的 sessionData 由部分数据调整为全量数据，后端根据全量或非全量 sessionData 路由至不同的系统架构。
V1.51.0
发布日期：2026.02.09
优化功能
- 优化 Payment Element 收银台的拉起动画效果。
V1.50.0
发布日期：2026.02.02
优化功能
- 优化 Element 事件回调的埋点逻辑。
- 修复收银台（cashier）在沙箱环境下误调用生产链路的问题。
V1.49.0
发布日期：2025.12.29
修复功能
- 修复 3D 渠道页面取消按钮无响应的缺陷。
V1.47.0
发布日期：2025.11.19
新增功能
- 新增 Checkout Page (CKP) 和 Payment Element 部分卡分期支付能力。
优化功能
- 优化表单错误提示。
- 优化 customUserAgent 的判断能力，避免误判。
- 优化快捷支付接口跳转能力，提高跳转成功率。
Android
V2.3.1
发布日期：2026.07.21
修复功能
- 修复 Android SDK 在公开接口调用顺序异常时可能导致代码执行异常的问题。
- 修复 Android SDK 中 showLoading 配置项设置后未生效的问题。
V2.3.0
发布日期：2026.07.06
优化功能
- 支持商户通过 Antom Dashboard 门户自助管理与排序 App 内集成的 Element 支付方式。
- 支持前端 Element 架构升级后的灰度放量。
- 新增阶段性时间戳，为前端应用提供详细的流程性能数据。
V2.2.0
发布日期：2026.06.01
优化功能
- 快捷支付场景下的支付宝相关代码已整合至快捷支付产品资源中，不再需要单独集成。
V2.1.0
发布日期：2026.04.27
优化功能
- 前端调用 onRedirect() 发起跳转失败时，Android SDK 新增 INVALID_REDIRECT_URL 事件码回调。
优化功能
- Android SDK compileSdkVersion 版本升级至 35（Android 15）。
修复功能
- Android SDK 拉起收银台后，若内部接口调用超时，不再发送 INITIALIZE_WEB_TIMEOUT 事件码。
V2.0.0
发布日期：2026.03.30
新增功能
- Element 新增独立绑卡能力（VaultElement）。
- Payment Element 新增 confirmPayment() 方法，支持已存卡支付能力。
优化功能
- 对 SDK 结构进行拆分，可进行部分模块集成，以优化包体积。
V1.53.0
发布日期：2026.03.13
优化功能
- 优化 sessionData 传参逻辑： SDK 发送给前端的 sessionData 由部分数据调整为全量数据，后端根据全量或非全量 sessionData 路由至不同的系统架构。
V1.52.0
发布日期：2026.02.26
优化功能
- 修改了 JavaScript 文件在项目中的名称。具体改动如下：
- h5_bridge.js 改为 antom_h5_bridge.js
- h5_performance.js 改为 antom_h5_performance.js
V1.51.0
发布日期：2026.02.09
优化功能
- 优化 Payment Element 收银台的拉起动画效果。
V1.49.0
发布日期：2025.12.29
优化功能
- 优化 Payment Element Android 事件码回调的埋点。
- 修复 Android 内嵌场景中卡支付 3D Secure 验证回调（POST Redirect）URL 异常问题。
- 优化 EasySafePay SDK 代码，修复可能出现的空指针问题。
V1.47.0
发布日期：2025.11.19
新增功能
- 新增 Checkout Page (CKP) 和 Payment Element 部分卡分期支付能力。
优化功能
- 优化表单错误提示。
- 优化 customUserAgent 的判断能力，避免误判。
- 优化快捷支付接口跳转能力，提高跳转成功率。
Flutter
V1.2.1
发布日期：2026.07.21
修复功能
- (Android) 修复 SDK 在公开接口调用顺序异常时可能导致代码执行异常的问题。
- (Android) 修复 SDK 中 showLoading 配置项设置后未生效的问题。
V1.2.0
发布日期：2026.07.06
优化功能
- (iOS) 代码全面适配 Xcode 26。
- Flutter SDK 依赖的 Native SDK 版本升级至 2.3.0。
- 支持商户通过 Antom Dashboard 门户自助管理与排序 App 内集成的 Element 支付方式。
- 支持前端 Element 架构升级后的灰度放量。
- 新增阶段性时间戳，为前端应用提供详细的流程性能数据。
- (Android) 快捷支付场景下的支付宝相关代码已整合至快捷支付产品资源中，不再需要单独集成。
- (Android) compileSdkVersion 版本升级至 35（Android 15）。
- (iOS & Android) 前端调用 onRedirect() 发起跳转失败时，新增 INVALID_REDIRECT_URL 事件码回调。
修复功能
- (Android) 拉起收银台后，若内部接口调用超时，不再发送 INITIALIZE_WEB_TIMEOUT 事件码。
- (iOS) 修复 2.0.0 版本中部分资源图片不正确的问题。
- (iOS) 修复 2.0.0 版本中部分方法名可能发生命名冲突的问题。
V1.1.0
发布日期：2026.03.30
新增功能
- Element 新增独立绑卡能力（Vaulting Element）。
- Payment Element 新增 confirmPayment() 方法，支持已存卡支付能力。
优化功能
- (iOS) 部分代码适配 Xcode 26。
- 对 SDK 结构进行拆分，可进行部分模块集成，以优化包体积。
- (Android) 优化混淆规则，避免对宿主 App 产生影响。
- (Android) 修改 JS 脚本资源命名，提升资源管理稳定性。
- (iOS & Android) 优化 Payment Element 收银台拉起动画体验。
- (iOS) 优化 Element 事件码回调的埋点逻辑。
修复功能
- 修复 Flutter 多 Engine 场景下，SDK 获取 Activity 或 Context 可能异常的问题。
V1.0.1
发布日期：2025.12.30
优化功能
- Flutter SDK 依赖的 Native SDK 版本升级至 1.49.0。
- (Android) 优化 Element 事件码回调相关埋点逻辑，提升数据采集准确性与稳定性。
修复功能
- (iOS) 修复 Flutter SDK 在 iOS 端 3D 支付方式页面取消按钮点击不生效的问题。
V1.0.0
发布日期：2025.12.05
新增功能
- 新增 Payment Element Flutter SDK 能力。