Skip to main content
On this page

The maintained Android repository is currently tagged v2.12.8. Pin an exact release in production and review the upstream release artifact before every upgrade. This page summarizes integration-impacting changes verified against repository commit f8c9845e9aa78ea471a69afe952b83579e031154; it is not a substitute for the complete repository release history.

Upgrade flow#

01 · compare
Read changes between pins
Review source, release notes, removed APIs, native dependencies, and the example app.
02 · resolve
Update Gradle in a branch
Pin the new SDK and resolve repository, compile SDK, Kotlin, AndroidX, and manifest requirements.
03 · exercise
Run the payment matrix
Test widget modes, wallets, fraud providers, redirects, 3DS, APMs, process death, and accessibility.
04 · release
Roll out and monitor
Compare client exceptions, callback coverage, payment outcomes, and abandonment with the previous pin.

Notable release lines#

v2.12.x · Native fraud and APM hardeningCurrent verified line
  • v2.12.8 is the newest tag in the audited repository.
  • The v2.12.5 line added Mercado Pago fraud-provider integration and initialization support.
  • The v2.12.4 line added explicit missing-reference handling for APM voucher flows and interception for external application schemes.

Re-test native fraud initialization, provider dependency resolution, voucher error callbacks, and every external-app return path. A build that succeeds does not prove the provider SDK initialized or returned usable device data.

v2.9.0 · Embedded widgets and current controller capabilitiesPresentation and fraud data

This line added embedded widgets, merchant-controlled payment-button behavior, fraud fingerprint generation, and Next Action Widget support, and removed deprecated functions.

When upgrading from an older line, migrate to the current methods in the Android SDK guide, then test modal, embedded, and auto-resize behavior independently.

v2.4.0 beta line · Response and error contract changesBreaking response types
  • OrderResponse and ElementsResponse changed to Map<String, Any> payloads.
  • CheckoutError changed to PaymentsError.
  • Payment Widget support moved into the current widget-controller model.

Avoid exhaustive casts over raw maps. Prefer dedicated callbacks and tolerate additive fields in event payloads.

v2.0.0 · Public symbol renamesMajor migration

The major line renamed DeUnaSdk to DeunaSDK, Callbacks to CheckoutCallbacks, response/event symbols, and changed event-listener argument order from (response, type) to (type, response).

Compile every callback and audit analytics adapters when migrating; swapped arguments can produce runtime data corruption even when application logic still builds through loosely typed wrappers.

Full release history#

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

[v2.12.7] - 2026-09-29

Fixed

  • Use hash delimiter in sed to support regex alternation in move-repo workflow

  • Upgrade setup-android action to v4

[v2.12.5] - 2026-09-29

Added

  • Mercado Pago fraud fingerprint support and provider fixes

Changed

  • Auto-publish Android SDK changelog on release [ENTP1-18063]

[v2.12.4] - 2026-08-12

Added

  • Add errorApmMissingReference onError callback and fix deep link handling in ExternalUrlWebView

Fixed

  • Filter test discovery by ANDROID_TEST_ANNOTATION

Changed

  • Preserve Android test failures for retries

  • Isolate Android test compose service

  • Upgrade Android emulator API 31→33 and fix installments deselect test flakiness

[v2.12.3] - 2026-07-15

Added

  • Add Docker and E2E integration support to explore app

Fixed

  • Pre-install android SDK platforms 32, 34 and build-tools 34.0.0 at build-time

Changed

  • Publish Android preprod test image

  • Set ownership of /app to androidusr in explore Dockerfile

  • Perf: optimize emulator and Gradle memory usage to prevent OOM in CI

  • Implement local port forwarding and emulator environment configuration

  • Pass environment endpoints to instrumentation tests via gradle arguments

  • Allow cleartext HTTP traffic to local 10.0.2.2 backend in explore app

  • Android preprod mobile e2e integration tests

  • Rename test-results volume to android-test-reports for preprod CI

  • Keep WebView hardware acceleration for 3DS

  • @duna-alex-vidal made their first contribution

[v2.12.2] - 2026-06-12

Changed

  • Fix internal WebView scroll blocked by Compose verticalScroll in auto-resize mode

[v2.12.1] - 2026-06-11

Changed

  • Added missing Elements eventos in onEventDispatch

[v2.12.0] - 2026-06-04

Added

  • Improve explore tests

  • Added new tests

  • Added auto resize support and accertify

[v2.11.7] - 2026-05-25

Changed

  • Update Android Gradle plugin version to 8.5.1

[v2.11.6] - 2026-05-22

Added

  • Added signifyd & sift to anti fraud providers

[v2.11.5] - 2026-05-07

Added

  • Added new explore app

[v2.11.4] - 2026-05-05

Added

  • Added google pay wallet support

[v2.11.3] - 2026-04-30

Added

  • Added support for white spaces in firstName & lastName

[v2.11.2] - 2026-04-27

Added

  • Add custom WebView settings support and update dependencies for…

[v2.11.0] - 2026-04-24

Added

  • Added native libraries to generateFraudId

Changed

  • Update dependency declaration for Riskified SDK to clarify usage…

[v2.10.0] - 2026-03-30

