Introduction
Scope
This document serves as a guide for the 3DS SDK integrator of the Netcetera Android 3DS SDK, providing details how the SDK should be configured and integrated into an Android application or library.
Please check the release notes pages for detailed release notes about the current and previous versions of the Netcetera Android 3DS SDK.
System Requirements
| Requirement | Description |
|---|---|
| Android 5 (API Level 21) | Minimum Android version of the app that this SDK can be integrated in. |
Deliveries
The Netcetera Android 3DS SDK is developed as standard Android Library and delivered as single AAR artefact with corresponding Maven POM file that list all of the dependencies of the Android 3DS SDK.
The full delivery package includes:
- Android 3DS SDK
- Android 3DS SDK API Javadoc
- Maven POM describing dependencies
- API key
- Integration Guide documentation for the SDK
- Netcetera Merchant Demo app - sample requestor app
- Guide for the demo app
Versioning and Update Policy
The Netcetera Android 3DS SDK follows the software versioning convention. The releases have semantic versioning scheme, meaning the version name will be composed of PROTOCOL.MAJOR.MINOR.PATCH.
PROTOCOL- major protocol version, i.e. 2MAJOR- new featuresMINOR- improvementsPATCH- bug or security fix
It is recommended that the 3DS Requestor App always uses the latest available version of the SDK.
EMVCo 3DS Protocol Versions
The Netcetera Android 3DS SDK supports the 2.1.0, 2.2.0 & 2.3.1 3DS protocol versions.
Latest Supported EMVCo Specification Bulletins
| Protocol version | EMVCo 3DS Protocol Specification | EMVCo 3DS SDK Protocol Specification | Device Data Specification |
|---|---|---|---|
| 2.1.0 | EMVco 3DS SB204v6 (February 2020) | EMVCo 3DS SDK SB205v1 (August 2018) | EMVCo 3DS SDK Device Information 1.4 (October 2019) |
| 2.2.0 | EMVCo 3DS SB214v2 (February 2020) | EMVCo 3DS SDK SB211 (December 2018) | EMVCo 3DS SDK Device Information 1.4 (October 2019) |
| 2.3.1 | EMV 3-D Secure - Protocol and Core Functions Specification (May 2023) | EMV 3-D Secure SDK Specification (May 2023) | EMVCo 3DS SDK Device Information 1.6 (May 2023) |
A link to EMVCo's Specifications & Associated Bulletins page can be found on our Useful Links page.
Supporting Documentation
Relevant documents that are specific to the EMV 3-D Secure protocol and could be used in conjunction with this guide:
- EMV 3-D Secure - Protocol and Core Functions Specification
- EMV 3-D Secure SDK Specification
- EMV 3-D Secure SDK - Device Information
Disclaimer
Information in this document is provided as it is. All representations, statements, opinions and proposals are to the best of our present knowledge.
Notice
Netcetera may collect and compile statistical data and other information related to the performance, operation and use of the 3DS SDK software product, and may use the data or information for security and operations management, to create statistical analyses, and for research and development purposes in order to improve the product and its support.