Android

Payment SDK for Android

Interswitch payment SDK allows you to accept payments from customers within your mobile application. Please Note: The current supported currency is naira (NGN), support for other currencies would be added later The first step to using the Android SDK is to register as a merchant. This is described [here] (merchantxuat.interswitchng.com)

Download the latest SDK

Download the latest SDK from the link below

https://github.com/techquest/isw-payment-sdk-android/releases

It consists of a library:

deviceprint-release-2.2.0.aar

Use Android Studio’s dependency management tool (Gradle) to add the library to your project.

Creating a Project and Adding Library Using Android Studio

Download Android Studio 1.2.2 or later
Create a New Project
Put deviceprint-release-2.2.0.aar in the libs folder of the app.
To add the deviceprint-release-2.2.0.aar library to your project, navigate to File -> New -> New Module -> Import .JAR/.AAR Package option in Android Studio.
Select the deviceprint-release-2.2.0.aar in libs folder
To add the jar files, edit the build.gradle file of your app and add

Java
repositories {
    maven {
        url  'http://dl.bintray.com/techquest/maven-repo'
    }
}
dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:25.1.0'
    compile 'com.android.support:design:25.1.0'
    compile 'com.interswitchng:payment-android:1.0.7'
    compile(name: 'deviceprint-release-2.2.0', ext: 'aar')
}

				
					
				1
2
3
4
5
6
7
8
9
10
11
12
13

						repositories {
    maven {
        url  'http://dl.bintray.com/techquest/maven-repo'
    }
}
dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:25.1.0'
    compile 'com.android.support:design:25.1.0'
    compile 'com.interswitchng:payment-android:1.0.7'
    compile(name: 'deviceprint-release-2.2.0', ext: 'aar')
}

					

			

Finally, rebuild the project

Using The SDK in Sandbox Mode

During development of your app, you should use the SDK in sandbox mode to enable testing. Different Client Id and Client Secret are provided for Production and Sandbox mode. The procedure to use the SDK on sandbox mode is just as easy:

Use Sandbox Client Id and Client Secret got from the Sandbox Tab of the Developer Console after signup(usually you have to wait for 5 minutes after signup for you to see the Sandbox details) everywhere you are required to supply Client Id and Client Secret in the remainder of this documentation
In your code, override the api base as follows

Java
Passport.overrideApiBase(Passport.SANDBOX_API_BASE); 
Payment.overrideApiBase(Payment.SANDBOX_API_BASE);

				1
2

						Passport.overrideApiBase(Passport.SANDBOX_API_BASE); 
Payment.overrideApiBase(Payment.SANDBOX_API_BASE);

Follow the remaining steps in the documentation.
NOTE: When going into Production mode, use the Client Id and the Client Secret got from the Production Tab of Developer Console instead.

Using the SDK with UI (In PCI-DSS Scope: No )

Pay with Card

To allow for Payment with Card
Create a Pay button
In the onClick listener of the Pay button, use this code.Note: Supply your Client Id and Client Secret you got after registering as a Merchant

Note: Supply your Client Id and Client Secret you got after registering as a Merchant Please Note: If you are providing your own transaction reference number, ensure you use the other PayWithCard constructor that accept transaction reference number

Java
//Create a concrete implementation of IswCallback
    public class PaymentCallback extends IswCallback<PurchaseResponse> {
        @Override
        public void onError(Exception error) {
            // Handle error.
            // Payment not successful.
        }

        @Override
        public void onSuccess(PurchaseResponse response) {
        /* Handle success.
           Payment successful. The response object contains fields transactionIdentifier,
           message, amount, token, tokenExpiryDate, panLast4Digits, transactionRef and cardType.
           Save the token, tokenExpiryDate, cardType and panLast4Digits
           in order to pay with the token in the future.
        */
       }
    }
    PaymentCallback paymentCallback = new PaymentCallback();
    RequestOptions options = RequestOptions.builder()
    .setClientId("IKIA335B188FDC3527EDB1E9300D35F6C51826DFC8A5")
    .setClientSecret("4HOFYiMJitFQeHYUCH/pvTF6jpiIaZqzVKB/pheK4Cs=")
    .build();
    Pay pay = new Pay(activity, customerId, paymentDescription, amount, currency, options, paymentCallback);
    pay.start();

				
					
				1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

						//Create a concrete implementation of IswCallback
    public class PaymentCallback extends IswCallback<PurchaseResponse> {
        @Override
        public void onError(Exception error) {
            // Handle error.
            // Payment not successful.
        }
 
        @Override
        public void onSuccess(PurchaseResponse response) {
        /* Handle success.
           Payment successful. The response object contains fields transactionIdentifier,
           message, amount, token, tokenExpiryDate, panLast4Digits, transactionRef and cardType.
           Save the token, tokenExpiryDate, cardType and panLast4Digits
           in order to pay with the token in the future.
        */
       }
    }
    PaymentCallback paymentCallback = new PaymentCallback();
    RequestOptions options = RequestOptions.builder()
    .setClientId("IKIA335B188FDC3527EDB1E9300D35F6C51826DFC8A5")
    .setClientSecret("4HOFYiMJitFQeHYUCH/pvTF6jpiIaZqzVKB/pheK4Cs=")
    .build();
    Pay pay = new Pay(activity, customerId, paymentDescription, amount, currency, options, paymentCallback);
    pay.start();

					

			

