Install the SDK

With CocoaPods

Add the following in your Podfile:

12345678910

use_frameworks!
target 'MyApp' do
  # 👇 Add this line  pod 'PrimerSDK'
  # ...
end

Then run pod install to install PrimerSDK on your workspace.

123456789

post_install do |installer|  installer.pods_project.targets.each do |target|    if target.respond_to?(:product_type) and target.product_type == "com.apple.product-type.bundle"      target.build_configurations.each do |config|          config.build_settings['CODE_SIGNING_ALLOWED'] = 'NO'      end    end  endend

With Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into Xcode. In order to add PrimerSDK with Swift Package Manager:

1. 1
   Select your project, and then navigate to Package Dependencies
2. 2
   Click on the + button at the bottom-left of the Packages section
3. 3
   Paste https://github.com/primer-io/primer-sdk-ios.git into the Search Bar, or search for primer-sdk-ios in the Search Bar.
4. 4
   Press Add Package
5. 5
   Let Xcode download the package and set everything up

Initialize Universal Checkout

Import the PrimerSDK and set its delegate as shown in the following example:

12345678910111213141516

import PrimerSDK
class MyViewController: UIViewController, PrimerDelegate {
    override func viewDidLoad() {        super.viewDidLoad()
        // Initialize the SDK with the default settings.        Primer.shared.configure(delegate: self)    }
    func primerDidCompleteCheckoutWithData(_ data: PrimerCheckoutData) {        // Primer checkout completed with data        // do something...    }}

Show Universal Checkout

At this step you should have a client token available - see Manage Client Sessions for more.

Call the showUniversalCheckout(clientToken:) function (as shown below) to present Universal Checkout.

123456

class MyViewController: UIViewController, PrimerDelegate {
    func startUniversalCheckout() {        Primer.shared.showUniversalCheckout(clientToken: self.clientToken)    }}

When the user interacts with the checkout and clicks to pay, the Universal Checkout:

• Shows the payment method screen if applicable
• Tokenizes the payment method for payment
• Creates the payment
• Handles any other interactions (e.g. 3DS)

Handle successful payments

Listen to delegate function

Listen to the primerDidCompleteCheckoutWithData(_:) delegate function

This function will notify you of a successful payment.

123456789

class MyViewController: UIViewController {
        // ...
    func primerDidCompleteCheckoutWithData(_ data: PrimerCheckoutData) {        // Primer checkout completed with data        // Do something with the data, e.g. show the payment id    }}

Handle webhooks in your dashboard

To receive updates about the status of your payments you’ll need to listen to webhooks. This is particularly useful for updating an order or any other data stored server-side.

Head to the Developers section of the Primer Dashboard to setup and test a webhook for PAYMENT.STATUS event.

If you are not yet ready to receive webhooks, you can use https://webhook.site to test your implementation.

Handle failed payments

Any errors, cancelled payment interactions or failed payments will trigger the primerDidFailWithError(_:data:decisionHandler:) delegate function.

123456789

class MyViewController: UIViewController, PrimerDelegate {
        // ...
    func primerDidFailWithError(_ error: Error, data: PrimerCheckoutData?, decisionHandler: @escaping ((PrimerErrorDecision) -> Void)) {        // 👇 Call the decision handler to show a failure message        decisionHandler(.fail(withErrorMessage: message))    }}