GuidesAPI ReferenceSupport
Guides
Start typing to search…

Getting Started with iOS

Devices Supported: Moby/5500 BBPOS Magtek

👍

To get a copy of our SDK, please contact our partner team at [email protected]

🚧

Minimum Supported iOS Version

PaySimpleMobileSDK version 1.5.0: iOS 12.1

PaySimpleMobileSDK version 1.8.0: iOS 14

  • Copy the PaySimpleMobileSDK.xcframework and triPOSMobileSDK.xcframework files into the root directory of your application project folder. If you are on PaySimpleMobileSDK version 1.5.0 or lower using a .framework file, copy the PaySimpleMobileSDK.framework and triPOSMobileSDK.framework files into the root directory of your application project folder.
  • In the Application General Settings import the frameworks as an Embedded Library.
  • Make sure the framework files appear in the following places for the Application Target:
📘

General Settings - Embedded Binaries General Settings - Linked Frameworks and Libraries Note: In some Xcode environments, these general settings may be represented by "Frameworks, Libraries, and Embedded Content".

Build Phases - Link Binary With Libraries Build Phases - Embed Frameworks

  • Ensure the framework search paths are correct for your project in Build Settings
  • The following step is only needed for versions of the SDK 1.5.0 and lower (using .framework): In Build Phases add a new Run Script. This script is required to strip simulator architectures from your release build for the App Store.
APP_PATH="${TARGET_BUILD_DIR}/${WRAPPER_NAME}"

# This script loops through the frameworks embedded in the application and
# removes unused architectures.
find "$APP_PATH" -name '*.framework' -type d | while read -r FRAMEWORK
do
FRAMEWORK_EXECUTABLE_NAME=$(defaults read "$FRAMEWORK/Info.plist" CFBundleExecutable)
FRAMEWORK_EXECUTABLE_PATH="$FRAMEWORK/$FRAMEWORK_EXECUTABLE_NAME"
echo "Executable is $FRAMEWORK_EXECUTABLE_PATH"

EXTRACTED_ARCHS=()

for ARCH in $ARCHS
do
echo "Extracting $ARCH from $FRAMEWORK_EXECUTABLE_NAME"
lipo -extract "$ARCH" "$FRAMEWORK_EXECUTABLE_PATH" -o "$FRAMEWORK_EXECUTABLE_PATH-$ARCH"
EXTRACTED_ARCHS+=("$FRAMEWORK_EXECUTABLE_PATH-$ARCH")
done

echo "Merging extracted architectures: ${ARCHS}"
lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create "${EXTRACTED_ARCHS[@]}"
rm "${EXTRACTED_ARCHS[@]}"

echo "Replacing original executable with thinned version"
rm "$FRAMEWORK_EXECUTABLE_PATH"
mv "$FRAMEWORK_EXECUTABLE_PATH-merged" "$FRAMEWORK_EXECUTABLE_PATH"

done
  • As of version 1.8.0 of the PaySimpleMobileSDK, there are some additional firmware files which must be included when utilizing the SDK. The following files must be added directly to the root of the application bundle in the target application: D-FIS-55L3-16.02.1.uns D-FIS-5500-15.01.0003_v2.uns P-FIS-55L3-16.02.uns P-FIS-5500-15.01_v2.uns These files are distributed to you as part of SDK distribution. Adding the firmware files to your app at the correct location is critical for firmware updates to function properly in the SDK.
  • iDyanmo Only In info.plist add the following item for "Supported external accessory protocols"
  • com.magtek.idynamo
  • In the files you wish to use the SDK, import the SDK with #import <PaySimpleMobileSDK/PaySimpleMobileSDK.h>
  • Access the SDK through the PsSDK type
@property (nonatomic, strong) PsSDK *sharedPsSDK;
..
..
[PsSDK initializeSdk:DeviceTypeHere
                   environment:EnvironmentTypeHere
                        error:&error]
                        
_sharedPsSDK = [PsSDK sharedInstance];
_sharedPsSDK.delegate = self;

Updated 7 days ago