Pay with Card

To allow for Payment with Card only
Create a Pay button
In the onClick listener of the Pay button, use this code.Note: Supply your Client Id and Client Secret you got after registering as a Merchant

Java
//Create a concrete implementation of IswCallback
    public class PaymentCallback extends IswCallback<PurchaseResponse> {
        @Override
        public void onError(Exception error) {
            // Handle error.
            // Payment not successful.
        }

        @Override
        public void onSuccess(PurchaseResponse response) {
        /* Handle success.
           Payment successful. The response object contains fields transactionIdentifier,
           message, amount, token, tokenExpiryDate, panLast4Digits, transactionRef and cardType.
           Save the token, tokenExpiryDate, cardType and panLast4Digits
           in order to pay with the token in the future.
        */
       }
    }
    PaymentCallback paymentCallback = new PaymentCallback();
    RequestOptions options = RequestOptions.builder()
    .setClientId("IKIA14BAEA0842CE16CA7F9FED619D3ED62A54239276")
    .setClientSecret("Z3HnVfCEadBLZ8SYuFvIQG52E472V3BQLh4XDKmgM2A=")
    .build();
    PayWithCard payWithCard = new PayWithCard(activity, customerId, paymentDescription, amount,
    currency, options, paymentCallback);
    payWithCard.start();

				
					
				1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

						//Create a concrete implementation of IswCallback
    public class PaymentCallback extends IswCallback<PurchaseResponse> {
        @Override
        public void onError(Exception error) {
            // Handle error.
            // Payment not successful.
        }
 
        @Override
        public void onSuccess(PurchaseResponse response) {
        /* Handle success.
           Payment successful. The response object contains fields transactionIdentifier,
           message, amount, token, tokenExpiryDate, panLast4Digits, transactionRef and cardType.
           Save the token, tokenExpiryDate, cardType and panLast4Digits
           in order to pay with the token in the future.
        */
       }
    }
    PaymentCallback paymentCallback = new PaymentCallback();
    RequestOptions options = RequestOptions.builder()
    .setClientId("IKIA14BAEA0842CE16CA7F9FED619D3ED62A54239276")
    .setClientSecret("Z3HnVfCEadBLZ8SYuFvIQG52E472V3BQLh4XDKmgM2A=")
    .build();
    PayWithCard payWithCard = new PayWithCard(activity, customerId, paymentDescription, amount,
    currency, options, paymentCallback);
    payWithCard.start();

					

			

Validate Card

Validate card is used to check if a card is a valid card, it returns the card balance and token
To call validate card, use this code.Note: * Supply your Client Id and Client Secret you got after registering as a Merchant Please Note: Balance is not returned for VISA Card

Note: * Supply your Client Id and Client Secret you got after registering as a Merchant Please Note: If you are providing your own transaction reference number, ensure you use the other ValidateCard constructor that accept transaction reference number Please Note: Balance is not returned for VISA Card

