Pre-Requisites

Download and install xcode from https://developer.apple.com/xcode/. Latest supporting iOS SDK version is Xcode 13.3.

Before starting integration you must have a valid Integration ID and API Key from the Begini dashboard, while using the SDK these data must be passed to SDK.

To get a Git project into your build

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. Then in the terminal, cd to your Xcode project root directory (where your .xcodeproj file resides) and type:

pod init 

Your Podfile will get open in text mode. Initially there will be some default commands in there. To integrate begini_ios_sdk into your Xcode project using CocoaPods, specify it in your podfile:

pod 'begini_ios_sdk'

Or you can choose the version based on your requirements

 pod 'begini_ios_sdk', '1.2.5'

Make sure to add the frameworks (AWSCore and AWSKMS) in Frameworks, Libraries, and Embedded Content in Projects General Settings and set to Embed & Sign like so.

Recommended Permissions

The following permissions are recommended as the data captured will maximize the predictability of the scoring model. Please note, some of these permissions can still be rejected by the end user.

<key>NSCalendarsUsageDescription</key>

<string>Having access to calendar events helps us determine how busy you are. We use this as a signal for building your credit score.</string> 

Optional Permissions 
 

The following are optional permissions. This data currently has minimal impact on the predictability of the scoring model, but may become more beneficial in future iterations. These permissions can also be added at a later date. Please note, all of these permissions can still be rejected by the end user.

<key>NSContactsUsageDescription</key>

<string>We access your contacts details to determine a list of people you socialise with. This data helps us to then build a social graph to assist with your credit score. We will only use this data for your personal score and we will not contact any of these people in your contact list.</string>

<key>NSLocationWhenInUseUsageDescription</key>

<string>We study locational activity. This helps us estimate with a fair level of accuracy your most visited locations. We use this as a signal for building your credit score.</string>

<key>NSPhotoLibraryUsageDescription</key>

<string>We use read access to Photos to extract geo-location information from image files. This helps us estimate with a fair level of accuracy your most visited locations. We use this as a signal for building your credit score</string>