Skip to main content
On this page

The maintained iOS repository and podspec are currently tagged v2.12.7. Pin a release in production and review the upstream artifact before every upgrade. This page summarizes integration-impacting changes verified against repository commit 96501079d01ce15ecaf43d486dd0b2e8c86ab8df; it is not a substitute for the complete repository release history.

Upgrade flow#

01 · inventory
Record the current pin
Capture package source, CocoaPods subspecs, entitlements, fraud frameworks, callbacks, and presentation modes.
02 · resolve
Upgrade dependencies
Change one pin, resolve packages or pods, and inspect the resolved graph and privacy manifests.
03 · exercise
Test on real devices
Cover widgets, wallets, fraud providers, redirects, 3DS, APMs, lifecycle transitions, and accessibility.
04 · release
Monitor outcomes
Compare crashes, callback coverage, provider initialization, and backend payment results with the previous pin.

Notable release lines#

v2.12.x · Modular fraud providers and APM hardeningCurrent verified line
  • v2.12.7 is the newest tag in the audited repository.
  • v2.12.6 added Mercado Pago native fraud-fingerprint support and a dedicated CocoaPods subspec.
  • Earlier v2.12.x work modularized supported fraud providers, added runtime dependency handling, and included privacy-manifest updates for applicable vendor frameworks.
  • v2.12.4 adds explicit handling for an APM reference that cannot be generated or displayed.
  • v2.12.2 adds Elements lifecycle events, domain configuration, and consistent userInfo forwarding.

Re-test every enabled fraud provider with the exact subspec and application configuration. Missing runtime frameworks can appear as empty device data rather than a compile failure.

v2.11.x · Native wallet and presentation workWallet and widget lifecycle

This line introduced and refined native wallet availability and launch behavior, Apple Pay configuration, widget auto-resize work, completion dispatch on the main thread, and safer controller dismissal.

Verify entitlements, merchant identifiers, supported networks, physical-device availability, cancellation, background/foreground behavior, and backend reconciliation.

v2.4.0 · Response and presentation changesBreaking payload types
  • Typed response data such as ElementsResponseData, CheckoutResponseData, CardBinMetadata, and InstallmentMetadata changed to [String: Any] payloads.
  • PaymentsError became the public error type.
  • Deprecated presentInModal and showCloseButton parameters were removed from older Checkout and Elements entry points.

Prefer the current controller and presentation APIs in the iOS guide, and avoid strict whole-dictionary equality for additive event data.

v2.0.0 · Public symbol migrationMajor migration

The major line renamed callback, response, and event symbols, including Callbacks to CheckoutCallbacks and CheckoutEventType to CheckoutEvent. Compile all integrations and analytics adapters after updating imports.

Full release history#

All notable changes documented across iOS SDK releases, following Keep a Changelog and Semantic Versioning:

[v2.12.6] - 2026-09-29

Added

  • Mercado Pago fraud fingerprint support and provider fixes

[v2.12.4] - 2026-08-11

Added

  • Add errorApmMissingReference onError callback and refactor APM data models

[v2.12.2] - 2026-06-11

Changed

  • Added missing Elements eventos in onEventDispatch

[v2.12.1] - 2026-06-04

Added

  • Added auto resize & accertify suport

[v2.12.0] - 2026-05-22

Added

  • Added signifyd & sift to anti fraud providers

[v2.11.2] - 2026-05-08

Added

  • Added apple pay wallet support

[v2.11.1] - 2026-04-30

Added

  • Added support for white spaces in firstName & lastName

[v2.11.0] - 2026-04-27

Added

  • Added native libraries to generateFraudId

Changed

  • Added fraud providers to pods

[v2.10.0] - 2026-03-30

Added

  • Add installment/bin callbacks for Elements

[v2.9.18] - 2026-03-23

Changed

  • Expand and reorganize event types in CheckoutEvent and ElementsEvent enums.

[v2.9.17] - 2026-02-19

Added

  • Added userAgent in onSuccess payload

[v2.9.16] - 2026-02-16

Fixed

  • Fixed broken post messages when SafariViewController is visible

[v2.9.15] - 2026-01-02

Fixed

  • Remove trailing commas from function parameters

[v2.9.14] - 2025-12-30

Fixed

  • Remove trailing commas from function parameters

[v2.9.13] - 2025-11-25

Added

  • Added optional domain param

[v2.9.12] - 2025-10-23

Added

  • Added fraudCredentials support in payment widget

[v2.9.11] - 2025-10-06

Added

  • Improve page content loading ignoring cache

[v2.9.10] - 2025-09-25

Added

  • Added support for xCode 26

Changed

  • Add E2E Testing workflow for PreProduction using Playwright

  • @ronsilver made their first contribution

[v2.9.9] - 2025-09-04

Added

  • Send userInfo & userToken on vault

[v2.9.8] - 2025-07-23

Added

  • Release v2.9.8

[v2.9.7] - 2025-07-16

Changed

  • Release v2.9.7

[v2.9.6] - 2025-07-14

Fixed

  • Fixed not centered loader in embedded widgets

[v2.9.5] - 2025-06-16

Added

  • Added Safari View Controller support

[v2.9.4] - 2025-05-29

Added

  • Release v2.9.4

[v2.8.15] - 2025-03-12

