com.adyen.threeds2.util

Class AdyenConfigParameters.Builder

java.lang.Object

com.adyen.threeds2.util.AdyenConfigParameters.Builder

Enclosing class:

AdyenConfigParameters

public static final class AdyenConfigParameters.Builder
extends java.lang.Object

This class is an helper class to build AdyenConfigParameters.

Constructor Summary

Constructors

Constructor and Description
Builder(java.lang.String directoryServerId, java.lang.String directoryServerPublicKey) A builder class for the creation of ConfigParameters required in the 3DS SDK service initialization. The 3DS SDK is initialized with ThreeDS2Service.initialize(Context, ConfigParameters, String, UiCustomization).
Builder(java.lang.String directoryServerId, java.lang.String directoryServerPublicKey, java.lang.String directoryServerRootCertificates) A builder class for the creation of ConfigParameters required in the 3DS SDK service initialization. The 3DS SDK is initialized with ThreeDS2Service.initialize(Context, ConfigParameters, String, UiCustomization).

Method Summary

Modifier and Type	Method and Description
AdyenConfigParameters.Builder	appSignature(java.lang.String appSignature) Pass the App's signature to validate the App authenticity.
ConfigParameters	build() Creates the ConfigParameters required in the 3DS SDK service initialization. The 3DS SDK is initialized with ThreeDS2Service.initialize(Context, ConfigParameters, String, UiCustomization).
AdyenConfigParameters.Builder	deviceParameterBlockList(java.util.Set<java.lang.String> deviceParameterBlockList) In case you do not wish to collect specific device parameters, you may specify these parameters here.
AdyenConfigParameters.Builder	maliciousApps(java.util.Set<java.lang.String> maliciousApps) In case the App should run in a safe environment, pass the malicious apps the App shouldn't work with other than Xposed and Cydia substrate.
AdyenConfigParameters.Builder	trustedAppStores(java.util.Set<java.lang.String> trustedAppStores) In case the App is published in other app stores than Google Play Store, pass the trusted app stores.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder(java.lang.String directoryServerId,
               java.lang.String directoryServerPublicKey)

A builder class for the creation of ConfigParameters required in the 3DS SDK service initialization.
The 3DS SDK is initialized with ThreeDS2Service.initialize(Context, ConfigParameters, String, UiCustomization).

Parameters:

directoryServerId - A String represents the directory server ID.

directoryServerPublicKey - A String represents the directory server public key.

Builder

public Builder(java.lang.String directoryServerId,
               java.lang.String directoryServerPublicKey,
               java.lang.String directoryServerRootCertificates)

A builder class for the creation of ConfigParameters required in the 3DS SDK service initialization.
The 3DS SDK is initialized with ThreeDS2Service.initialize(Context, ConfigParameters, String, UiCustomization).

Parameters:

directoryServerId - A String represents the directory server ID.

directoryServerPublicKey - A String represents the directory server public key.

directoryServerRootCertificates - A String represents the directory server root certificates.

Method Detail

appSignature

public AdyenConfigParameters.Builder appSignature(java.lang.String appSignature)

Pass the App's signature to validate the App authenticity.

The 3DS SDK validates the given App's signature with the current one, if the later is not valid, the 3DS SDK registers an SDK integrity security warning.

For security reasons don't store the App's signature in the App, instead get it from the server via secure protocol like HTTPS.

Notice: after the 3DS SDK initialization, it is possible to get the 3DS SDK registered security warning and act accordingly by calling ThreeDS2Service.getWarnings().

Parameters:

appSignature - The App's signing keystore SHA256 fingerprint.
To get the SHA256 string value (e.g. 82:0B:1E:A7:67:64:D6:68:CC:4B:A4:8E:12:89:67:7E:E9:9D:7C:A1:5B:7C:CA:FA:EE:C0:09:EC:1A:B7:55:0F).
Run 'keytool -list -v -keystore release.keystore'

Returns:

The AdyenConfigParameters.Builder.

trustedAppStores

public AdyenConfigParameters.Builder trustedAppStores(java.util.Set<java.lang.String> trustedAppStores)

In case the App is published in other app stores than Google Play Store, pass the trusted app stores.

The 3DS SDK validates the App's installation app store source, if the app was installed form an untrusted app store the 3DS SDK registers an SDK integrity security warning.

Notice: after the 3DS SDK initialization, it is possible to get the 3DS SDK registered security warning and act accordingly by calling ThreeDS2Service.getWarnings().

Parameters:

trustedAppStores - The trusted app stores package names the app is available at, defaults to Google Play Store.

Returns:

The AdyenConfigParameters.Builder.

maliciousApps

public AdyenConfigParameters.Builder maliciousApps(java.util.Set<java.lang.String> maliciousApps)

In case the App should run in a safe environment, pass the malicious apps the App shouldn't work with other than Xposed and Cydia substrate.

The 3DS SDK validates malicious apps are not installed on the device, if one of the malicious apps is installed, the 3DS SDK registers an SDK integrity security warning.

Notice: after the 3DS SDK initialization, it is possible to get the 3DS SDK registered security warning and act accordingly by calling ThreeDS2Service.getWarnings().

Parameters:

maliciousApps - The malicious apps package names the SDK should validate are not installed on the device.

Returns:

The AdyenConfigParameters.Builder.

deviceParameterBlockList

public AdyenConfigParameters.Builder deviceParameterBlockList(java.util.Set<java.lang.String> deviceParameterBlockList)

In case you do not wish to collect specific device parameters, you may specify these parameters here.

Parameters:

deviceParameterBlockList - The parameters that should not be collected.

Returns:

The AdyenConfigParameters.Builder.

build

public ConfigParameters build()
                       throws InvalidInputException

Creates the ConfigParameters required in the 3DS SDK service initialization.
The 3DS SDK is initialized with ThreeDS2Service.initialize(Context, ConfigParameters, String, UiCustomization).

Returns:

The ConfigParameters required in the 3DS SDK service initialization.

Throws:

InvalidInputException - This exception shall be thrown if an input parameter is invalid.
In case the directoryServerId or directoryServerPublicKey are empty or null.