Java
 //Create a concrete implementation of IswCallback
    public class ValidateCardCallback extends IswCallback<ValidateCardResponse> {
        @Override
        public void onError(Exception error) {
            // Handle error.
            // Card validation not successful
        }

        @Override
        public void onSuccess(ValidateCardResponse response) {
        /* Handle success.
        Card validation successful. The response object contains fields token, tokenExpiryDate
        panLast4Digits, transactionRef, balance and cardType. Save the token, tokenExpiryDate, cardType
        and panLast4Digits in order to pay with the token in the future.
        */
       }
    }
    ValidateCardCallback validateCardCallback = new ValidateCardCallback();
    RequestOptions options = RequestOptions.builder()
    .setClientId("IKIAD6DC1B942D95035FBCC5A4449C893D36536B5D54")
    .setClientSecret("X1u1M6UNyASzslufiyxZnLb3u78TYODVnbRi7OxLNew=")
    .build();
    ValidateCard validateCard = new ValidateCard(activity, customerId, options, validateCardCallback);
    validateCard.start();

				
					
				1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

						 //Create a concrete implementation of IswCallback
    public class ValidateCardCallback extends IswCallback<ValidateCardResponse> {
        @Override
        public void onError(Exception error) {
            // Handle error.
            // Card validation not successful
        }
 
        @Override
        public void onSuccess(ValidateCardResponse response) {
        /* Handle success.
        Card validation successful. The response object contains fields token, tokenExpiryDate
        panLast4Digits, transactionRef, balance and cardType. Save the token, tokenExpiryDate, cardType
        and panLast4Digits in order to pay with the token in the future.
        */
       }
    }
    ValidateCardCallback validateCardCallback = new ValidateCardCallback();
    RequestOptions options = RequestOptions.builder()
    .setClientId("IKIAD6DC1B942D95035FBCC5A4449C893D36536B5D54")
    .setClientSecret("X1u1M6UNyASzslufiyxZnLb3u78TYODVnbRi7OxLNew=")
    .build();
    ValidateCard validateCard = new ValidateCard(activity, customerId, options, validateCardCallback);
    validateCard.start();

					

			

Pay with Token

To allow for Payment with Token only
Create a Pay button
In the onClick listener of the Pay button, use this code.Note: Supply your Client Id and Client Secret you got after registering as a Merchant

Note: Supply your Client Id and Client Secret you got after registering as a Merchant Please Note: If you are providing your own transaction reference number, ensure you use the other PayWithToken constructor that accept transaction reference number

Java
 //Create a concrete implementation of IswCallback
    public class PaymentCallback extends IswCallback<PurchaseResponse> {
        @Override
        public void onError(Exception error) {
            // Handle error.
            // Payment not successful.
        }

        @Override
        public void onSuccess(PurchaseResponse response) {
        /* Handle success.
           Payment successful. The response object contains fields transactionIdentifier,
           message, amount, token, tokenExpiryDate, panLast4Digits, transactionRef and cardType.
           Save the token, tokenExpiryDate, cardType and panLast4Digits
           in order to pay with the token in the future.
        */
       }
    }
    PaymentCallback paymentCallback = new PaymentCallback();
    RequestOptions options = RequestOptions.builder()
    .setClientId("IKIAD6DC1B942D95035FBCC5A4449C893D36536B5D54")
    .setClientSecret("X1u1M6UNyASzslufiyxZnLb3u78TYODVnbRi7OxLNew=")
    .build();
    PayWithToken payWithToken = new PayWithToken(activity, customerId, amount, token, expiryDate, currency,
    cardType panLast4Digits, paymentDescription, options, paymentCallback);
    payWithToken.start();

				
					
				1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

						 //Create a concrete implementation of IswCallback
    public class PaymentCallback extends IswCallback<PurchaseResponse> {
        @Override
        public void onError(Exception error) {
            // Handle error.
            // Payment not successful.
        }
 
        @Override
        public void onSuccess(PurchaseResponse response) {
        /* Handle success.
           Payment successful. The response object contains fields transactionIdentifier,
           message, amount, token, tokenExpiryDate, panLast4Digits, transactionRef and cardType.
           Save the token, tokenExpiryDate, cardType and panLast4Digits
           in order to pay with the token in the future.
        */
       }
    }
    PaymentCallback paymentCallback = new PaymentCallback();
    RequestOptions options = RequestOptions.builder()
    .setClientId("IKIAD6DC1B942D95035FBCC5A4449C893D36536B5D54")
    .setClientSecret("X1u1M6UNyASzslufiyxZnLb3u78TYODVnbRi7OxLNew=")
    .build();
    PayWithToken payWithToken = new PayWithToken(activity, customerId, amount, token, expiryDate, currency,
    cardType panLast4Digits, paymentDescription, options, paymentCallback);
    payWithToken.start();

					

			

Using the SDK without UI (In PCI-DSS Scope: Yes)

Pay with Card/Token

