Pre-requisites

Download and install Android Studio from https://developer.android.com/studio. Latest supporting Android SDK version is Android Studio Bumblebee | 2021.1.1 Patch 2. The SDK is also supporting the Android Studio Arctic Fox | 2020.3.1 Beta 4.

Use build tools version 31.0.0

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 in your build

Step 1. Add the token to $HOME/.gradle/gradle.properties found in the dashboard under your Android deployment.

authToken=#########################f9hj

Step 2. Add the JitPack repository to your build file.

Add it in your Project level build.gradle file.

repositories {
    ...
    maven {
       url 'https://jitpack.io'
       credentials { username authToken }
   }
 }

dependencies {
	implementation 'com.github.begini-credit:begini-sdk-android:2.1.15-live-v4'
} 

Permissions that need to be declared on your Android manifest.

Mandatory permissions

Internet access

<uses-permission android:name="android.permission.INTERNET"/>

The following permissions are mandatory if BeginiCoreService is used instead of BeginiCoreActivity. Service and Activity usage will be explained in this document.

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" /> 
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> 
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />

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.

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> 
<uses-permission android:name="android.permission.READ_CALENDAR"/>
<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<uses-permission android:name="android.permission.BLUETOOTH_SCAN"/>

Optional permissions

The following permissions can be implemented but will require a Permission Declaration form to justify why this data should be accessed. You will then be subjected to further application review to gain an additional approval from Google to access this data. 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.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> 
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> 
<uses-permission android:name="android.permission.READ_CONTACTS"/>
<uses-permission android:name="android.permission.READ_CALL_LOG"/> 
<uses-permission android:name="android.permission.READ_SMS" /> 
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" /> 
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" /> 
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />