Developers

Integration Guide for myPOS Mobile Checkout iOS SDK

Easily accept payments in your iOS app with the myPOS Mobile Checkout SDK. This guide walks you through setup, initialization, and configuration—whether you prefer a quick start or advanced integration.

Initialization

To start using the myPOS Mobile Checkout iOS SDK, you first need to initialize it:

  1. Find your Account Number in your myPOS Dashboard.
  2. Choose your Checkout – this will accept your payments.
  3. Get your Store ID linked to the selected Checkout.
  4. Set the Currency – it must match the store’s registered currency.

Need help? Check the Store Management section for more details on these parameters.

If you're using the latest version of the myPOS iOS SDK, setup is lightning fast with a Configuration Pack.

Steps:

  1. Generate the Configuration Pack when setting up your Checkout.
  2. Copy and paste the generated key into the Initialization method.

Note: This method only works in Production mode. For testing, use the provided Test Data.

MPCheckout.initialize(in: .EUR,
                      withConfigurationKey: "eyJzaWQiOi...IjoiMyJ9")

Advanced Setup (Manual Integration)

If you prefer manual setup, follow these steps:

Step 1: Prepare Certificates

  • Convert your public certificate to DER format:
openssl x509 -outform der -in public_cert.txt -out public_cert.der
  • Save your private key into a .pem file.

Important: Include both files in your Xcode project.
Go to Build Phases → Copy Bundle Resources → Add the files

Step 2: Initialize SDK with Credentials

MobilePaymentSDK.initialize(accountNumber: "1234567890",
                            storeId: "12345",
                            currency: .eur,
                            certificate: "public_cert",
                            privateKey: "private_key")
  • In Swift, bundle and keyIndex are optional (default is the main bundle and first key index).
  • In Objective-C, you must explicitly set the bundle and keyIndex.

Additional Configuration Options

  • Supported Card Networks Customize accepted card brands. (Defaults: Visa, Visa Electron, MasterCard, Maestro, and VPay)

  • Address Verification Service (AVS) Capture the consumer’s country and postcode as an extra security layer.