Introduction

Scope

This document serves as a guide for the 3DS SDK integrator of the Netcetera iOS 3DS SDK version 2.0.0, providing details how the SDK to be configured and integrated into an iOS application or library.

Please check Release Notes page for detailed release notes about the current and previous versions of the Netcetera iOS 3DS SDK.

System Requirements

Requirement Details
Swift 4.2, 5.0, 5.1, 5.1.2 The 3DS SDK is developed in Swift development language. Because module stability is available from Swift 5.1 and above, there are two SDKs available. One build with XCode 10.3 which supports Swift 4.2 and Swift 5, and another build in Xcode 11.2 which supports Swift 4.2, 5.1 and 5.1.2
Xcode 10.3, Xcode 11.0, Xcode 11.1, Xcode 11.2.1 Xocde versions that can be used to integrate the Netcetera 3DS SDK
Objective-C The SDK can also be used in an Objective-C application or library, proper bridging is implemented.
iOS 10 Minimum iOS version that the SDK supports.

Important notification: The next 2.3.0 release will contain one SDK that will support only Xcode 11.x versions.

Deliveries

The Netcetera iOS 3DS SDK delivery includes:

  • 3DS development SDK
  • 3DS production SDK only for devices
  • License file
  • Integration Guide document for the SDK
  • Netcetera Merchant Demo app - sample requestor app
  • Guide for the demo app

Versioning and Update Policy

The Netcetera iOS 3DS SDK follows the software versioning convention. The releases have semantic versioning scheme, meaning the version name will be composed of PROTOCOL.MAJOR.MINOR.PATCH.

  • PROTOCOL - major protocol version, i.e. 2
  • MAJOR - new features
  • MINOR - improvements
  • PATCH - bug or security fix

BBecause of limitations by Apple, the minor and patch numbers are concatenated together. When ThreeDS2ServiceSDK.getSDKVersion() is called, the concatenated version will be retuned, i.e. for version 2.2.1.0, the returned string would be 2.2.10.

It is recommended that the 3DS Requestor App always use the latest available version of the SDK.

Supporting documentation

Relevant documents that are specific to the EMV 3-D Secure protocol and could be used in conjunction with this guide:

Disclaimer

Information in this document is provided as it is. All representations, statements, opinions and proposals are to the best of our present knowledge.