Fusion APIs that deal with retrieval of Card information require the organization to be PCI DSS compliant. To avoid the burden of PCI compliance, Fusion introduces Card SDKs. By integrating these Card SDKs, the organizations can fetch sensitive Card details like PAN, Card CVV, and more.

In this article, SDK integration is documented in both Swift and Objective C languages.

Before you begin

Take care of the following prerequisites before you begin with SDK setup:

• Fusion uses an authentication token to authenticate the SDK. To know how to generate an authentication token, see SDK Authentication.
• Minimum iOS version required: 10
• Minimum Cocoapods version required: 1.9.1
  
• Install the code editor XCode.

Getting Started with iOS Card SDK

Follow the steps below to integrate SDK:

1. Download the Framework which contains the structure and required libraries for your Project. 
2. Now  install the SDK in your app.
3. Prepare the   SDK setup.
4. Now the SDK setup is ready to begin with verifying the SDK. 

Step 1: Download the Framework

In Fusion, the SDKs are built on top of a Framework  which is a combined set of libraries to help you easily create a production-ready app, by providing a unified platform from where you can manage your app and observe the analytics of the app. The XC Framework packaging is used to package different variants of the Framework to support any platform such as iOS, macOS and others. 

Extract the below zip folder containing XCFramework. 

Step 2: Install the SDK

The iOS Card SDK is compatible with apps supporting iOS 10 and above. To install the SDK, follow these steps:

1. Drag & drop XCFramework manually into your project's target. 
   

2. Click Embed & sign under the XCFramework in your project's target. 
   

3. Set Allow Non-modular Includes in Framework Modules to "YES" under Target > Build Settings.

4. Set Enable Bitcode to "NO" under Target > Build Settings.

Step 3: Set up the SDK

Follow the steps below to set up the SDK: 

1. Adding the Configuration file

A configuration file contains all the configurations necessary for activating the SDK. You should add the file to your project to prepare your app to work with the SDK. You will receive the configuration file through email. If you haven't received the file, contact Zeta.  

2. Declaring the SDK

To access the iOS Card APIs, you need to create an instance of ApolloCardManager. We recommend keeping the ApolloCardManager instance global in your AppDelegate file.

var cardManager: ApolloCardManager?

@property (nonatomic, strong) ApolloCardManager *cardManager; 

3. Initializing the SDK

You should initialize the ApolloCardManager object to access the Card SDK APIs. This object is assigned to the variable CardManager as shown in the below code snippet. We recommend to initialize the SDK on the app launch itself.

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    self.cardManager = ApolloCardManager()
     return true
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

 self.cardManager = [[ApolloCardManager alloc] init]; 
 return YES;
} 

4. Registering the SDK

Card SDK registration triggers the authentication of the SDK using an authentication token. This token is also called a JSON Web Token (JWT) token. Registering the Card SDK involves only two steps:

1. Create the authentication token (JWT Token). To know how to generate an authentication token, see SDK Authentication.
2. Invoke a call to registerSDK method by passing the authentication token.

On successful authentication of SDK, you can access the getCardWithCardID and setPinWithCardID APIs. 

Please ensure to set a valid JWT token every time to register the SDK. We recommend calling the method inside the following Application function.

func applicationDidBecomeActive(_ application: UIApplication) {
    self.cardManager?.registerSDK(authToken:<JWT_TOKEN>)
}

- (void)applicationDidBecomeActive:(UIApplication *)application {
    [self.cardManager registerSDKWithAuthToken:<JWT_TOKEN>];
 
}

Step 4: Verify the SDK

After successful SDK setup, you can validate the SDK integration using the following APIs:

• Fetch Card Details
• Set Card PIN
• Log out

Fetch Card Details

Fetch Card Details API enables you to retrieve Card information. In this API call, you should pass the Card identifier (CardID). 

Parameters descriptions:

• CardID: A unique identifier of the Card whose details are to be fetched.

let cardID = "<<some card id>>"
self.cardManager?.getCardWithCardID(cardID, authToken:authToken, success: { (card : ApolloCard?) in
            print("Card = %@", card);
        }) { (error : Error?) in
            print("Error = %@", error);
        }

[self.cardManager getCardWithCardID:@"<<CARD_ID>>"     
                    success:^(ApolloCard *card) {
                       //  << SUCCESS_BLOCK >>
                    }
                    failure:^(NSError *error) {
                      // <<FAILURE_BLOCK>>
}];

@interface ApolloCard : NSObject

@property (nonatomic, readonly) NSString *CardID;
@property (nonatomic, readonly) NSString *crn;
@property (nonatomic, readonly) NSString *CardType;
@property (nonatomic, readonly) NSString *maskedPan;
@property (nonatomic, readonly) NSString *CardStatus;
@property (nonatomic, readonly) NSString *associatedAt;
@property (nonatomic, readonly) ApolloDecryptedCardDetails 
@property (nonatomic, readonly) NSString *tenantAttributes;
@property (nonatomic, readonly) BinRange *binRange;
@property (nonatomic, readonly) NSArray *vectors;
@property (nonatomic, readonly) NSString *CardSku;
@property (nonatomic, readonly) NSString *headers;
@property (nonatomic, readonly) SensitiveView *sensitiveView;
@property (nonatomic, readonly) NSDictionary *rawCardDetails;
@end

@interface ApolloDecryptedCardDetails: NSObject //Deprecated. The decrypted Card details will be removed in future versions. For now you can use NSDictionary instead of ApolloDecryptedCardDetails.

@property (nonatomic, readonly) NSString *CardID;
@property (nonatomic, readonly) NSString *createdAt;
@property (nonatomic, readonly) NSString *cvv;
@property (nonatomic, readonly) NSString *expiry;
@property (nonatomic, readonly) BOOL isVirtual;
@property (nonatomic, readonly) NSString *pan;
@end

@interface BinRange: NSObject

@property (nonatomic, readonly) NSString *bin;
@property (nonatomic, readonly) NSString *range;
@end

@interface SensitiveView: NSObject

@property (nonatomic, readonly) NSString *algo;
@property (nonatomic, readonly) SensitiveViewValue *value;
@end

@interface SensitiveViewValue: NSObject

@property (nonatomic, readonly) NSString *serverPublicKey;
@property (nonatomic, readonly) NSString *encryptedData;
@property (nonatomic, readonly) NSString *iv;
@end

 CardManager?.setPinWithCardID("<<Card_id>>",
              pin: "<<new_pin>>",
              success: {
                          NSLog("Changed pin successfully")
   					   },
              failure: { (errorInfo) in
                          NSLog("Failed to change pin");
})

[self.cardManager setPinWithCardID:@"<<CARD_ID>>" pin:@"<<NEW_PIN>>" success:^{
          //  << SUCCESS_BLOCK >>
      } failure:^(ApolloCardErrorInfo *userInfo) {
          // <<FAILURE_BLOCK>>
      }];

Logout

When a user logs out from the app, ensure that you clear all the session data. A default call to Logout method is important for the SDK to work properly in next login session.

A simple logout is available by using: 

self.cardManager?.logout()

[self.CardManager logout]