To allow for Payment with Card or Token
Create a UI to collect amount and card details
Create a Pay button
In the onClick listener of the Pay button, use this code.

Note: Supply your Client Id and Client Secret you got after registering as a Merchant

Java
 RequestOptions options = RequestOptions.builder()
    .setClientId("IKIA3E267D5C80A52167A581BBA04980CA64E7B2E70E")
    .setClientSecret("SagfgnYsmvAdmFuR24sKzMg7HWPmeh67phDNIiZxpIY=")
    .build();
    PurchaseRequest request = new PurchaseRequest(); // Setup request parameters
    request.setCustomerId("1234567890"); // Optional email, mobile no, BVN etc to uniquely identify the customer.
    request.setAmount("100"); // Amount in Naira
    request.setCurrency("NGN"); // ISO Currency code
    request.setPan("5060100000000000012"); //Card No or Token
    request.setPinData("1111"); // Optional Card PIN for card payment
    request.setExpiryDate("2004"); // Card or Token expiry date in YYMM format
    request.setRequestorId("11179920172"); // Requestor Identifier 
    request.setCvv2("111");
    request.setTransactionRef(RandomString.numeric(12)); // Generate a unique transaction reference.
    Context context = this; // Reference to your Android Activity

    new PaymentSDK(context, options).purchase(request, new IswCallback<PurchaseResponse>() { 
            //Send payment
            @Override
            public void onError(Exception error) {
                // Handle error and notify the user.
                // Payment not successful.
            }

            @Override
            public void onSuccess(PurchaseResponse response) {
                // Check if OTP is required.
                if (StringUtils.hasText(response.getResponseCode())) {                
                   if (PaymentSDK.SAFE_TOKEN_RESPONSE_CODE.equals(response.getResponseCode())) {
                        // OTP required, ask user for OTP and authorize transaction
                        // See how to authorize transaction with OTP below.
                   }
                   else if (PaymentSDK.CARDINAL_RESPONSE_CODE.equals(response.getResponseCode())) {
                        // redirect user to cardinal authorization page
                        // See how to authorize transaction with Cardinal below.
                   }                   
                }
                else {
                     // OTP not required.
                     // Handle and notify user of successful transaction. 
                     // A token for the card details is returned in the response.
                }
                // The response object contains fields transactionIdentifier, message, 
                // amount, token, tokenExpiryDate, panLast4Digits, otpTransactionIdentifier, 
                // transactionRef and cardType. Save the token, tokenExpiryDate, cardType and 
                // panLast4Digits in order to pay with the token in the future.
            }
    });

				
					
				1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

						 RequestOptions options = RequestOptions.builder()
    .setClientId("IKIA3E267D5C80A52167A581BBA04980CA64E7B2E70E")
    .setClientSecret("SagfgnYsmvAdmFuR24sKzMg7HWPmeh67phDNIiZxpIY=")
    .build();
    PurchaseRequest request = new PurchaseRequest(); // Setup request parameters
    request.setCustomerId("1234567890"); // Optional email, mobile no, BVN etc to uniquely identify the customer.
    request.setAmount("100"); // Amount in Naira
    request.setCurrency("NGN"); // ISO Currency code
    request.setPan("5060100000000000012"); //Card No or Token
    request.setPinData("1111"); // Optional Card PIN for card payment
    request.setExpiryDate("2004"); // Card or Token expiry date in YYMM format
    request.setRequestorId("11179920172"); // Requestor Identifier 
    request.setCvv2("111");
    request.setTransactionRef(RandomString.numeric(12)); // Generate a unique transaction reference.
    Context context = this; // Reference to your Android Activity
 
    new PaymentSDK(context, options).purchase(request, new IswCallback<PurchaseResponse>() { 
            //Send payment
            @Override
            public void onError(Exception error) {
                // Handle error and notify the user.
                // Payment not successful.
            }
 
            @Override
            public void onSuccess(PurchaseResponse response) {
                // Check if OTP is required.
                if (StringUtils.hasText(response.getResponseCode())) {                
                   if (PaymentSDK.SAFE_TOKEN_RESPONSE_CODE.equals(response.getResponseCode())) {
                        // OTP required, ask user for OTP and authorize transaction
                        // See how to authorize transaction with OTP below.
                   }
                   else if (PaymentSDK.CARDINAL_RESPONSE_CODE.equals(response.getResponseCode())) {
                        // redirect user to cardinal authorization page
                        // See how to authorize transaction with Cardinal below.
                   }                   
                }
                else {
                     // OTP not required.
                     // Handle and notify user of successful transaction. 
                     // A token for the card details is returned in the response.
                }
                // The response object contains fields transactionIdentifier, message, 
                // amount, token, tokenExpiryDate, panLast4Digits, otpTransactionIdentifier, 
                // transactionRef and cardType. Save the token, tokenExpiryDate, cardType and 
                // panLast4Digits in order to pay with the token in the future.
            }
    });

					

			

