com.oppwa.mobile.connect.threeds

Class OppThreeDSTransaction

java.lang.Object

com.oppwa.mobile.connect.threeds.OppThreeDSTransaction

public class OppThreeDSTransaction
extends java.lang.Object

Class that contains information required for performing concrete 3-D Secure transaction for both frictionless and challenge flow.

Use OppThreeDSService.createTransaction(String, String) to create a new transaction instance.

Method Summary

Modifier and Type	Method and Description
void	close() Cleans up resources that are held by the transaction object.
void	doChallenge(android.app.Activity activity, java.lang.String authResponse, ChallengeCallback callback) Validates authResponse and launches the challenge screens.
java.lang.String	getAuthRequestParams() Constructs authentication request parameters string to be sent to the Platform.
android.app.ProgressDialog	getProgressView(android.app.Activity activity) Returns the processing screen which displays the Directory Server logo, and a graphical element to indicate that an activity is being processed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getAuthRequestParams

public java.lang.String getAuthRequestParams()
                                      throws SDKRuntimeException

Constructs authentication request parameters string to be sent to the Platform.

Returns:

String with authentication request parameters to be sent to the Platform.

Throws:

SDKRuntimeException - if some internal error occurred

doChallenge

public void doChallenge(android.app.Activity activity,
                        java.lang.String authResponse,
                        ChallengeCallback callback)
                 throws InvalidInputException,
                        SDKRuntimeException

Validates authResponse and launches the challenge screens. Make sure you call method on UI thread.

Wait for challenge completion events in the listener object.

Parameters:

activity - the activity to start challenge activity on top of it

authResponse - the json string with authentication response as received from the Platform

callback - the object to receive challenge result events

Throws:

InvalidInputException - if invalid auth response is provided

SDKRuntimeException - if some internal error occurred

getProgressView

public android.app.ProgressDialog getProgressView(android.app.Activity activity)
                                           throws InvalidInputException,
                                                  SDKRuntimeException

Returns the processing screen which displays the Directory Server logo, and a graphical element to indicate that an activity is being processed.

Parameters:

activity - the activity to show progress view on top of it

Returns:

ProgressDialog object to be shown while transaction is processing

Throws:

InvalidInputException - if activity is not valid

SDKRuntimeException - if some internal error occurred

close

public void close()

Cleans up resources that are held by the transaction object.

Note: This method is required to be called only when the doChallenge method is not called in the transaction. E.g. you want to cancel transaction instead of requesting challenge authentication.