Set up Universal Checkout

Step 1. Install the SDK

With CocoaPods

The iOS SDK is available with Cocoapods. Just add the PrimerSDK pod and run pod install .

123456

target 'MyApp' do  # Other pods...
  # Add this to your Podfile  pod 'PrimerSDK', '~> 2.0.0' # Add this lineend

Then run pod install to install PrimerSDK on your workspace.

For specific versions of the SDK, please refer to the changelog.

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
4. 4
   Press Add Package
5. 5
   Let Xcode download the package and set everything up

Step 2. Initialize the SDK

Import the Primer SDK and set its delegate as shown in the following example. You have to set paymentHandling: .manual in the PrimerSettings.

1234567891011121314151617181920212223

import PrimerSDK
class MyViewController: UIViewController {
    override func viewDidLoad() {        super.viewDidLoad()
        // Set the paymentHandling to manual.        let settings = PrimerSettings(paymentHandling: .manual)        Primer.shared.configure(settings: settings, delegate: self)    }}
extension MyViewController: PrimerDelegate {
    func primerDidTokenizePaymentMethod(_ paymentMethodTokenData: PrimerPaymentMethodTokenData, decisionHandler: @escaping (PrimerResumeDecision) -> Void) {        // Use this method to create a payment.    }
    func primerDidResumeWith(_ resumeToken: String, decisionHandler: @escaping (PrimerResumeDecision) -> Void) {        // If needed, use this method to resume the previously created payment.    }}

Step 3. Generate a client token

Make an API call to your backend to fetch a client token. Here is a simple example of how it can be done from your view controller. Once successful store your client token for future use.

12345678

extension MyViewController {
    func requestClientToken(data: [String: Any], completion: @escaping (String?, Error?) -> Void) {        Networking.createClientSession(data: data) { (clientToken, err) in            completion(clientToken, err)        }    }}

Step 4. Show Universal Checkout

At this step you should have a client token available. Call the showUniversalCheckout(clientToken:) function (as shown below) to present the Universal Checkout.

123456

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

Step 5. Handle callbacks for creating and resuming payments

Once the payment method data has been securely captured, Primer will return a uniform paymentMethodTokenData via primerDidTokenizePaymentMethod(:decisionHandler:). This can be safely passed to your server to create a payment with the Payments API.

Handle primerDidTokenizePaymentMethod(:decisionHandler:)

• When a customer submits their payment data, the payment details are tokenized and you'll receive a paymentMethodTokenData in primerDidTokenizePaymentMethod.

• Create a payment request with the payment method token data.

• If the payment is successful, call decisionHandler(.succeed()) in order to display a success screen.

• If the payment is unsuccessful, call decisionHandler(.fail(withErrorMessage: "YOUR_ERROR_MESSAGE")) to display an error / failed message.

• Payments API may return a requiredAction with a new clientToken for additional steps. In this case, call decisionHandler(.continueWithNewClientToken(clientToken)).

12345678910111213141516171819202122

// use this method to create a payment.func primerDidTokenizePaymentMethod(_ paymentMethodTokenData: PrimerPaymentMethodTokenData, decisionHandler: @escaping (PrimerResumeDecision) -> Void) {    // ...    // Call the resumeHandler to continue    // ...
    // Send the payment method token data to your server to create a payment    sendPaymentMethodToken(token: paymentMethodTokenData) { (res, err) in        if let err = err {            decisionHandler(.fail(withErrorMessage: "YOUR_ERROR_MESSAGE"))        } else if let res = res {            guard let requiredActionDic = res["requiredAction"] as? [String: Any],                  let clientToken = requiredActionDic["clientToken"] as? String            else {                decisionHandler(.succeed())                return            }
            decisionHandler(.continueWithNewClientToken(clientToken))        }    }}

Once the the above operation has finished, the SDK will return an error or a new token through its delegate. You can use this token to resume the payment, i.e. send this token to your backend.

Handle primerDidResumeWith(:decisionHandler:)

• You will receive a resumeToken via the primerDidResumeWith(:decisionHandler:) callback if applicable.

• Send a resume payment request with resumeToken

• If the payment is successful, call decisionHandler(.succeed()) in order to display a success screen.

• If the payment is unsuccessful, call decisionHandler(.fail(withErrorMessage: "YOUR_ERROR_MESSAGE")) to display an error / failed message.

• Payments API may return a requiredAction with a new clientToken for additional steps. In this case, call decisionHandler(.continueWithNewClientToken(clientToken)).

123456789

func primerDidResumeWith(_ resumeToken: String, decisionHandler: @escaping (PrimerResumeDecision) -> Void) {    sendResumeToken(resumeToken) { (res, err) in        if let err = err {            decisionHandler(.continueWithNewClientToken(clientToken))        } else if let res = res {            decisionHandler(.succeed())        }    }}