Validate Card and Get Token

To check if a card is valid and get a token
Create a UI to collect card details
Create a Validate/Add Card button
In the onClick listener of the Validate/Add Card button, use this code.

Note: Supply your Client Id and Client Secret you got after registering as a Merchant Please Note: Balance is not returned for VISA Card

Java
RequestOptions options = RequestOptions.builder()
    .setClientId("IKIA3E267D5C80A52167A581BBA04980CA64E7B2E70E")
    .setClientSecret("SagfgnYsmvAdmFuR24sKzMg7HWPmeh67phDNIiZxpIY=")
    .build();
    ValidateCardRequest request = new ValidateCardRequest(); // Setup request parameters
    request.setCustomerId("1234567890"); // Optional email, mobile no, BVN etc to uniquely identify the customer.
    request.setPan("5060100000000000012"); //Card No or Token
    request.setPinData("1111"); // Optional Card PIN for card payment
    request.setExpiryDate("2004"); // Card or Token expiry date in YYMM format
    request.setCvv2("111"); // Card Verification Value
    request.setTransactionRef(RandomString.numeric(12)); // Generate a unique transaction reference.
    Context context = this; // Reference to your Android Activity.
    new PaymentSDK(context, options).validateCard(request, new IswCallback<ValidateCardResponse>() { 
            //Send payment
            @Override
            public void onError(Exception error) {
                // Handle error and notify the user.
                // Payment not successful.
            }

            @Override
            public void onSuccess(ValidateCardResponse response) {
                // Check if OTP is required.
                if (StringUtils.hasText(response.getResponseCode())) {                
                   if (PaymentSDK.SAFE_TOKEN_RESPONSE_CODE.equals(response.getResponseCode())) {
                        // OTP required, ask user for OTP and authorize transaction
                        // See how to authorize transaction with OTP below.
                   }
                   else if (PaymentSDK.CARDINAL_RESPONSE_CODE.equals(response.getResponseCode())) {
                        // redirect user to cardinal authorization page
                        // See how to authorize transaction with Cardinal below.
                   }                   
                }
                else {
                     // OTP not required.
                     // Handle and notify user of successful transaction. 
                     // A token for the card details is returned in the response.
                }
                // The response object contains fields transactionIdentifier, 
                // message,token, tokenExpiryDate, panLast4Digits, otpTransactionIdentifier
                // transactionRef and cardType. 
                // Save the token, tokenExpiryDate, cardType and panLast4Digits 
                // in order to pay with the token in the future.
            }
    });

				
					
				1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

						RequestOptions options = RequestOptions.builder()
    .setClientId("IKIA3E267D5C80A52167A581BBA04980CA64E7B2E70E")
    .setClientSecret("SagfgnYsmvAdmFuR24sKzMg7HWPmeh67phDNIiZxpIY=")
    .build();
    ValidateCardRequest request = new ValidateCardRequest(); // Setup request parameters
    request.setCustomerId("1234567890"); // Optional email, mobile no, BVN etc to uniquely identify the customer.
    request.setPan("5060100000000000012"); //Card No or Token
    request.setPinData("1111"); // Optional Card PIN for card payment
    request.setExpiryDate("2004"); // Card or Token expiry date in YYMM format
    request.setCvv2("111"); // Card Verification Value
    request.setTransactionRef(RandomString.numeric(12)); // Generate a unique transaction reference.
    Context context = this; // Reference to your Android Activity.
    new PaymentSDK(context, options).validateCard(request, new IswCallback<ValidateCardResponse>() { 
            //Send payment
            @Override
            public void onError(Exception error) {
                // Handle error and notify the user.
                // Payment not successful.
            }
 
            @Override
            public void onSuccess(ValidateCardResponse response) {
                // Check if OTP is required.
                if (StringUtils.hasText(response.getResponseCode())) {                
                   if (PaymentSDK.SAFE_TOKEN_RESPONSE_CODE.equals(response.getResponseCode())) {
                        // OTP required, ask user for OTP and authorize transaction
                        // See how to authorize transaction with OTP below.
                   }
                   else if (PaymentSDK.CARDINAL_RESPONSE_CODE.equals(response.getResponseCode())) {
                        // redirect user to cardinal authorization page
                        // See how to authorize transaction with Cardinal below.
                   }                   
                }
                else {
                     // OTP not required.
                     // Handle and notify user of successful transaction. 
                     // A token for the card details is returned in the response.
                }
                // The response object contains fields transactionIdentifier, 
                // message,token, tokenExpiryDate, panLast4Digits, otpTransactionIdentifier
                // transactionRef and cardType. 
                // Save the token, tokenExpiryDate, cardType and panLast4Digits 
                // in order to pay with the token in the future.
            }
    });

					

			

