com.oppwa.mobile.connect.threeds

Class OppThreeDSConfig

java.lang.Object

com.oppwa.mobile.connect.threeds.OppThreeDSConfig

public class OppThreeDSConfig
extends java.lang.Object

Class that contains all possible configurations to be applied at OppThreeDSService initialization phase.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	OppThreeDSConfig.Builder Class to build OppThreeDSConfig class with customized parameters.

Constructor Summary

Constructors

Constructor and Description
OppThreeDSConfig(OppThreeDSConfig.Builder builder)

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o)
java.lang.String	getAppSignature() Returns app signature for the merchant app to be verified by the SDK.
java.util.EnumSet<ChallengeUiType>	getChallengeUiTypes() Returns supported UI types for displaying challenge screens.
java.lang.String	getClientConfigParam(java.lang.String key) Returns string value of the custom parameter for the /n software Client component.
java.lang.String[]	getDeviceParameterBlacklist() Returns the list of device parameters that should NOT be collected for the device.
java.lang.String	getLocale() Returns string that represents the locale for the app's user interface (for example, "en-US").
java.lang.String[]	getMaliciousApps() Returns list of package names for the apps that should be recognized as malicious.
int	getSdkMaxTimeout() Returns maximum amount of time (in minutes) for all exchanges for the 3-D Secure authentication.
java.lang.String[]	getTrustedAppStores() Returns additional list of trusted applications, that would not cause security warnings (SW02).
UiCustomization	getUiCustomization() Returns UI configuration information that is used to specify the UI layout and theme of the challenge screens, for example, font style and font size.
int	hashCode()

Methods inherited from class java.lang.Object

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

Constructor Detail

OppThreeDSConfig

public OppThreeDSConfig(OppThreeDSConfig.Builder builder)

Method Detail

getChallengeUiTypes

public java.util.EnumSet<ChallengeUiType> getChallengeUiTypes()

Returns supported UI types for displaying challenge screens. They may vary for native way, e.g. present OTP or single select screen. By default all UI types are supported, it's strongly recommended by EMVCo.

Returns:

supported UI types for displaying challenge screens

getSdkMaxTimeout

public int getSdkMaxTimeout()

Returns maximum amount of time (in minutes) for all exchanges for the 3-D Secure authentication. Default value is 5 minutes.

Returns:

maximum amount of time for all exchanges for the 3-D Secure authentication

getClientConfigParam

public java.lang.String getClientConfigParam(java.lang.String key)

Returns string value of the custom parameter for the /n software Client component. See /n software ClientConfig guide for the keys. Sample value getClientConfigParam("AcceptAnyACSCert").

Parameters:

key - the key for the custom parameter

Returns:

string value of the custom parameter for the /n software Client component

getUiCustomization

public UiCustomization getUiCustomization()

Returns UI configuration information that is used to specify the UI layout and theme of the challenge screens, for example, font style and font size.

Returns:

UI configuration information that is used to customize challenge screens

getLocale

public java.lang.String getLocale()

Returns string that represents the locale for the app's user interface (for example, "en-US").

Returns:

string that represents the locale for the app's user interface

getDeviceParameterBlacklist

public java.lang.String[] getDeviceParameterBlacklist()

Returns the list of device parameters that should NOT be collected for the device. By default, the SDK will pull as many device parameters as it can. Refer to the "EMV® 3-D Secure SDK—Device Information" guide to see the full list of possible device parameters and appropriate constants to be used. Sample values would be ["A001", "A002"].

Returns:

the list of device parameters that should NOT be collected for the device

getAppSignature

public java.lang.String getAppSignature()

Returns app signature for the merchant app to be verified by the SDK. This value should be set by the merchant and match to the app signature, otherwise security warning (SW02) will be raised. The user should store the app signature to their server and retrieve it (and set it here). Note that this should not be hardcoded in the app for security reasons.

Returns:

app signature for the merchant app to be verified by the SDK

getTrustedAppStores

public java.lang.String[] getTrustedAppStores()

Returns additional list of trusted applications, that would not cause security warnings (SW02). A security warning (SW02) will be raised if the app is not installed from the Google app store. Add some other applications that will be recognized by security checker as trusted.

Returns:

list of package names for the trusted applications

getMaliciousApps

public java.lang.String[] getMaliciousApps()

Returns list of package names for the apps that should be recognized as malicious. If the apps are installed, a security warning (SW02) will be raised. This could be checked in OppThreeDSService.getWarnings() after service is initialized. There are some default malicious apps configured inside by default:

• de.robv.android.xposed
• de.robv.android.xposed.installer
• com.saurik.substrate

Returns:

list of package names for the apps that should be recognized as malicious

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object