cyupa/card-management-sdk-ios

SDKs to help card issuers to consume our APIs from iOS applications

Network International iOS Card Management SDK

The Network International iOS Card Management SDK allows you to integrate with Network International standard APIs for card management. (https://developer.network.ae) The current supported features are:

1. Get Secured Card Details : Display a card component providing the ability to show card number, expiry date, CVV and cardholder name. This supports full end to end encryption to securely transport this sensitive information.
2. Set PIN : Displays a PIN pad to allow cardholder to set a PIN on their new card. The PIN is end to end encrypted to securely transport this sensitive information
3. Change PIN: Displays two PIN pad to allow the cardholder to change their PIN by providing old & new PIN. The PINs are end to end encrypted to securely transport this sensitive information

Requirements

The Network International iOS Card Management SDK requires Xcode 13 and later and works with iOS version 12 and above.

Installation

We support all the popular iOS dependency management tools. The SDK can be added via CocoaPods or using Swift Package Manager. We offer, the possibility to add the XCFramework manually into your project, as well.

XCFramework

Steps to connect our iOS SDK to your iOS application:

1. Drag NICardManagementSDK.xcframework to the Frameworks, Libraries and Embedded Content section of your project target: General -> Frameworks, Libraries and Embedded Content.
2. Make sure the “Embed & Sign” option is set on Embed tab.
3. If your application is written with Objective C, perform an additional step: Build settings -> Build Options -> Always Embed Swift Standard Libraries set YES

Swift Package Manager

From Xcode simply select File > Swift Packages > Add Package Dependency... and paste https://github.com/network-international/cardmanagement-sdk-ios to search field. You can specify rules according to your preferences and you are ready to use.

CocoaPods

The steps to install it via CocoaPods:

1. Create a Podfile in the root directory where the .xcodeproj file resides.
2. Add pod 'NICardManagementSDK’ to the Podfile created in the above step.
3. Close Xcode and run pod install command on the directory where the Podfile was created.
4. After performing the above step, open the .xcworkspace file that was created, to open your project.

Integration

Basics

After you have installed the SDK, by following one of the above set of steps, you can import the SDK into your iOS app and used it.

Swift:

import NICardManagementSDK

Usage

Create NIInput model

Swift:

    let input = NIInput(bankCode: bankCode,
                        cardIdentifierId: cardIdentifierId,
                        cardIdentifierType: cardIdentifierType,
                        connectionProperties: NIConnectionProperties(rootUrl: rootUrl, token: token),
                        displayAttributes: NIDisplayAttributes(theme: .light, language: language))
    NICardManagementAPI.displayCardDetailsForm(input: input, viewController: self) { successResponse, errorResponse in
        // handle error and success
    }

Form Factory Interface

Display Card Details Form

The form interface will display the card details in a new screen (UIViewController). The card info displayed are: Card Number, Expiry Date, CVV and Cardholder Name.

func displayCardDetailsForm(input: NICardManagementSDK.NIInput, viewController: UIViewController, completion: @escaping (NICardManagementSDK.NISuccessResponse?, NICardManagementSDK.NIErrorResponse?) -> Void)

Swift:

    NICardManagementAPI.displayCardDetailsForm(input: input, viewController: self) { successResponse, errorResponse in
        // handle error and success
    }

Set PIN Form

A PIN-pad will be displayed into a separate screen (UIViewController). A message will be displayed in case of success and failure.

Swift:

NICardManagementAPI.setPinForm(input: input, type: pinType, viewController: self) { successResponse, errorResponse in
	//  handle here error and success
}

or without specifying the type (pin length)

NICardManagementAPI.setPinForm(input: input, viewController: self) { successResponse, errorResponse in
	// handle here error and success
}

Change PIN Form

A PIN-pad will be displayed into a separate screen (UIViewController). Change PIN is a two step flow: 1.Capture current PIN 2.Capture new PIN A message will be displayed in case of success and failure.

NICardManagementAPI.changePinForm(input: input, type: pinType, viewController: self) { successResponse, errorResponse in
	//  handle here error and success
}

or without specifying the type (pin length)

NICardManagementAPI.changePinForm(input: input, viewController: self) { successResponse, errorResponse in
	// handle here error and success
}