Built-in Parameters in myPOS Mobile Checkout iOS SDK

This guide provides an overview of the built-in parameters managed by the myPOS Mobile Checkout iOS SDK. Learn how these ready-to-use fields simplify your integration and help you deliver a secure, seamless payment experience.

Why Use Built-in Parameters?

The myPOS Mobile Checkout iOS SDK is designed to help you:

Speed up integration with ready-to-use parameters
Reduce your PCI scope easily
Keep your checkout seamless and secure
Customize the payment experience with minimal effort

Key Built-in Parameters

When you integrate the SDK, several important parameters are handled for you automatically:

Parameter	Description
`Amount`	Total amount to be charged to the customer
`Currency`	3-letter ISO currency code (e.g., EUR, USD)
`OrderID`	Your unique identifier for each transaction
`CartItems`	List of products or services included in the payment
`VerificationAmount`	Optional amount for card verification during storage
`CardToken`	Tokenized representation of the customer's stored card
`CustomerEmail`	Customer's email address (optional)
`CustomerPhone`	Customer's phone number (optional)
`AddressVerification`	Capture customer's country and ZIP for additional security
`TransactionReference`	Unique reference number assigned to each transaction

These parameters are managed internally by the SDK, reducing the coding effort on your side.

Want to Customize the UI?

You can easily adjust fonts, colors, and other visuals using a MobilePaymentTheme object.

Example: Default Theme Setup

Swift

var theme = MobilePaymentTheme()
theme.textFieldFont        = UIFont.systemFont(ofSize: 14.0)
theme.labelTextColor       = UIColor.defaultTextColor
theme.placeholderColor     = UIColor.lightGray
theme.barButtonItemColor   = UIColor.buttonEnabled
theme.textFieldTextColor   = UIColor.defaultTextColor
theme.placeholderFontSize  = 13.0
theme.textFieldBorderColor = UIColor.gray.withAlphaComponent(0.3)
theme.navigationTitleColor = UIColor.defaultTextColor
theme.placeholderAlignment = .left

Objective-C

MobilePaymentTheme *theme  = [MobilePaymentTheme new];
theme.textFieldFont        = [UIFont systemFontOfSize:14.0];
theme.labelTextColor       = [UIColor defaultTextColor];
theme.placeholderColor     = [UIColor lightGrayColor];
theme.barButtonItemColor   = [UIColor buttonEnabled];
theme.textFieldTextColor   = [UIColor defaultTextColor];
theme.placeholderFontSize  = 13.0;
theme.textFieldBorderColor = [[UIColor grayColor] colorWithAlphaComponent:.3];
theme.navigationTitleColor = [UIColor defaultTextColor];
theme.placeholderAlignment = NSTextAlignmentLeft;

Applying Your Custom Theme

After setting up your theme, apply it to the SDK:

Swift

MobilePaymentSDK.applyTheme(theme)

Objective-C

[MobilePaymentSDK applyTheme:theme];

Pro Tip:

Each method in the SDK has full Xcode-style documentation!
Hold Option (⌥) and click on any method to view detailed usage notes.