Android SDK releases
Track notable DEUNA Android SDK changes, compatibility boundaries, and a safe upgrade process for pinned Gradle integrations.
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#
Notable release lines#
v2.12.x · Native fraud and APM hardening
v2.12.8is the newest tag in the audited repository.- The
v2.12.5line added Mercado Pago fraud-provider integration and initialization support. - The
v2.12.4line 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 capabilities
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 changes
OrderResponseandElementsResponsechanged toMap<String, Any>payloads.CheckoutErrorchanged toPaymentsError.- 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 renames
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#
| Surface | Upgrade check |
|---|---|
| Gradle and repositories | Resolve the exact SDK tag using the repositories documented for that release |
| Android toolchain | Compile with the app's actual AGP, Kotlin, JDK, compileSdk, and min-SDK matrix |
| Hosted widgets | Modal, embedded, auto-resize, keyboard, rotation, back navigation, and controller disposal |
| External actions | 3DS, Custom Tabs, provider apps, deep links, cancellation, and return-to-app behavior |
| Native wallets | Device capability, merchant configuration, activity result, tokenization, and cancellation |
| Fraud providers | Native dependency present, early initialization, timeout, missing data, and provider-specific configuration |
| Callback payloads | Dedicated 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.