iOS Project Configuration


System Requirements

  • Min supported OS version: iOS 17.6

Install SDK via SPM

  1. Install SDK via SPM Go to your Project -> Package Dependencies

  2. Click on + and find https://github.com/payabl-plugins/payablMerchant-iOS

  3. Select latest major version

  1. We distribute 2 SDKs PayablMerchantLive and PayablMerchantSandbox, use sandbox for testing purposes but make sure to use PayablMerchantLive before releasing to Appstore, notice that PayablMerchantLive SDK is not debuggable.
  1. Make sure only one product is added to your target, importing both products will result in unexpected behaviour
  2. When switching between products from sandbox to live, we recommend removing the package and adding it again while choosing the correct product if it didnt work normally by adding/removing from Frameworks, Libraries and Embedded Content

Import the SDK

import PayablMerchantSandbox

Deep Linking (Info.plist)

To handle the redirect back from the Banking App (especially for custom schemes like payabl://), you must register the URL scheme.

Add this to your Info.plist:

To handle the redirect back from the Banking App (especially for custom schemes like payabl://), you must register the URL scheme. Add this to your Info.plist:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>payabl</string>
    </array>
    <key>CFBundleURLName</key>
    <string>Payment Callback</string>
  </dict>
</array>