Here you can find instructions on how to integrate and use FriendlyScore Connect for iOS.

To get started quickly with FriendlyScore Connect for iOS, clone the GitHub repository and run the example. You will need to sign-up for the free API keys through our Developer Console.

• Xcode 10 or greater
• iOS 12.0 or greater
• FriendlyScore Client Id

Clone and run the demo project from our GitHub repository.

FriendlyScore Connect is a framework distributed using CocoaPods dependency manager. If you are not familiar with this concept, please follow detailed instructions here.

To integrate, add FriendlyScoreConnect to your Podfile

pod 'FriendlyScoreConnect', '~> 1.0.10'

then run following command in your project main directory:

pod install

CocoaPods will install and embed all sources and dependencies into your app.

When Connect is available in customer panel, the SDK will populate a grid of banks to enable connecting and data sharing.

Start with importing FriendlyScoreCore and FriendlyScoreConnect framework in your App Delegate:

import FriendlyScoreCore
import FriendlyScoreConnect

Then configure Connect in application:didFinishLaunchingWithOptions:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // Override point for customisation after application launch.
    FriendlyScore.configureConnect()
    return true
}

In order to handle redirection properly, add line below to application(_:open:options:) function:

func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey: Any] = [:]) -> Bool {
        FriendlyScore.handleQueryParameters(for: url)
        
        return true
    }

Go to the Redirects section of the FriendlyScore developer console and provide your Bundle Identifier.

You will also need your Client Id for the specific environment (SANDBOX, PRODUCTION).

Navigate to your app target, create new URL Types object and add your bundle identifier to Identifier and URL Schemes field, as below:

Start by importing FriendlyScoreCore:

import FriendlyScoreCore

You can select which environment you want to use the FriendlyScore SDK and select the Client Id for that environment

Create the ClientId object

let myClientId = ClientId(stringLiteral: "YOUR_CLIENT_ID")

Create the Credentials object using userReference, which is any alphanumeric string that identifies the user in your systems. It can be used later to access information from the FriendlyScore API :

let myCredentials = Credentials(clientId: myClientId, userReference: "YOUR_USER_REFERENCE", environment: .sandbox)

Now, using the myCredentials object, you can present the FriendlyScore SDK anywhere in you code. Usually this can be done after the user's demand, e.g. tapping a button:

//somewhere in view controller
let button = UIButton(frame: CGRect(x: 0, y: 0, width: 130, height: 45))
button.setTitle("Launch FriendyScore!", for: .normal)
button.addTarget(self, action: #selector(buttonTapHandler), for: .touchUpInside)

self.view.addSubview(button)

FriendlyScoreConnect can be presented with light (default) or dark theme, with are predefined list of colors and icons.

To use custom colors for the categories, you must override the color keys in your application. Custom theme examples is included in the custom_theme.json. The color keys and descriptions are in the Colors section.

/*
    Optional - Built-in themes = .light, .dark, .custom(themePath: String). Default theme is .light
*/
let connectTheme: ConnectTheme = .light

/*
    Optional - Set a flag whether to display only the back button on the screen with the list of banks. Default is true
*/
let showOnlyBackButtonIcon: Bool = true


/*
    Optional - The label to show on the back button on the view with the list of banks to direct users back to your app. Default label is "Back". Ad
*/
let backButtonLabel: String = "Back"

Initiate FriendlyScore View with the options above

@objc func buttonTapHandler(button:UIButton) {
    FriendlyScore.show(with: credentials, theme: .light, showOnlyBackButtonIcon: showOnlyBackButtonIcon, backButtonLabel: backButtonLabel)
}

FriendlyScore will populate different events at different stages. To handle events, please implement following:

FriendlyScore.eventsHandler = { event in
    switch event {
    case .userClosedView:
        print("SDK view closed by user.")
    case .userCompletedFlow:
        print("Friendy Score user completed flow.")
    }
}

To receive information about errors implement errorHandler that throws various FriendlyScoreError objects:

FriendlyScore.errorHandler = { error in
    switch error {
    case .userReferenceAuth:
        print("There was an authentication error for the supplied `userReference`")
    case .server: //unabled to get config
        print("There was a critical error on the server. SDK view closed automatically")
    case .serviceDenied: //wrong client id, access endpoint unpaid
        print("The service you are trying to connect is denied. Reason: \(error.description). SDK view closed automatically")
    }
}

You can continue to integrate FriendlyScore Connect in your app in our sandbox environment. Once you have completed testing, you can access the production environment in the developer console.

Find commonly asked questions and answers in our F.A.Q. You can also contact us via email at developers@friendlyscore.com or speak directly with us on LiveChat.

You can find all the code for FriendlyScore Connect for Web component, iOS and Android on our GitHub.