Tink Link iOS

Prerequisites

Follow the getting started guide to retrieve your client_id.
Add a deep link to your app with scheme and host (yourapp://host) to the list of redirect URIs under your app's settings.

Requirements

iOS 11.0
Xcode 11.4

Installation

There are two targets in the package Tink Link.

TinkLink is a framework for aggregating bank credentials, you can build your own UI, suitable for enterprise plan customers that are aggregating with permanent users.
TinkLinkUI is a framework with a predefined flow, a single entrypoint and configurable UI style, you can use this framework to bootstrap your application fast.

Using Swift Package Manager

Follow these instructions to link a target to a package product and enter this URL https://github.com/tink-ab/tink-link-ios when asked for a package repository.

When finished, you should be able to import TinkLink and import TinkLinkUI within your project.

If you only need the headless SDK you don't need to import TinkLinkUI within your project.

Using CocoaPods

Refer to their guide for usage and installation instructions.

Add TinkLink and TinkLinkUI to your Podfile.
```
pod "TinkLink"
pod "TinkLinkUI"
```
Run pod install in your project directory.
Open your .xcworkspace file to see the project in Xcode.

If you only need the headless SDK you don't need to include pod "TinkLinkUI" in your Podfile.

Using Carthage

Refer to these instructions for usage and installation details.

Add github "tink-ab/tink-link-ios" to your project's Cartfile.
Run carthage update in your project directory.
In your copy frameworks run script, add these paths to your input and output file lists respectivly.

$(SRCROOT)/Carthage/Build/iOS/TinkCore.framework
$(SRCROOT)/Carthage/Build/iOS/TinkLink.framework
$(SRCROOT)/Carthage/Build/iOS/TinkLinkUI.framework
$(SRCROOT)/Carthage/Build/iOS/Down.framework
$(SRCROOT)/Carthage/Build/iOS/Kingfisher.framework

$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/TinkCore.framework
$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/TinkLink.framework
$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/TinkLinkUI.framework
$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/Down.framework
$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/Kingfisher.framework

When finished, you should be able to import TinkLink and import TinkLinkUI within your project.

If you only need the headless SDK you don't need to include TinkLinkUI.framework, Down.framework and Kingfisher.framework.

How to display Tink Link

Import the SDK and configure Tink with your client ID and redirect URI.

import TinkLink
import TinkLinkUI

let configuration = try! Tink.Configuration(clientID: <#String#>, redirectURI: <#URL#>)
Tink.configure(with: configuration)

Define the list of scopes based on the type of data you want to fetch. For example, to retrieve accounts and transactions, define these scopes:
```
let scopes: [Scope] = [
    .accounts(.read), 
    .transactions(.read)
]
```

Create a TinkLinkViewController with the market and list of scopes to use.

let tinkLinkViewController = TinkLinkViewController(market: "SE", scopes: scopes) { result in 
    // Handle result
}

Tink Link is designed to be presented modally. Present the view controller by calling present(_:animated:) on the presenting view controller.
```
present(tinkLinkViewController, animated: true)
```
After the user has completed or cancelled the aggregation flow, the completion handler will be called with a result. A successful authentication will return a result that contains an authorization code that you can exchange for an access token. If something went wrong the result will contain an error.
```
do {
    let authorizationCode = try result.get()
    // Exchange the authorization code for a access token.
} catch {
    // Handle any errors
}
```

Redirect handling

You will need to add a custom URL scheme or support universal links to handle redirects from a third party authentication flow back into your app.

Follow the instructions in one of these links to learn how to set this up:

Examples

These examples shows how to build a complete aggregation flow using TinkLink or TinkLinkUI.

Documentation

For more detailed usage and full documentation, please refer to our Tink Link for iOS guide.

Tink Link for iOS

kasper-lahti / tink-link-ios