Requirements

iOS 14.0 and above. Xcode 15+.

Installation

Manual (.xcframework)

The SDK is distributed as a pre-built .xcframework shared via email. Repeat the step below for every framework in the delivery:

1. Open your Xcode project or workspace.
2. Drag and drop GoPayEnterpriseSDK.xcframework into the Project Navigator (preferably into an Frameworks or Embedded Content group).
3. In the prompt, ensure:
   • "Copy items if needed" is checked.
   • The framework is added to the correct target.
4. Select your target → General → Frameworks, Libraries, and Embedded Content. Confirm the framework is listed and set to Embed & Sign.

CocoaPods

If your integration uses CocoaPods you can pull the SDK directly:

pod 'GoPayEnterprise', '1.0.12'

Add the required pod sources at the top of your Podfile (credentials shared via email):

source 'https://cdn.cocoapods.org/'
source '<internal-podspec-source-url>'

Then run:

pod install

Dependencies

When using the .xcframework route, the following dependencies must be present in your project. Add them via CocoaPods or manually:

Sample Podfile snippet

pod 'Clickstream',         '~> 2.0.49'
pod 'SwiftProtobuf',       '~> 1.30.0'
pod 'GRDB.swift',          '~> 6.7.0'
pod 'Starscream',          '4.0.5'
pod 'ReachabilitySwift',   '>= 5.0.0'
pod 'SSZipArchive',        '~> 2.4.3'

Required post-install build settings

Add the following post_install block to your Podfile to ensure the dependency frameworks are built with module stability enabled:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    if ["SwiftProtobuf", "ReachabilitySwift", "GRDB.swift", "Clickstream",
        "Starscream", "SSZipArchive"].include?(target.name)
      target.build_configurations.each do |config|
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '14.0'
      end
    end
  end
end

Size

Approximately ** MB** (xcframework, arm64 + x86_64 slices).

Permissions

No permissions are required for the core container features.

KYC flows (KTP Scan, Selfie Liveness, Selfie Verification, KYC Verification) require the following entry in your app's Info.plist:

Configurations

Build Troubleshooting