Version 2.3.1:1
Introduction¶
The goal of this ActiveSDK Documentation is to give any developer with iOS or Android experience the knowledge and resources required to integrate GPayments's 3-D Secure 2 3DS SDK (ActiveSDK) into an existing 3DS Requestor App, which will in turn provide cardholders with a seamless ecommerce authentication experience.
This documentation will introduce ActiveSDK, explain how to integrate ActiveSDK to a merchant app, and provide troubleshooting procedures.
Introduction to ActiveSDK¶
Welcome to ActiveSDK!
ActiveSDK is a 3-D Secure 2 solution provided by GPayments Pty Ltd.
Mobile commerce has become increasingly prevalent around the world. The value of payments made via mobile devices is expected to reach US$1 trillion in 2019, with mobile wallets expected to become more popular than debit and credit cards by 2020. With so many now using their devices to purchase products and log in to a multitude of online services through mobile applications, the risk of mobile fraud is higher than ever.
ActiveSDK offers native mobile functionality for 3-D Secure 2 authentications. ActiveSDK is developed in accordance with EMVCo's specifications, and includes 2 separate SDKs; one for Android, and one for iOS. ActiveSDK can be integrated with iOS and Android apps to connect to any 3DS Server, and complete 3-D Secure authentications.
ActiveSDK enables rich-data exchange between the mobile device and the ACS for risk-based decision making, allowing for an immediate decision on whether to allow or challenge a transaction. ActiveSDK will also provide for native authentication screens, which will help the 3-D Secure interface seamlessly with a merchant's mobile application, and provide a look and feel consistent with the rest of the in-app purchase process. It has full ActiveServer integration support by default and comes with complete documentation and demo app with sample code to help integrate into your application quickly.
For documentation on ActiveServer, which is GPayments's 3DS Server solution, please visit:
Supported versions¶
The following table shows the minimum supported version for ActiveSDK:
| Platform | Minimum Version |
|---|---|
| iOS | iOS 9 |
| Android | 4.4 (API Level 19) |
Note
Windows 10 Mobile is not supported.
Supported EMVCo 3-D Secure Protocol Version Number¶
ActiveSDK (for both iOS and Android) supports the following EMVCo 3-D Secure 2 protocol version numbers.
| Protocol Version Number | Status |
|---|---|
| 2.1.0 | Supported |
| 2.2.0 | Supported |
Concepts to Understand¶
ActiveSDK is a standard implementation of EMVCo's 3-D Secure 3DS SDK specification. Understanding the concepts of 3-D Secure will make this documentation easier to follow, and would allow app developers to fully utilise the capability of ActiveSDK.
For useful resources on 3DS SDK specifications, please see:
- EMV® 3-D Secure Protocol and Core Functions Specification.pdf
- EMV® 3-D Secure—SDK Specification.pdf
- Definitions
Integration¶
Integration section includes detailed tutorials on how to integrate ActiveSDK with Android and iOS apps. All 3DS SDK authentication processes and their work flows are covered.
3DS Requestor¶
To integrate ActiveSDK, the merchant site need to implement a 3DS Requestor in the backend. This section takes you through the process of integrating the Active SDK with our 3DS Requestor demo code. In this demo, the 3DS Server which the 3DS Requestor connected to is our ActiveServer.