Introduction
Scope
This document serves as a guide for the 3DS SDK integrator of the Netcetera iOS 3DS SDK, providing details how should the SDK be configured and integrated into an iOS application or library.
Please check the release notes pages for detailed release notes about the current and previous versions of the Netcetera iOS 3DS SDK.
System Requirements
| Requirement | Details |
|---|---|
| Swift 4.2, 5 | The 3DS SDK is developed in Swift development language. These are the supported Swift versions by the Netcetera iOS 3DS SDK. |
| Xcode 13 and above | Xcode versions that can be used to integrate the Netcetera iOS 3DS SDK. |
| Objective-C | The SDK can also be used in an Objective-C application or library, proper bridging is implemented. |
| iOS 11 | Minimum iOS version that the SDK supports. |
Deliveries
The Netcetera iOS 3DS SDK delivery includes:
ThreeDS_SDK.zip- Dynamic iOS 3DS SDK XCFrameworkThreeDS_SDK_Static.zip- Static iOS 3DS SDK XCFramework (only available for manual integration)- API key
- Integration Guide documentation for the SDK
NetceteraDemoMerchant.zip- 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. 2MAJOR- new featuresMINOR- improvementsPATCH- bug or security fix
Because of limitations imposed by Apple, the minor and patch numbers are concatenated together. When ThreeDS2ServiceSDK.getSDKVersion() is called, the concatenated version will be returned, 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 uses the latest available version of the SDK.
EMVCo 3DS Protocol Versions
The Netcetera iOS 3DS SDK supports the 2.1.0, 2.2.0 & 2.3.1.1 3DS protocol versions.
Latest Supported EMVCo Specification Bulletins
| Protocol version | EMVCo 3DS Protocol Specification | EMVCo 3DS SDK Protocol Specification | Device Data Specification |
|---|---|---|---|
| 2.1.0 | EMVco 3DS SB204v6 (February 2020) | EMVCo 3DS SDK SB205v1 (August 2018) | EMVCo 3DS SDK Device Info 1.4 (October 2019) |
| 2.2.0 | EMVCo 3DS SB214v2 (February 2020) | EMVCo 3DS SDK SB211 (December 2018) | EMVCo 3DS SDK Device Info 1.4 (October 2019) |
| 2.3.1.1 | EMV 3-D Secure - Protocol and Core Functions Specification (May 2023) | EMV 3-D Secure SDK Specification (May 2023) | EMVCo 3DS SDK Device Information 1.6 (May 2023) |
A link to EMVCo's Specifications & Associated Bulletins page can be found on our Useful Links page.
Supporting documentation
Relevant documents that are specific to the EMV 3-D Secure protocol and could be used in conjunction with this guide:
- EMV 3-D Secure - Protocol and Core Functions Specification
- EMV 3-D Secure SDK Specification
- EMV 3-D Secure SDK - Device Information
Disclaimer
Information in this document is provided as it is. All representations, statements, opinions and proposals are to the best of our present knowledge.