Authorize PayWithCard using OTP

Java
if (StringUtils.hasText(response.getResponseCode())) { // 
    if (PaymentSDK.SAFE_TOKEN_RESPONSE_CODE.equals(response.getResponseCode())) {
        AuthorizePurchaseRequest request = new AuthorizePurchaseRequest();
        request.setPaymentId(response.getPaymentId()); // Set the payment identifier for the request
        request.setAuthData(request.getAuthData()); // Set the request Auth Data
        request.setOtp("123456"); // Accept OTP from user
         new PaymentSDK(context, options)
         .authorizePurchase(request, new IswCallback<AuthorizePurchaseResponse>() {
            @Override
            public void onError(Exception error) {
                // Handle and notify user of error
            }
            @Override
            public void onSuccess(AuthorizePurchaseResponse otpResponse) {
                 //Handle and notify user of successful transaction
            }
        });
    }
    if (PaymentSDK.CARDINAL_RESPONSE_CODE.equals(response.getResponseCode())) {
        // Create WebView to process the Authorize purchase request
        webView = new AuthorizeWebView(context, response) {
            @Override
            public void onPageDone() {                    
                AuthorizePurchaseRequest request = new AuthorizePurchaseRequest();
                request.setAuthData(request.getAuthData()); // Set the request Auth Data.
                request.setPaymentId(response.getPaymentId()); // Set the payment identifier for the request.
                request.setTransactionId(response.getTransactionId()); // Set payment identifier for the request.
                request.setEciFlag(response.getEciFlag());   // Set the Electronic Commerce Indicator (ECI).
                new PaymentSDK(context, options)
                .authorizePurchase(request, new IswCallback<AuthorizePurchaseResponse>() {
                    @Override
                    public void onError(Exception error) {
                        // Handle and notify user of error
                    }
                    @Override
                    public void onSuccess(AuthorizePurchaseResponse response) {
                        //Handle and notify user of successful transaction
                    }
                });
            }
            @Override
            public void onPageError(Exception error) {
                // Handle and notify user of error
            }
        };
        // Other webview customizations goes here e.g.
        webView.requestFocus(View.FOCUS_DOWN);
        webView.getSettings().setJavaScriptEnabled(true);
        webView.setVerticalScrollBarEnabled(true);
    }
}

				
					
				1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

						if (StringUtils.hasText(response.getResponseCode())) { // 
    if (PaymentSDK.SAFE_TOKEN_RESPONSE_CODE.equals(response.getResponseCode())) {
        AuthorizePurchaseRequest request = new AuthorizePurchaseRequest();
        request.setPaymentId(response.getPaymentId()); // Set the payment identifier for the request
        request.setAuthData(request.getAuthData()); // Set the request Auth Data
        request.setOtp("123456"); // Accept OTP from user
         new PaymentSDK(context, options)
         .authorizePurchase(request, new IswCallback<AuthorizePurchaseResponse>() {
            @Override
            public void onError(Exception error) {
                // Handle and notify user of error
            }
            @Override
            public void onSuccess(AuthorizePurchaseResponse otpResponse) {
                 //Handle and notify user of successful transaction
            }
        });
    }
    if (PaymentSDK.CARDINAL_RESPONSE_CODE.equals(response.getResponseCode())) {
        // Create WebView to process the Authorize purchase request
        webView = new AuthorizeWebView(context, response) {
            @Override
            public void onPageDone() {                    
                AuthorizePurchaseRequest request = new AuthorizePurchaseRequest();
                request.setAuthData(request.getAuthData()); // Set the request Auth Data.
                request.setPaymentId(response.getPaymentId()); // Set the payment identifier for the request.
                request.setTransactionId(response.getTransactionId()); // Set payment identifier for the request.
                request.setEciFlag(response.getEciFlag());   // Set the Electronic Commerce Indicator (ECI).
                new PaymentSDK(context, options)
                .authorizePurchase(request, new IswCallback<AuthorizePurchaseResponse>() {
                    @Override
                    public void onError(Exception error) {
                        // Handle and notify user of error
                    }
                    @Override
                    public void onSuccess(AuthorizePurchaseResponse response) {
                        //Handle and notify user of successful transaction
                    }
                });
            }
            @Override
            public void onPageError(Exception error) {
                // Handle and notify user of error
            }
        };
        // Other webview customizations goes here e.g.
        webView.requestFocus(View.FOCUS_DOWN);
        webView.getSettings().setJavaScriptEnabled(true);
        webView.setVerticalScrollBarEnabled(true);
    }
}

					

			