Added

  • Agregar nuevos campos en initElements - iOS y Android

[v2.8.14] - 2025-02-27

Added

  • Release 2.8.14

[v2.8.13] - 2025-01-16

Added

  • Fixed react native expo conflicts

[v2.8.12] - 2025-01-16

Added

  • Run UI tasks in main thread to be compatible with react native expo

[v2.8.11] - 2025-01-14

Added

  • Added cocoapods publish steps

[v2.8.10] - 2025-01-14

Added

  • Added Cocoapods File

[v2.8.9] - 2024-10-25

Added

  • Release 2.8.9 - Clic Air

[v2.8.8] - 2024-10-11

Fixed

  • Release 2.8.8

[v2.8.7] - 2024-10-10

Added

  • Release 2.8.7

[v2.8.6] - 2024-10-08

Added

  • Release 2.8.6

[v2.8.5] - 2024-10-01

Added

  • Release 2.8.5

[v2.8.4] - 2024-09-27

Added

  • Release 2.8.4

[v2.8.3] - 2024-09-26

Added

  • Release 2.8.3

[v2.8.1] - 2024-09-17

Added

  • Release 2.8.1

[v2.8.0] - 2024-09-11

Added

  • Release v2.8.0

[v2.7.2] - 2024-09-04

Added

  • Release 2.7.2

[v2.7.1] - 2024-09-03

Added

  • Release 2.7.1

[v2.7.0] - 2024-09-02

Added

  • Release 2.7.0

[v2.6.0] - 2024-08-30

Added

  • Release 2.6.0

[v2.5.1] - 2024-08-19

Added

  • Release 2.5.1

[v2.5.0] - 2024-08-07

Added

  • Release 2.5.0

[v2.4.0] - 2024-07-11

Added

  • Release 2.4.0

[v2.3.0] - 2024-07-05

Added

  • Release 2.3.0

[v2.1.1] - 2024-07-03

Added

  • Added missing PaymentWidgetEvent enum

[v2.1.0] - 2024-07-03

Added

  • Release 2.1.0 (#67

[v2.0.3] - 2024-06-28

Added

  • Feat(V2.0.2): Release v2.0.2

  • Feat(2.0.3): Fixed sandbox domains

[v2.0.0] - 2024-04-10

Changed

  • Pre release 2.0.0

  • @DinaRocio made their first contribution

  • @darwinmorocho-deuna made their first contribution

[v1.0.9] - 2024-02-16

Added

  • Loader color

[v1.0.7] - 2024-01-12

Changed

  • Archive project

  • Added the ability to show or hide the close button and display the ch…

[v1.0.6] - 2024-01-11

Fixed

  • Add vault elements case

  • Fix(ENTP!-9648): redirect to safari va_por_mi_cuenta link

Changed

  • @catalanseb made their first contribution

  • Feature/use uikit

[v1.0.5] - 2023-12-21

Changed

  • Feature/plat 2201 issue charging data

[v1.0.4] - 2023-12-15

Changed

  • Feature/plat 2104 fail safei os

  • Fixed webview handling, adding close button and loader

[v1.0.3] - 2023-12-08

Changed

  • Update example with callback event listener

  • Upgrade version example

  • Change event names and property

[v1.0.2] - 2023-11-30

Changed

  • Add closeElements to be called on callbacks

  • Create response object

  • Feature/separate elements view

  • Revert "wip add params to config and initializers (#41)"

  • V1.0.2

  • @DiegoGallegos4 made their first contribution

[v1.0.1] - 2023-11-22

Changed

  • Resolve Package dependencie Basic Integraiton example

[v1.0.0] - 2023-11-21

Changed

  • Fixed exmaples link

  • Feauture/fix readme example link

  • Feature/new init elements

  • Changing sdk location in demo app

  • Removed package.resolved on publish public version

  • Improve funcionalities

Prior to v2.0.0

Initial public releases covering Payment Widget, Elements, Voucher, and Next Action widgets.

**Updated 23 days ago Did this page help you?YesNo

Compatibility matrix#

SurfaceUpgrade check
Dependency managerExact SPM version or CocoaPods version and required subspecs resolve reproducibly
Apple toolchainApp deployment target, Xcode, Swift, linker settings, and privacy manifests
PresentationUIKit and SwiftUI ownership, modal and embedded modes, auto-resize, keyboard, and dismissal
External actions3DS, ASWebAuthenticationSession or approved browser flow, deep links, cancellation, and return
Native walletsEntitlements, merchant ID, physical-device capability, networks, tokenization, and cancellation
Fraud providersRequired vendor framework, initialization timing, timeout, missing data, and privacy declarations
CallbacksMain-thread UI work, dedicated handlers, additive event data, and unknown-event fallback

Regression checklist#

  • Clean install and upgrade from the currently deployed pin using the production dependency manager.
  • Debug and archive builds on the oldest and newest supported OS versions.
  • Payment Widget, Elements, Voucher, and Next Action in every supported presentation mode.
  • Rotation, Dynamic Type, VoiceOver, keyboard, sheet dismissal, background/foreground, and memory release.
  • Apple Pay availability and payment authorization on physical devices.
  • Every enabled native fraud provider with permitted data and failure handling.
  • Backend retrieval or verified webhook confirmation after every client outcome.