Introduction

Netcetera Android 3DS SDK

3-D Secure Mobile SDK is the mobile-device-side component of 3-D Secure, one of the novelties introduced by the new, EMVCo 2.0 protocol version. It secures authentication in mobile-based purchases. Being integrated in 3-D Secure Requestor (Merchant) app, enables the app for EMV 3DS (2.0) transactions.

The Netcetera Android 3DS SDK is an implementation of the 3-D Secure Mobile SDK, by Netcetera AG.

Scope

This document serves as a guide for the 3DS SDK integrator of the Netcetera Android 3DS SDK version 2.0.0, providing details how the SDK to be configured and integrated into Android application or library.

Please check Release Notes page for detailed release notes about the current and previous versions of the Netcetera Android 3DS SDK.

System Requirements

Requirement Description
Android 4.4 (API Level 19) 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
  • License file
  • Integration Guide document 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 MAJOR.MINOR.PATCH.

  • MAJOR - major protocol version, i.e. 2
  • MINOR - minor protocol version or OS version update
  • PATCH - bug or security fix, immediate or quarterly at most

It is recommended that the 3DS Requestor App always use the latest available version of the SDK.

Supporting documentation

Relevant documents that are specific to the EMV 3-D Secure protocol and could be used in conjunction with this guide:

Disclaimer

Information in this document is provided as it is. All representations, statements, opinions and proposals are to the best of our present knowledge.