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.
- Current stable version: 1.1.0
- Current development version: n/a
- Added D3SDialog as DialogFragment, so you can perform 3DS authorization using a nice dialog above your business activity
- Updated project to the latest android plugin and build tools
Current compiled snapshots and releases could be automatically added to your project using gradle from our maven repository
Add a link to our repository to your build.gradle file (repositories section):
maven {
url 'http://maven.livotovlabs.pro/content/groups/public/'
}Then append appropriate dependency to your "compile" statement:
- For release version:
dependencies {
...
compile 'eu.livotov.labs:3dsview:1.1.0@aar'
...
}For snapshots:
configurations.all {
// check for updates every build, so you will pick up latest snapshot, even if it was refreshed a minute ago.
resolutionStrategy.cacheChangingModulesFor 0, 'seconds'
} dependencies {
...
compile group: "eu.livotov.labs", name: "3dsview", version: "1.x.y-SNAPSHOT", ext: "aar", changing: true
...
}Alternatively you may download the source code and build it on your own.
- 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.D3SViewto your layout file (or create and add it programmatically) - In corresponding
ActivityorFragment, configure the instance ofD3SViewby 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.
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.
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.
Any ideas/bugs/etc, as well as pull requests, are welcome in the issues section.
Alex Askerov (@askerov), Mia Alexiou (@subsymbolic) Luke Korth (@lkorth)