Package com.netcetera.threeds.sdk.api.transaction

Interface Transaction

public interface Transaction

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

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static enum	Transaction.BridgingMessageExtensionVersion	Represents the version of the Bridging Message Extension.

Method Summary

Modifier and Type	Method	Description
void	close()	Cleans up resources that are held by the Transaction object.
void	doChallenge(android.app.Activity currentActivity, ChallengeParameters challengeParameters, ChallengeStatusReceiver challengeStatusReceiver, int timeOut)	Initiates the challenge process.
AuthenticationRequestParameters	getAuthenticationRequestParameters()
ProgressView	getProgressView(android.app.Activity currentActivity)	Creates an instance of ProgressView.
void	useBridgingExtension(Transaction.BridgingMessageExtensionVersion bridgingMessageExtensionVersion)	Indicates if Bridging Message Extension will be used.

Method Details

getAuthenticationRequestParameters

AuthenticationRequestParameters getAuthenticationRequestParameters()
                                                            throws SDKRuntimeException

Returns:

the device and 3DS SDK information to the 3DS Requestor App.

Throws:

SDKRuntimeException - will be thrown if an internal error is encountered by the 3DS SDK.

doChallenge

void doChallenge(android.app.Activity currentActivity,
 ChallengeParameters challengeParameters,
 ChallengeStatusReceiver challengeStatusReceiver,
 int timeOut)
          throws InvalidInputException,
SDKRuntimeException

Initiates the challenge process.

IMPORTANT NOTICE:

• Must be called on the main(UI) thread!
• Must be called before Activity.onSaveInstanceState(Bundle), which is typically on a Activity's resumed state. For more info for the exact time of invocation of this lifecycle method, please visit onSaveInstanceState details

Parameters:

currentActivity - Activity instance that will perform the challenge process.

challengeParameters - ChallengeParameters ACS details (contained in the ARes) required by the 3DS SDK to conduct the challenge process during the transaction. The following details are mandatory:

• 3DS Server Transaction ID
• ACS Transaction ID
• ACS Reference Number
• ACS Signed Content

challengeStatusReceiver - ChallengeStatusReceiver that will be notified about the challenge status.

timeOut - timeout interval (in minutes) within which the challenge process must be completed. The minimum timeout interval is defined to be 5 minutes.

Throws:

InvalidInputException - will be thrown if an input parameter is invalid. A timeout interval of less than the defined minimum is also treated as invalid input.

SDKRuntimeException - if an internal error is encountered by the 3DS SDK.

useBridgingExtension

void useBridgingExtension(Transaction.BridgingMessageExtensionVersion bridgingMessageExtensionVersion)

Indicates if Bridging Message Extension will be used. Bridging Message Extension is only applicable for Message Version 2.2.0.

Parameters:

bridgingMessageExtensionVersion - Transaction.BridgingMessageExtensionVersion

getProgressView

ProgressView getProgressView(android.app.Activity currentActivity)
                      throws InvalidInputException,
SDKRuntimeException

Creates an instance of ProgressView.

IMPORTANT NOTICE:

• This method must be called on the main(UI) thread!

Parameters:

currentActivity - Activity

Returns:

an instance of Progress View (processing screen) that the 3DS Requestor App uses.

Throws:

InvalidInputException - will be thrown if an input parameter is invalid.

SDKRuntimeException - if an internal error is encountered by the 3DS SDK.

close

void close()
    throws SDKRuntimeException

Cleans up resources that are held by the Transaction object.

Throws:

SDKRuntimeException - if called while Transaction is ongoing or if Transaction failed to close.