STDSTransaction Class Reference

Inherits from NSObject
Declared in STDSTransaction.h

Overview

STDSTransaction holds parameters that the 3DS Server requires to create AReq messages and to perform the Challenge Flow.

– createAuthenticationRequestParameters

Encrypts device information collected during initialization and returns it along with SDK details.

- (STDSAuthenticationRequestParameters *)createAuthenticationRequestParameters

Return Value

Encrypted device information and details about this SDK. @see STDSAuthenticationRequestParameters

Discussion

Encrypts device information collected during initialization and returns it along with SDK details.

Exceptions

SDKRuntimeException

Thrown if an internal error is encountered.

Declared In

STDSTransaction.h

– createProgressViewControllerWithDidCancel:

Returns a UIViewController instance displaying the Directory Server logo and a spinner. Present this during the Authentication Request/Response.

- (UIViewController *)createProgressViewControllerWithDidCancel:(void ( ^ ) ( void ))didCancel

Discussion

Returns a UIViewController instance displaying the Directory Server logo and a spinner. Present this during the Authentication Request/Response.

Declared In

STDSTransaction.h

– doChallengeWithViewController:challengeParameters:challengeStatusReceiver:timeout:

Initiates the challenge process, displaying challenge UI as needed.

- (void)doChallengeWithViewController:(UIViewController *)presentingViewController challengeParameters:(STDSChallengeParameters *)challengeParameters challengeStatusReceiver:(id<STDSChallengeStatusReceiver>)challengeStatusReceiver timeout:(NSTimeInterval)timeout

Parameters

presentingViewController

The UIViewController used to present the challenge response UIViewController

challengeParameters

Details required to conduct the challenge process. @see STDSChallengeParameters

challengeStatusReceiver

A callback object to receive the status of the challenge. See @STDSChallengeStatusReceiver

timeout

An interval in seconds within which the challenge process will finish. Must be at least 5 minutes.

Discussion

Initiates the challenge process, displaying challenge UI as needed.

Exceptions

STDSInvalidInputException

Thrown if an argument is invalid (e.g. timeout less than 5 minutes). @see STDSInvalidInputException

STDSSDKRuntimeException

Thrown if an internal error is encountered, and if you call this method after calling close. @see SDKRuntimeException

Declared In

STDSTransaction.h

– sdkVersion

Returns the version of the Stripe3DS2 SDK, e.g. @“1.0”

- (NSString *)sdkVersion

Discussion

Returns the version of the Stripe3DS2 SDK, e.g. @“1.0”

Declared In

STDSTransaction.h

– close

Cleans up resources held by STDSTransaction. Call this when the transaction is completed, if doChallengeWithChallengeParameters:challengeStatusReceiver:timeout is not called.

- (void)close

Discussion

Cleans up resources held by STDSTransaction. Call this when the transaction is completed, if doChallengeWithChallengeParameters:challengeStatusReceiver:timeout is not called.

Note: Don’t use this object after calling this method. Calling doChallengeWithViewController:challengeParameters:challengeStatusReceiver:timeout after calling this method will throw an STDSSDKRuntimeException

Declared In

STDSTransaction.h