morristech / 3dsview

Android UI component to process banking 3D Secure (MasterCard SecureCode / Verified By Visa) payment authorizations in Android apps.

3DSView (D3SView :) , aka 3D Secure WebView

Self-contained UI component to process banking 3D Secure (MasterCard SecureCode / Verified By Visa) payment authorizations in Android apps.

Why exactly "D3S" ? Simply because Java does not allow to have number as a first character in a package and class names :)

Component have to be used instead of a WebView and handles the complete payment authorization process from redirecting user to an ACS banking server web UI and to grabbing authorization results and parameters, intercepting post events and parsing the code.

Simply add it to your layout just instead of a WebView, invoke only two methods and then you have 3DS auth implemented.

Component can be used in activity, fragment or in any other part of your layout, both declaratively (in xml files) or programmatically by creating an instance in the source code. Only make sure to give it sufficient space on the screen to display the banking ACS web page.

Status

• Current stable version:
• Current development version: n/a

Get It

• Maven repository: jCenter
• Group: eu.livotov.labs.android
• Artifact ID: 3DSView

compile ('eu.livotov.labs.android:3DSView:1.1.2@aar') {transitive=true}

What's new (1.1.2)

• Component reuse bug
• Updated project to the latest android plugin and build tools

Installation

Release versions are available from jCenter repository, so just add the "compile..." statement to your project. For snapshots, please add our bintray snapshots repository url first: https://dl.bintray.com/livotovlabs/maven

dependencies {
    ...
    compile 'eu.livotov.labs.android:3DSView:1.1.2@aar'
    ...
}

Alternatively you may download the source code and build it on your own.

Quick Usage

• Build your own or download precompiled 3dsview.jar from releases section and put it to the libs folder of your app project.
• Add eu.livotov.labs.android.d3s.D3SView to your layout file (or create and add it programmatically)
• In corresponding Activity or Fragment, configure the instance of D3SView by calling setXXX methods (see configuration options below)
• Invoke the D3SView#authorize(String, String, String) method, providing "dummy" postback url (optionally), callback listener and 3DS initiation parameters.

Once user completes the authorization at the ACS server, your callback method will be automatically called with the 3DS response data, which you may then pass to your processing backend server for payment finalization.

Configuration

• DS3View#setDebug(boolean) - enables or disables debug mode. In debug mode, self-signed or broken certificates/ssl errors will be ignored. It is important not to enable debug mode for release apps.
• DS3View#setAuthorizationListener(D3SViewAuthorizationListener) - adds listener to receive authorization results and progress messages. You will receive authorization MD and PaRes values there as well, when 3DSecure completes.

Start

Simply call D3SView#authorize(String, String, String) method and pass MD, PaReq and ACS url values, you receive from your card payment gateway and listen for authorization completion event in your callback.

P.S. Specifying postback url is optional, the library will use the default value then.

Bugs, Suggestions, Ideas

Any ideas/bugs/etc, as well as pull requests, are welcome in the issues section.

Credits

Alex Askerov (@askerov), Mia Alexiou (@subsymbolic), Luke Korth (@lkorth), Christophe Beyls (@cbeyls), Owen O Byrne (@owenobyrne)