STDSThreeDS2Service Class Reference

Inherits from NSObject
Declared in STDSThreeDS2Service.h

Overview

STDSThreeDS2Service is the main 3DS SDK interface and provides methods to process transactions.

  warnings

A list of warnings that may be populated once the SDK has been initialized.

@property (nonatomic, readonly, nullable) NSArray<STDSWarning*> *warnings

Discussion

A list of warnings that may be populated once the SDK has been initialized.

Declared In

STDSThreeDS2Service.h

– initializeWithConfig:locale:uiSettings:

Initializes the 3DS SDK instance.

- (void)initializeWithConfig:(STDSConfigParameters *)config locale:(nullable NSLocale *)locale uiSettings:(nullable STDSUICustomization *)uiSettings

Parameters

config

Configuration information that will be used during initialization. @see STDSConfigParameters

locale

Optional override for the locale to use in UI. If nil, will default to the current system locale.

uiSettings

Optional custom UI settings. If nil, will default to [STDSUICustomization defaultSettings] @see STDSUICustomization

Discussion

Initializes the 3DS SDK instance.

This method should be called at the start of the payment stage of a transaction. Note: Until the `STDSThreeDS2Service instance is initialized, it will be unusable.

  • Performs security checks
  • Collects device information

Exceptions

STDSInvalidInputException

Will throw an STDSInvalidInputException if config is nil or any of config, locale, or uiSettings are invalid. @see STDSInvalidInputException

STDSAlreadyInitializedException

Will throw an STDSAlreadyInitializedException if the 3DS SDK instance has already been initialized. @see STDSSDKAlreadyInitializedException

STDSRuntimeException

Will throw an STDSRuntimeException if there is an internal error in the SDK. @see STDSRuntimeException

Declared In

STDSThreeDS2Service.h

– createTransactionForDirectoryServer:withProtocolVersion:

Creates and returns an instance of STDSTransaction.

- (STDSTransaction *)createTransactionForDirectoryServer:(NSString *)directoryServerID withProtocolVersion:(nullable NSString *)protocolVersion

Parameters

directoryServerID

The Directory Server identifier returned in the authentication response

protocolVersion

3DS protocol version according to which the transaction will be created. Uses the default value of 2.1.0 if nil

Discussion

Creates and returns an instance of STDSTransaction.

Exceptions

STDSNotInitializedException

Will throw an STDSNotInitializedException if the the STDSThreeDS2Service instance hasn’t been initialized with a call to initializeWithConfig:locale:uiSettings:. @see STDSNotInitializedException

STDSInvalidInputException

Will throw an STDSInvalidInputException if directoryServerID is not recognized or if the protocolVersion is not supported by this version of the SDK. @see STDSInvalidInputException

STDSRuntimeException

Will throw an STDSRuntimeException if there is an internal error in the SDK. @see STDSRuntimeException

Declared In

STDSThreeDS2Service.h