Netaxept iOS SDK

PiA Netaxept iOS SDK is a library that provides the native in-app interactions to accept payments with Netaxept directly from native iOS apps while minimizing PCI DSS requirements for you.

Nets-mobile-acceptance
39
7
Swift

PiA - Netaxept iOS SDK v2.7.3

Getting started

PiA Netaxept iOS SDK is a library that provides the native in-app interactions to accept payments with Netaxept directly from native iOS apps while minimizing PCI DSS requirements for you.

PiA - Netaxept Mobile SDK Android can be found here.

Detailed documentation can be found here.

Sample Project

We have provided a sample project, PiaSample, in the repository which is written in Swift 4 and it demonstrates Pia usage and capabilities. To use it download the repo, run pod install to download the required libraries and open PiaSample.xcworkspace. Then, delete the libs folder with everything in it and follow one of the installation types from below to add Pia.framework, either manual installation steps or Carthage. After that, navigate to ConstantAPI.swift to add your Merchant Backend URLs and Netaxept Merchant IDs.

Project status

Supported payment methods:

  • Cards: Visa, Mastercard, American Express, Diners, JCB, Dankort, Maestro, Forbrugsforeningen, S-Business
  • Apple Pay
  • PayPal
  • Vipps
  • Swish
  • Paytrail direct bank payments
  • MobilePay

Requirements

  • PiA iOS SDK requires iOS 12 or above.
  • Card scanning functionality requires Camera Permission, the camera usage must be added to Info.plist file in the host application.
Key    :  Privacy - Camera Usage Description   
Value  :  $(PRODUCT_NAME) camera us

Installation

Swift Package Manager

You can use Swift Package Manager to integrate PiaSDK into your Xcode project.

  • In Xcode, select “File” > “Swift Packages” > “Add Package Dependency…”.
  • Enter the URL of this repository: https://github.com/Nets-mobile-acceptance/Netaxept-iOS-SDK.
  • Specify the version rule as desired (e.g., from: "2.7.3") or use main branch
  • Click “Next” and then “Finish”.

Usage:

  • Import the SDK module into your Swift file:

    import Pia

Carthage

NOTE: If this is the first time you are using Carthage, please refer to this guide for correct installation.

If you do not have Carthage yet, refer to this link for complete instruction from Carthage.

  • Make the following entry in your Cartfile:
github "Nets-mobile-acceptance/Netaxept-iOS-SDK"
  • Run carthage update.
  • Go inside your project’s folder in Carthage/Checkouts/Netaxept-iOS-SDK and unzip PiaSDKFramework.zip.
  • Go to your project’s target General tab and drag the Pia.framework into the Linked Frameworks and Libraries section.
  • Add Pia.framework to Embedded Binaries from the General tab.

Manually

  • Download/clone this https://github.com/Nets-mobile-acceptance/Netaxept-iOS-SDK.git
  • Unzip PiaSDKFramework.zip to obtain Pia.framework.
  • Drag and drop Pia.framework to your project.
  • Go to your project target at Build Phases.
  • Add Pia.framework to Link Binary With Libraries.
  • Add Pia.framework to Embedded Binaries from the General tab.

Xcode 11+ users can now replace Pia.framework in Xcode-Targets Frameworks, Libraries and Embedded Contents with Pia.XCFramework for iOS and iOS Simulator architectures.

NOTE

Because of enabling Bitcode, the framework size exceeds the 100MB limit of GitHub uploading policy.

One option is to use Carthage for automated installation.

Alternatively, if you wish to install the SDK manually, please refer to the following walk-around for uploading to GitHub:

  1. Add “Pia.framework” to your .gitignore list
  2. Use GitHub large file system to continue uploading framework within your working project

Frequently Asked Questions

If you encounter any blockers when integrating the Netaxept - iOS SDK, feel free to check the Frequently Asked Questions page. If any of these answers does not fit your question, don’t hesitate to contact us.

Usage

After setup is ready, using PiA SDK is easy. For full references, please check our detailed documentation.

Integration - Run Script

To assist integration of Pia.framework in your project, navigate to the project’s target (under TARGETS) in Xcode and add the following Run Script in Build Phases section. If you want to avoid the error when running on simulator, please also check the box for this. Note: Run script only when installing!

Note: Make sure the run script is added after the Embedded Framewoks phase

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 'Pia.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

Contact

If you have any question or feedback, please contact us via email: [email protected].

License

Copyright © 2019 Nets Denmark A/S

NETS DENMARK A/S, (“NETS”), FOR AND ON BEHALF OF ITSELF AND ITS SUBSIDIARIES AND AFFILIATES UNDER COMMON CONTROL, IS WILLING TO LICENSE THE SOFTWARE TO YOU ONLY UPON THE CONDITION THAT YOU ACCEPT ALL OF THE TERMS CONTAINED IN THIS BINARY CODE LICENSE AGREEMENT. BY USING THE SOFTWARE YOU ACKNOWLEDGE THAT YOU HAVE READ THE TERMS AND AGREE TO THEM. IF YOU ARE AGREEING TO THESE TERMS ON BEHALF OF A COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT THAT YOU HAVE THE LEGAL AUTHORITY TO BIND THE LEGAL ENTITY TO THESE TERMS. IF YOU DO NOT HAVE SUCH AUTHORITY, OR IF YOU DO NOT WISH TO BE BOUND BY THE TERMS, YOU MUST NOT USE THE SOFTWARE ON THIS SITE OR ANY OTHER MEDIA ON WHICH THE SOFTWARE IS CONTAINED.

Software is copyrighted. Title to Software and all associated intellectual property rights is retained by NETS and/or its licensors. Unless enforcement is prohibited by applicable law, you may not modify, decompile, or reverse engineer Software.

No right, title or interest in or to any trademark, service mark, logo or trade name of NETS or its licensors is granted under this Agreement.

Permission is hereby granted, to any person obtaining a copy of this software and associated documentation files (the Software"), to deal in the Software, including without limitation the rights to use, copy, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

Software may only be used for commercial or production purpose together with Netaxept services provided from NETS, its subsidiaries or affiliates under common control.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.