Added

  • Stabilize external WebView flows and add installment/bin callbacks for Elements

[v2.9.17] - 2026-03-23

Added

  • Introduce a wide range of new event types for Checkout and Elements widgets.

[v2.9.16] - 2026-02-19

Added

  • Added userAgent in onSuccess payload

[v2.9.15] - 2025-12-18

Fixed

  • Prevent duplicated external urls

[v2.9.14] - 2025-11-26

Added

  • Added optional domain param

[v2.9.13] - 2025-11-10

Fixed

  • Fixed app crash on external redirects

[v2.9.12] - 2025-10-22

Added

  • Added support for fraudCredentials on PaymentWidget

[v2.9.7] - 2025-09-26

Changed

  • Revert "feat(): Removed old publishing action"

[v2.9.6] - 2025-09-04

Added

  • Send userInfo & userToken on vault

[v2.9.5] - 2025-07-23

Added

  • Release v2.9.5

[v2.9.4] - 2025-06-19

Added

  • Support for Custom Chrome Tabs

  • Release v2.9.4

[v2.9.3] - 2025-06-02

Added

  • Release v2.9.3

[v2.8.13] - 2025-03-12

Added

  • Agregar nuevos campos en initElements - Android

[v2.8.12] - 2025-02-27

Added

  • Release 2.8.12

[v2.8.11] - 2024-12-17

Added

  • Support links in query parameters

[v2.8.10] - 2024-10-29

Changed

  • @capdilla made their first contribution

[v2.8.8] - 2024-10-11

Fixed

  • Release 2.8.8

[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.2] - 2024-09-17

Added

  • Release 2.8.2

[v2.8.1] - 2024-09-11

Added

  • Added purchaseRejected and apmSuccess events

[v2.8.0] - 2024-09-11

Added

  • Release 2.8.0

[v2.7.1] - 2024-09-04

Added

  • Release 2.7.1

[v2.7.0] - 2024-09-02

Added

  • Release 2.7.0

[v2.6.1] - 2024-08-29

Added

  • Release 2.6.0

[v2.6.0] - 2024-08-29

Added

  • Release 2.6.0

[v2.5.2] - 2024-08-20

Added

  • Release 2.5.2

[v2.5.1] - 2024-08-12

Added

  • Migration to jitpack.io as package repository

  • Release 2.5.0

[v2.4.0] - 2024-07-16

Added

  • Release 2.4. - Payment widget

[v2.1.1] - 2024-07-03

Added

  • Feat(v2.1.1): Go back to supporting compileSdk 32

[v2.0.3] - 2024-06-28

Added

  • Feat(2.0.3): Fixed sandbox domains

[v2.0.2] - 2024-06-24

Added

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

[v2.0.0] - 2024-04-10

Added

  • Feat(Entp1-9897) agregar change cart al diccionario del sdk

Changed

  • Pre release 2.0.0

  • @DinaRocio made their first contribution

[v1.0.9] - 2024-02-16

Added

  • Progress bar is added while loading the urls

Changed

  • Use strict version in google.code.gson

[v1.0.8] - 2024-01-16

Fixed

  • Redirect external url

Changed

  • @catalanseb made their first contribution

[v1.0.6] - 2023-12-18

Changed

  • Feature/plat 2108 close on events testing

  • Get optional fields from OrderResponse

  • Add loader bar for 3 seconds after load webview

[v1.0.5] - 2023-12-06

Changed

  • Support 3ds into elementActivity

  • Release-candidate: v1.0.5

[v1.0.4] - 2023-11-30

Changed

  • Move orderToken from config to initCheckout instance

  • Move userToken from config to initElements

  • @dependabot made their first contribution

[v1.0.3] - 2023-11-22

Changed

  • Add functionality to close activity when event are into close events

  • Add signin config and change close function to closecheckout

[v1.0.1] - 2023-11-17

Changed

  • Feature/transitive dependencies

[v1.0.0] - 2023-11-14

Changed

  • Feature/normal flow

  • @silvaignacio made their first contribution

  • @mavelar made their first contribution

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
Gradle and repositoriesResolve the exact SDK tag using the repositories documented for that release
Android toolchainCompile with the app's actual AGP, Kotlin, JDK, compileSdk, and min-SDK matrix
Hosted widgetsModal, embedded, auto-resize, keyboard, rotation, back navigation, and controller disposal
External actions3DS, Custom Tabs, provider apps, deep links, cancellation, and return-to-app behavior
Native walletsDevice capability, merchant configuration, activity result, tokenization, and cancellation
Fraud providersNative dependency present, early initialization, timeout, missing data, and provider-specific configuration
Callback payloadsDedicated success/error/close handlers plus an unknown-event fallback

Regression checklist#

  • Clean installation and upgrade from the currently deployed pin.
  • Release build with shrinking/obfuscation enabled.
  • Activity recreation, process death, background/foreground, and duplicate launch protection.
  • Payment Widget, Elements, Voucher, and Next Action in every supported presentation mode.
  • Card, wallet, APM, 3DS, error, timeout, close, and retry paths.
  • 320 dp content width, large text, keyboard navigation, TalkBack, and reduced animation settings.
  • Backend reconciliation after every client callback.