com.netcetera.threeds.sdk.api

Interface ThreeDS2Service

public interface ThreeDS2Service

Provides methods to process transactions.

Method Summary

Modifier and Type	Method and Description
void	cleanup(Context applicationContext) The cleanup method frees up resources that are used by the 3DS SDK.
Transaction	createTransaction(java.lang.String directoryServerID, java.lang.String messageVersion) Creates an instance of Transaction through which the 3DS Requestor App gets the data that is required to perform the transaction.
java.lang.String	getSDKVersion()
java.util.List<Warning>	getWarnings() Returns warnings produced by the 3DS SDK while performing security checks during initialization.
void	initialize(Context applicationContext, ConfigParameters configParameters, java.lang.String locale, UiCustomization uiCustomization) The 3DS requester App calls the initialize method at the start of the payment stage of a transaction.

Method Detail

initialize

void initialize(Context applicationContext,
                ConfigParameters configParameters,
                java.lang.String locale,
                UiCustomization uiCustomization)
         throws InvalidInputException,
                SDKAlreadyInitializedException,
                SDKRuntimeException

The 3DS requester App calls the initialize method at the start of the payment stage of a transaction.

Parameters:

applicationContext - Context

configParameters - ConfigParameters

locale - String, example value “en_US”.

uiCustomization - UiCustomization

Throws:

InvalidInputException - if invalid input is provided.

SDKAlreadyInitializedException - is SDK is already initialized.

SDKRuntimeException - if 3DS SDK encounters internal error.

getWarnings

java.util.List<Warning> getWarnings()
                             throws SDKNotInitializedException

Returns warnings produced by the 3DS SDK while performing security checks during initialization.

Returns:

List of warnings produced by the 3DS SDK during initialization.

Throws:

SDKNotInitializedException - if the 3DS SDK is not initialized.

getSDKVersion

java.lang.String getSDKVersion()
                        throws SDKNotInitializedException,
                               SDKRuntimeException

Returns:

the version of the 3DS SDK that is integrated with the 3DS Requester App.

Throws:

SDKNotInitializedException - if the 3DS SDK is not initialized.

SDKRuntimeException - if the SDK experiences internal error while running.

cleanup

void cleanup(Context applicationContext)
      throws SDKNotInitializedException

The cleanup method frees up resources that are used by the 3DS SDK. It is called only once during a single 3DS Requester App session.

Parameters:

applicationContext - Context

Throws:

SDKNotInitializedException - if SDK is not initialized.

createTransaction

Transaction createTransaction(java.lang.String directoryServerID,
                              java.lang.String messageVersion)
                       throws InvalidInputException,
                              SDKNotInitializedException,
                              SDKRuntimeException

Creates an instance of Transaction through which the 3DS Requestor App gets the data that is required to perform the transaction.

Parameters:

directoryServerID - Registered Application Provider Identifier (RID) that is unique to the Payment System.

messageVersion - Protocol version according to which the transaction shall be created.

Returns:

the instance of the Transaction interface.

Throws:

InvalidInputException - if an input parameter is invalid.

SDKNotInitializedException - if SDK is not initialized.

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