Table of Contents

1. Cordova Payment Plugin

2. First steps

3. Install instructions for iOS

4. Using The Plugin in Sandbox Mode

5. Using the Plugin with UI (In PCI-DSS Scope: No )

   • Pay with Card/Wallet
   • Pay with Card

6. Example

Cordova Payment Plugin

Interswitch cordova payment plugin allows you to accept payments from customers within your cordova 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 plugin is to register as a merchant. This is described [here] (merchantxuat.interswitchng.com)

First steps

• Create a new cordova project. To do so refer to the documentation here

Plugin installation instructions for iOS

• You'll need to have Xcode 8.3.2 or later installed.

• cd to the directory of your cordova project.

• Add cordova payment plugin

cordova plugin add https://github.com/techquest/cordova-ios-sdk-swift-4.git

• Add ios platform. Make sure to add the platform after adding the plugin.

sudo cordova platform add ios

• In Finder, go to the YourCordovaApp/platforms/ios directory. Open the .xcodeproj file in XCode. A dialog may appear asking: Convert to latest Swift Syntax? Click the Cancel button.

• In Finder, go to the /platforms/ios/<NameOfApp>/Plugins/com.interswitchng.sdk.payment directory. You should see a number of files like .framework file.

• Drag all the ​ .framework files from Finder to XCode's Embedded Binaries section for your app's TARGETS settings. This will be found under the General tab.

• In the dialog that appears, make sure Copy items if needed is unchecked.

• Important: You can only test the SDK on an actual device.

Using The Plugin in Sandbox Mode

During development of your app, you should use the Plugin in sandbox mode to enable testing. Different Client Id and Client Secret are provided for Production and Sandbox mode. The procedure to use the Plugin 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

    function init(){
        var userDetails = {
            clientId: "IKIAF8F70479A6902D4BFF4E443EBF15D1D6CB19E232",
            clientSecret: "ugsmiXPXOOvks9MR7+IFHSQSdk8ZzvwQMGvd0GJva30=",
            paymentApi : "https://sandbox.interswitchng.com",
            passportApi : "https://sandbox.interswitchng.com/passport"
        };
        var initial = PaymentPlugin.init(userDetails);
    }

• Follow the remaining steps in the documentation.
• call the init function inside the onDeviceReady function of your cordova app (VERY IMPORTANT!)
• 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 Plugin with UI (In PCI-DSS Scope: No )

Pay with Card/Wallet

• To allow for Payment with Card or Wallet
• Create a Pay button
• In the onclick event of the Pay button, use this code

1. Set up payment request like this:

    var payRequest = {			
        amount : 100, // Amount in Naira
        customerId : 1234567890, // Optional email, mobile no, BVN etc to uniquely identify the customer.
        currency : "NGN", // ISO Currency code
        description : "Purchase Phone" // Description of product to purchase
    }

2. Create a button to make payment and use this code in the onclick event of the button

    var paySuccess = function(response) {
        var purchaseResponse = JSON.parse(response); // transaction success reponse
        alert(purchaseResponse.message); 
    }
    var payFail = function(response) {
        alert(response); // transaction failure reponse
    }
    PaymentPlugin.pay(payRequest, paySuccess, payFail);

Pay with Card

• To allow for Payment with Card only
• Create a Pay button and set the payment request *Set up payment request like this:

    var payWithCardRequest = {			
        amount : 100, // Amount in Naira
        customerId : 1234567890, // Optional email, mobile no, BVN etc to uniquely identify the customer.
        currency : "NGN", // ISO Currency code
        description : "Purchase Phone" // Description of product to purchase
    }

• In the onclick event of the Pay button, use this code.

  var payWithCardSuccess = function(response) {
    var purchaseResponse = JSON.parse(response); // transaction success reponse
    alert(purchaseResponse.message);
  }
  var payWithCardFail = function(response) {
    alert(response); // transaction failure reponse
  }
  PaymentPlugin.payWithCard(payWithCardRequest, payWithCardSuccess, payWithCardFail);

Example

onDeviceReady: function() {
        this.receivedEvent('deviceready');

        //the init function with client parameters
        function init() {
            var userDetails = {
                clientId: "IKIA7B379B0114CA57FAF8E19F5JKSD83ED2220057EF",
                clientSecret: "MiunSQ5S/N219UCVP3432raPfwK9lMoiV/Pwertv/R4=",
                paymentApi: "https://qa.interswitchng.com",
                passportApi: "https://qa.interswitchng.com/passport"
            };

            var initial = PaymentPlugin.init(userDetails);
        }
        var payWithCard = function() {
            var payWithCardRequest = {
                amount: "20", // Amount in Naira
                customerId: "1234567890", // Optional email, mobile no, BVN etc to uniquely identify the customer.
                currency: "NGN", // ISO Currency code
                description: "Purchase Phone" // Description of product to purchase
            };
            var payWithCardSuccess = function(response) {
                var purchaseResponse = JSON.parse(response);

                alert(purchaseResponse.message);
            }
            var payWithCardFail = function(response) {
                alert(response);
            }
            PaymentPlugin.payWithCard(payWithCardRequest, payWithCardSuccess, payWithCardFail);
        }

        init();


         //Event listener to call the payWithCard function when the button is clicked.

        document.getElementById('payButton').addEventListener('click', function() {
            payWithCard();
        })
    },