Authorize Card Validation using OTP

Java
if (StringUtils.hasText(response.getResponseCode())) { // 
    if (PaymentSDK.SAFE_TOKEN_RESPONSE_CODE.equals(response.getResponseCode())) {
        AuthorizeCardRequest request = new AuthorizeCardRequest();
        request.setTransactionRef(response.getTransactionRef()); // Set the transaction reference for the request
        request.setAuthData(request.getAuthData()); // Set the request Auth Data
        request.setOtp("123456"); // Accept OTP from user
         new PaymentSDK(context, options)
         .authorizeCard(request, new IswCallback<AuthorizeCardResponse>() {
            @Override
            public void onError(Exception error) {
                // Handle and notify user of error
            }
            @Override
            public void onSuccess(AuthorizeCardResponse authorizeCardResponse) {
                 //Handle and notify user of successful transaction
            }
        });
    }
    if (PaymentSDK.CARDINAL_RESPONSE_CODE.equals(response.getResponseCode())) {
        // Create WebView to process the Authorize purchase request
        webView = new AuthorizeWebView(context, response) {
            @Override
            public void onPageDone() {                    
                AuthorizeCardRequest request = new AuthorizeCardRequest();
                request.setAuthData(request.getAuthData()); // Set the request Auth Data.
                request.setPaymentId(response.getPaymentId()); // Set the payment identifier for the request.
                request.setTransactionId(response.getTransactionId()); // Set payment identifier for the request.
                request.setEciFlag(response.getEciFlag());   // Set the Electronic Commerce Indicator (ECI).
                new PaymentSDK(context, options)
                .authorizeCard(request, new IswCallback<AuthorizeCardResponse>() {
                    @Override
                    public void onError(Exception error) {
                        // Handle and notify user of error
                    }
                    @Override
                    public void onSuccess(AuthorizeCardResponse response) {
                        //Handle and notify user of successful transaction
                    }
                });
            }
            @Override
            public void onPageError(Exception error) {
                // Handle and notify user of error
            }
        };
        // Other webview customizations goes here e.g.
        webView.requestFocus(View.FOCUS_DOWN);
        webView.getSettings().setJavaScriptEnabled(true);
        webView.setVerticalScrollBarEnabled(true);
    }
}

				
					
				1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

						if (StringUtils.hasText(response.getResponseCode())) { // 
    if (PaymentSDK.SAFE_TOKEN_RESPONSE_CODE.equals(response.getResponseCode())) {
        AuthorizeCardRequest request = new AuthorizeCardRequest();
        request.setTransactionRef(response.getTransactionRef()); // Set the transaction reference for the request
        request.setAuthData(request.getAuthData()); // Set the request Auth Data
        request.setOtp("123456"); // Accept OTP from user
         new PaymentSDK(context, options)
         .authorizeCard(request, new IswCallback<AuthorizeCardResponse>() {
            @Override
            public void onError(Exception error) {
                // Handle and notify user of error
            }
            @Override
            public void onSuccess(AuthorizeCardResponse authorizeCardResponse) {
                 //Handle and notify user of successful transaction
            }
        });
    }
    if (PaymentSDK.CARDINAL_RESPONSE_CODE.equals(response.getResponseCode())) {
        // Create WebView to process the Authorize purchase request
        webView = new AuthorizeWebView(context, response) {
            @Override
            public void onPageDone() {                    
                AuthorizeCardRequest request = new AuthorizeCardRequest();
                request.setAuthData(request.getAuthData()); // Set the request Auth Data.
                request.setPaymentId(response.getPaymentId()); // Set the payment identifier for the request.
                request.setTransactionId(response.getTransactionId()); // Set payment identifier for the request.
                request.setEciFlag(response.getEciFlag());   // Set the Electronic Commerce Indicator (ECI).
                new PaymentSDK(context, options)
                .authorizeCard(request, new IswCallback<AuthorizeCardResponse>() {
                    @Override
                    public void onError(Exception error) {
                        // Handle and notify user of error
                    }
                    @Override
                    public void onSuccess(AuthorizeCardResponse response) {
                        //Handle and notify user of successful transaction
                    }
                });
            }
            @Override
            public void onPageError(Exception error) {
                // Handle and notify user of error
            }
        };
        // Other webview customizations goes here e.g.
        webView.requestFocus(View.FOCUS_DOWN);
        webView.getSettings().setJavaScriptEnabled(true);
        webView.setVerticalScrollBarEnabled(true);
    }
}

					

			

