Account Linking

​
Good to know: account linking is useful if you wish to use AIS (Account Information Service) or skip authentication steps when initiating payments via the in-app payments module.
Implement invocation function in native module
In order to configure kevin. SDK account linking module, you will need to add configurations into the native platform specific components.
Android
KevinModule.kt
class KevinModule internal constructor(context: ReactApplicationContext?) :
    ReactContextBaseJavaModule(context) {
​
    private var callback: Callback? = null
​
    //...
​
    @ReactMethod
    fun openKevinAccountLinking(state: String, callback: Callback) {
        try {
            val accountLinkingConfiguration = AccountSessionConfiguration.Builder(state)
                .setPreselectedCountry(KevinCountry.LITHUANIA)
                .build()
            val intent = Intent(currentActivity, AccountSessionActivity::class.java)
            intent.putExtra(AccountSessionContract.CONFIGURATION_KEY, accountLinkingConfiguration)
            currentActivity?.startActivityForResult(intent, REQUEST_CODE_ACCOUNT_LINKING, null)
            this.callback = callback
        } catch (error: Exception) {
            callback("Failed", null)
        }
    }
    
    companion object {
        const val REQUEST_CODE_ACCOUNT_LINKING = 100
    }
}
iOS
KevinModule.swift
@objc(KevinModule)
class KevinModule: NSObject {
  
  private var callback: RCTResponseSenderBlock?
    
  //...
  
  @objc(openKevinAccountLinking::)
  func openKevinAccountLinking(state: String, callback: @escaping RCTResponseSenderBlock) -> Void {
    do {
      KevinAccountLinkingSession.shared.delegate = self
      try KevinAccountLinkingSession.shared.initiateAccountLinking(
        configuration: KevinAccountLinkingSessionConfiguration.Builder(
          state: state
        )
          .setPreselectedCountry(.lithuania)
          .setCountryFilter([.lithuania, .latvia, .estonia])
          .setSkipBankSelection(false)
          .build()
      )
      
      self.callback = callback
    } catch {
      callback(["Failed", nil])
    }
  }
}
Additionally add this function declaration to your native module bridge:
KevinModuleBridge.m
@interface RCT_EXTERN_MODULE(KevinModule, NSObject)
​
//...
​
RCT_EXTERN_METHOD(openKevinAccountLinking:(NSString):(RCTResponseSenderBlock))
​
@end
For additional information on available SDK configuration parameters, please refer to the corresponding platform-specific section of our documentation.
Handle SDK callbacks
To get results from kevin. SDK account linking flow you need to override platform-specific callbacks.
Android
Android handler module should conform to ActivityEventListener and should override onActivityResult(activity: Activity?, requestCode: Int, resultCode: Int, data: Intent?)
KevinModule.kt
class KevinModule internal constructor(context: ReactApplicationContext?) :
    ReactContextBaseJavaModule(context), ActivityEventListener {
​
    //...
​
    override fun onActivityResult(
        activity: Activity?,
        requestCode: Int,
        resultCode: Int,
        data: Intent?
    ) {
        if (requestCode == REQUEST_CODE_ACCOUNT_LINKING) {
            val result = data?.getParcelableExtra<SessionResult<AccountSessionResult>>(AccountSessionContract.RESULT_KEY)
            when (result) {
                is SessionResult.Success -> {
                    callback?.invoke(null, result.value.authorizationCode)
                }
                is SessionResult.Canceled -> {
                    callback?.invoke("Canceled", null)
                }
                is SessionResult.Failure -> {
                    callback?.invoke("Failed", null)
                }
            }
        }
    }
}
iOS
iOS handler module should conform to KevinAccountLinkingSessionDelegate and override those methods:
KevinModule.swift
@objc(KevinModule)
class KevinModule: NSObject, KevinAccountLinkingSessionDelegate {
​
    //...
​
    func onKevinAccountLinkingStarted(controller: UINavigationController) {
        let rootViewController = UIApplication.shared.windows.first!.rootViewController
        rootViewController?.present(controller, animated: true, completion: nil)
    }
    
    func onKevinAccountLinkingCanceled(error: Error?) {
        callback?(["Failed", nil])
    }
    
    func onKevinAccountLinkingSucceeded(authorizationCode: String, bank: ApiBank) {
        callback?([nil, authorizationCode])
    }
}
Invoking account linking flow from React Native code
App.js
const { 
  KevinModule 
} = NativeModules;
​
onKevinAccountLinkingCallback = (error, authCode) => {
  if (error) {
    console.error(`Error found! ${error}`);
  } else {
    console.log(`Authorization code ${authCode} returned`);
  }
}
​
const App: () => Node = () => {
  return (
    <SafeAreaView>
      <Button
        onPress={ () => KevinModule.openKevinAccountLinking("STATE", onKevinAccountLinkingCallback) }
        title="Account linking"
      />
    </SafeAreaView>
  );
};
Installation
Payment Initiation
Last modified 3mo ago