Install Primer3DS SDK

With CocoaPods

First, modify your Podfile like so:

12345678910

source 'https://github.com/CocoaPods/Specs.git'source 'https://github.com/primer-io/primer-podspecs.git'
use_frameworks!
target 'PrimerSDK_Example' do  pod 'PrimerSDK'  pod 'Primer3DS'    // ...end

Then run pod install to install Primer3DS 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

1234567891011121314151617

target 'MyApp' do  pod 'PrimerSDK'  pod 'Primer3DS'
  # ...
  # This is what needs to be added  post_install do |installer|    installer.pods_project.targets.each do |target|      if target.name == "PrimerSDK"        target.build_configurations.each do |config|          config.build_settings['OTHER_LDFLAGS'] = '$(inherited) -framework "Primer3DS"'        end      end    end  endend

With Swift Package Manager

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-3ds-ios into the Search Bar
4. 4
   Press Add Package
5. 5
   Let Xcode download the package and set everything up

Interoperability matrix

Primer SDK internally uses Primer 3DS SDK as a compile time dependency. In order for the SDKs to work properly, the versions used internally and the one imported to your code must match.

Here is a breakdown of supported interoperable versions:

Handle Out-of-Band (OOB) redirects (Optional)

Starting from 3D Secure protocol version 2.2.0, you can enhance the user experience by implementing an automatic redirect from another (authentication) application during an OOB challenge to your application once the challenge is successfully completed. This feature allows for a seamless transition and improved user flow.

To enable this feature, ensure that you include the threeDsAppRequestorUrl parameter when configuring the PrimerThreeDsOptions object.

Please note that the threeDsAppRequestorUrl value must be an iOS Universal Link. Additionally, it is essential that your application is configured to handle the Universal Link properly in order to facilitate the redirection.

To configure the Universal Link correctly using Universal Checkout, follow these steps:

123456789

let settings = PrimerSettings(  // ...  paymentMethodOptions: PrimerPaymentMethodOptions(    threeDsOptions: PrimerThreeDsOptions(      threeDsAppRequestorUrl: "https://{UNIVERSAL_LINK}"    ),  ),  // ...)

123456789101112

import PrimerSDKimport UIKit
@UIApplicationMainclass AppDelegate: UIResponder, UIApplicationDelegate {
  // ...
  func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {    return Primer.shared.application(application, continue: userActivity, restorationHandler: restorationHandler)  }}

123456789101112

import PrimerSDKimport UIKit
@UIApplicationMainclass AppDelegate: UIResponder, UIApplicationDelegate {
  // ...
  func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {    return Primer.shared.application(app, open: url, options: options)  }}

Execute 3D Secure

Universal Checkout drop-in and headless automatically render the 3DS challenge when required by your workflow.

If your application is not installed from a trusted source (e.g. a debug version, not installed from the store, or used on an simulator), try to set PrimerDebugOptions.is3DSSanityCheckEnabled to false. Otherwise 3D Secure library initialization will fail due to security checks being performed.

1234567

let settings = PrimerSettings(  // ...  debugOptions: PrimerDebugOptions(    is3DSSanityCheckEnabled: false  )  // ...)

Troubleshooting

• If you notice a console warning "Failed to import Primer3DS" on the SDK initialization, go to Scheme settings and select Manual order.