Authorize PayWithWallet using OTP

Java
if (StringUtils.hasText(response.getOtpTransactionIdentifier())) { // 
            AuthorizeOtpRequest otpRequest = new AuthorizeOtpRequest(); 
            // Setup request parameters using the selected Payment Method
            otpRequest.setOtp("123456"); // Accept OTP from user
            // Set the OTP identifier for the request
            otpRequest.setOtpTransactionIdentifier(response.getOtpTransactionIdentifier()); 
             // Set the unique transaction reference.
            otpRequest.setTransactionRef(response.getTransactionRef());
            //Authorize OTP Request
            AuthorizeOtpResponse otpResponse = new PurchaseClient(options).authorizeOtp(otpRequest);  
            //Handle and notify user of successful transaction               
    }

				
					
				1
2
3
4
5
6
7
8
9
10
11
12

						if (StringUtils.hasText(response.getOtpTransactionIdentifier())) { // 
            AuthorizeOtpRequest otpRequest = new AuthorizeOtpRequest(); 
            // Setup request parameters using the selected Payment Method
            otpRequest.setOtp("123456"); // Accept OTP from user
            // Set the OTP identifier for the request
            otpRequest.setOtpTransactionIdentifier(response.getOtpTransactionIdentifier()); 
             // Set the unique transaction reference.
            otpRequest.setTransactionRef(response.getTransactionRef());
            //Authorize OTP Request
            AuthorizeOtpResponse otpResponse = new PurchaseClient(options).authorizeOtp(otpRequest);  
            //Handle and notify user of successful transaction               
    }

					

			

Checking Payment Status

To check the status of a payment made, use the code below

Java
//Pass the transactionRef and the amount as the parameters to getPaymentStatus()
	PaymentStatusRequest request = new PaymentStatusRequest();	 
	request.setTransactionRef("117499114589");
	request.setAmount("100");
	new PaymentSDK(context, options).getPaymentStatus(request, new IswCallback<PaymentStatusResponse>() {
            @Override
            public void onError(Exception error) {
                // Handle and notify user of error
            }

            @Override
            public void onSuccess(PaymentStatusResponse response) {
                // Update Payment Status
            }
    });

				
					
				1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

						//Pass the transactionRef and the amount as the parameters to getPaymentStatus()
	PaymentStatusRequest request = new PaymentStatusRequest();	 
	request.setTransactionRef("117499114589");
	request.setAmount("100");
	new PaymentSDK(context, options).getPaymentStatus(request, new IswCallback<PaymentStatusResponse>() {
            @Override
            public void onError(Exception error) {
                // Handle and notify user of error
            }
 
            @Override
            public void onSuccess(PaymentStatusResponse response) {
                // Update Payment Status
            }
    });

					

			

Articles

GitHub

Payment SDK for Android

Download the latest SDK

Creating a Project and Adding Library Using Android Studio

Using The SDK in Sandbox Mode

Using the SDK with UI (In PCI-DSS Scope: No )

Pay with Card

Pay with Card

Validate Card

Pay with Token

Using the SDK without UI (In PCI-DSS Scope: Yes)

Pay with Card/Token

Validate Card and Get Token

Authorize PayWithCard using OTP

Authorize Card Validation using OTP

Authorize PayWithWallet using OTP

Checking Payment Status

Articles

How can we help?