iOS SDK Quickstart

Add a new source in your Podfile:

source 'https://github.com/BoltApp/podspecs.git'

Then, add a new target:

pod 'BoltCheckout'

After making these changes, your Podfile should look something like this:

source 'https://github.com/BoltApp/podspecs.git'
target 'YourShopApp' do
  //Comment out the next line if you don't want to use dynamic frameworks.
  use_frameworks!
  pod 'BoltCheckout'
end

Finally, install your Podfile again to set the SDK as a dependency in your project:

pod install

Congratulations! Bolt’s SDK is now a dependency in the project!

You must include Bolt in the view controller source file, where the merchant wants to include the checkout and Apple Pay button.

Add the following line to the top of your view controller source file:

import BoltCheckout

In the viewDidLoad function of your controller, configure the needed view controller for your checkout. This can look something like:

let boltVC = Bolt().withApplePayButton().withCheckoutButton().checkoutPanel()

This enables the Apple Pay and Bolt Checkout buttons to appear in your checkout view.

Finally, add the merchant’s instance of BoltCheckoutPanelViewController into their current view controller’s view hierarchy.

addChild(boltVC)
boltVC.didMove(toParent: self)

The boltVC (BoltCheckoutPanelViewController) controller controls a checkout panel view (BoltView) that has two buttons:

• Checkout
• Apple Pay

Merchants have to add Bolt’s checkout panel view to their view hierarchy. It can be added to any other view that can contain children.

stackView.addSubview(boltVC.view)

There are two types of environments merchants may use when initializing the SDK:

• sandbox - A staging environment
• production - A production environment

Merchants can configure the type of environment during initialization using the inline parameters .sandbox and .production, as shown below.

Sandbox:

Bolt(environment: .sandbox).withCheckoutButton.checkoutPanel()

Production:

Bolt(environment: .production).withCheckoutButton.checkoutPanel()

Constraints allow you to create views that dynamically adjust to different size classes and positions, without having to manually update frames or positions.

boltVC.view.leadingAnchor.constraint(equalTo: superview.leadingAnchor).isActive = true
boltVC.view.trailingAnchor.constraint(equalTo: superview.trailingAnchor).isActive = true
// You may either define your own view height, or use the preferred height for checkout view
let height = boltVC.preferredVerticalLayoutHeight
boltVC.view.heightAnchor.constraint(equalToConstant: height).isActive = true

The merchant app should now include the Checkout button and the Apple Pay button. These buttons are both configured to perform completely and take users through the entire checkout process.