GoPayEnterprise SDK — Client Integration Guide

This guide provides step-by-step instructions for integrating the GoPayEnterprise SDK into your iOS application.

Distribution Package

The SDK is distributed as two files. Both must be placed in the same directory in your project:

YourProject/
├── GoPayEnterprise-release.podspec
└── GoPayEnterprise_{VERSION}.tar.gz

The tar.gz expands to:

Frameworks/
├── GoPayEnterprise.xcframework        (dynamic)
├── DigitalIdentity.xcframework        (static)
└── Ojo.xcframework                    (dynamic)
Resources/
└── DigitalIdentityResources.bundle

CocoaPods extracts and links these automatically — you do not need to unzip manually.

Requirements

Installation

1. Place SDK files

Copy both GoPayEnterprise-release.podspec and GoPayEnterprise_{VERSION}.tar.gz into your project directory (alongside your Podfile), where {VERSION} is the version number provided with the SDK distribution.

2. Configure Podfile

platform :ios, '14.0'

source 'https://cdn.cocoapods.org/'

target 'YourApp' do
  use_frameworks!

  pod 'GoPayEnterprise', :podspec => './GoPayEnterprise-release.podspec'
end

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

The post_install hook is required. It sets BUILD_LIBRARY_FOR_DISTRIBUTION on the specific transitive dependencies that need it. Without it, you may see compiler or linker errors when building.

3. Install

pod install

4. Open workspace

open YourApp.xcworkspace

CocoaPods will automatically:

• Extract and link all XCFrameworks
• Copy all resource bundles into your app
• Resolve and install all declared dependencies

CocoaPods Dependencies

The podspec declares all required dependencies. CocoaPods resolves them automatically.

Required Permissions

Add these entries to your Info.plist:

<key>NSCameraUsageDescription</key>
<string>Camera access is required for identity verification</string>

Update LSApplicationQueriesSchemes in Info.plist

• LSApplicationQueriesSchemes: For security purposes, add the following JB app-related schemes to the LSApplicationQueriesSchemes key:
  • zbra
  • cydia
  • undecimus
  • sileo
  • filza