Skip to content

Latest commit

 

History

History
138 lines (102 loc) · 4.71 KB

README.md

File metadata and controls

138 lines (102 loc) · 4.71 KB
Raw

Swedbank Banklink Android SDK

The Swedbank Banklink Android SDK lets you quickly integrate Swedbank Banklink payment solution in native Android applications and establish communication between Swedbank’s Android app and merchants Android app.

Getting Started

Add the Swedbank Banklink Android SDK to your project

dependencies {
  compile 'com.swedbank.sdk:banklink:1.0.0'
}

Install the latest version of Swedbank app on your Android device

Swedbank app is available on the Google Play Store.

  • Banklink is supported in Estonian, Latvian and Lithuanian apps.
  • Banklink API is supported in versions 6.8 and later.

Initiating a banklink transaction from your app

First, create an instance of BanklinkClient:

BanklinkClient eeClient = BanklinkSdk.createClient(app, BanklinkApi.Country.EE)

Note: if you want to use banklink SDK for multiple countries, you must create new client for each country.

Then, start the Swedbank app with created banklink intent

The packetMap of type Map<String, String> represents a signed Banklink packet parameters which are usually sent to Swedbank banklink server over HTTP protocol using POST method, but here it should be sent to Swedbank native app with Intent object. Merchant app should prepare packet parameters(VK_SERVICE, VK_VERSION, VK_SND_ID etc.) and calculate MAC value(VK_MAC).

// obtain signed packet map
try {
  Intent intent = eeClient.createBanklinkIntent(packetMap);
  startActivityForResult(intent, BANKLINK_REQUEST_CODE);
} catch (ActivityNotFoundException e) {
  // Swedbank app not installed. Show Swedbank app in Google Play Store.
  eeClient.openSwedbankAppPlayStoreListing();
}

When the user's Android device switches over to Swedbank app, the details of the transaction are prepopulated. The user can either execute the transaction(confirming with selected authentication method, if required) or cancel it. Either way, when the action completes, the device returns to your app and provides details of the result.

Finally, handle transaction results

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  if (requestCode == BANKLINK_REQUEST_CODE) {
    BanklinkResult result = eeClient.parseResult(resultCode, data);
    if (result.success()) {
      Map<String, String> responsePacket = result.responsePacket();
      // handle success
    } else {
      if (result.canceled()) {
        // handle user canceled transaction
      } else {
        // handle errors
      }
    }
  } else {
    super.onActivityResult(requestCode, resultCode, data);
  }
}

Swedbank app availability checks

Swedbank app of version 6.8 or later is required to be installed on user device. Swedbank Banklink Android SDK provides a possibility to detect such cases and make some workarounds for that.

One option is to try to start activity from Intent and handle exception

// obtain signed packet map
try {
  Intent intent = eeClient.createBanklinkIntent(packetMap);
  startActivityForResult(intent, BANKLINK_REQUEST_CODE);
} catch (ActivityNotFoundException e) {
  // Swedbank app not installed. Try to send Banklink packet parameters to Swedbank banklink server over HTTP protocol using browser or WebView.
}

Another option is to explicitly check whether suitable application is installed or not.

if(!client.isSupportedSwedbankAppInstalled()) {
  // Swedbank app not installed. Try to send Banklink packet parameters to Swedbank banklink server over HTTP protocol using browser or WebView..
}

See BanklinkClient Javadoc for more information.

Documentation

Updates

All updates can be found in the CHANGELOG.

Bugs and Feedback

For bugs, questions and discussions please use the Github Issues.

License

Copyright 2017 Swedbank

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.