1.x to 2.x Migration Guide

// Setup using shared configuration,
PLKPlaidLink.setup { (success, error) in /* … */ }
// using shared configuration and item-add token
PLKPlaidLink.setupWithSharedConfiguration(usingItemAddToken:itemAddToken) { (success, error) in /* … */ }
// using custom configuration,
PLKPlaidLink.setup(with: linkConfiguration) { (success, error) in /* … */ }
// using custom configuration and item-add token,
PLKPlaidLink.setupWithConfiguration(with: linkConfiguration, itemAddToken: itemAddToken)
    { (success, error) in /* … */ }
// using public-token and shared configuration
PLKPlaidLink.setup(withPublicToken:publicToken) { (success, error) in /* … */ }
// using public-token and custom configuration
PLKPlaidLink.setup(withPublicToken:publicToken, configuration:linkConfiguration) { (success, error) in /* … */ }
// using public-token, item-add token, and shared configuration
PLKPlaidLink.setup(withPublicToken:publicToken, itemAddToken:itemAddToken) { (success, error) in /* … */ }
// using public-token, item-add token, and custom configuration
PLKPlaidLink.setup(withPublicToken:publicToken, itemAddToken:itemAddToken, configuration:linkConfiguration)
    { (success, error) in /* … */ }
// using public-token, link-token, and shared configuration
PLKPlaidLink.setup(withPublicToken:publicToken, linkToken:linkToken) { (success, error) in /* … */ }
// using public-token, link-token, and custom configuration
PLKPlaidLink.setup(withPublicToken:publicToken, linkToken:linkToken, configuration:linkConfiguration)
    { (success, error) in /* … */ }

// For recommended Link Token based configuration use:
let linkTokenConfiguration = LinkTokenConfiguration(token: linkToken)
    { success in /* … */ }
// To continue using public key based configuration for the interim use:
let linkPublicKeyConfiguration = LinkPublicKeyConfiguration(
            clientName: "Link Demo",
            environment: .sandbox,
            products: [.transactions, .auth],
            language: "en"
            token: .publicKey("<#YOUR_PUBLIC_KEY#>"),
            countryCodes: ["US"]) { (success) in /* … */ }

switch Plaid.create(linkTokenConfiguration) {
  case .failure(let error):
    print("Unable to create Plaid Handler due to: \(error)")
  case .success(let handler)
    // Store the handler for later use and call open on it when Link should start
    self.handler = handler
}

present(linkViewController, animated: true)

// Let the handler present Link using one of the application's view controllers.
handler.open(presentUsing: .viewController(self))
// or present Link yourself in a custom manner using a closure.
handler.open(presentUsing: .custom({ (linkViewController) in /* … */ }))

let onSuccessHandler: OnSuccessHandler = { (success) in
  // Send success.publicToken to your server and exchange it for an access token
  // Process any metadata according to your needs, e.g. metadata.institution.name
}
// Pass onSuccessHandler to the onSuccess parameter of the LinkTokenConfiguration or LinkPublicKeyConfiguration initializer

let onExitHandler: OnExitHandler = { (exit) in
    if let error = exit.error {
        // Handle errors according to your app.
        switch error.errorCode {
        case .rateLimitExceeded(let code):
            print("Encountered rate limit \(code)")
        default:
            print("Unhandled error \(error.errorCode)")
        }
    }
    // Process any metadata depending on your needs, e.g. exit.metadata.institution.name
}
linkConfiguration.onExit = onExitHandler

let onEventHandler: OnEventHandler = { (event) in
    // Handle events and metadata according to your app.
    let metadata = event.metadata
    switch event.eventName {
    case .selectInstitution:
        // Process any metadata according to your needs, e.g. metadata.institutionName
        print("Selected institution \(metadata.institutionName ?? "") (\(metadata.institutionID ?? "")")
    default:
        print("Ignored event \(event)")
    }
}
linkConfiguration.onEvent = onEventHandler