com.thalesgroup.gemalto.d1.d1pay

Class D1PayConfigParams

java.lang.Object

com.thalesgroup.gemalto.d1.D1Params

com.thalesgroup.gemalto.d1.d1pay.D1PayConfigParams

public class D1PayConfigParams
extends D1Params

The configuration parameters for D1 Pay initializations.

Since:

2.0.0

Nested Class Summary

Nested classes/interfaces inherited from class com.thalesgroup.gemalto.d1.D1Params

D1Params.Type

Field Summary

Fields inherited from class com.thalesgroup.gemalto.d1.D1Params

paramType

Method Summary

Modifier and Type	Method and Description
void	disableBiometricAuthentication(boolean disabled) Disable the biometric authentication.
ContactlessTransactionListener	getContactlessTransactionListener() Retrieve the default contactless transaction listener
int	getDomesticCurrencyCode() Retrieve the domestic currency code
static D1PayConfigParams	getInstance() Retrieve the instance of this D1PayConfigParams
int	getKeyValidityPeriod() Retrieve the key validity period
int	getMaxConsecutivePaymentsForLVT() Retrieve the maximum consecutive payment for LVT
int	getMaxCumulativeAmountForLVT() Retrieve the maximum cumulative amount for LVT
Notification	getNotification() Retrieve the registered notification
int	getPollingEndTime() Retrieve the polling end time settings
int	getPollingInterval() Retrieve the polling time interval for D1PayWallet.addDigitalCard(String, D1Task.Callback).
String	getReplenishAuthCancel() For VISA only.
String	getReplenishAuthDescription() For VISA only.
String	getReplenishAuthSubtitle() For VISA only.
String	getReplenishAuthTitle() For VISA only.
int	getSingleTransactionAmountLimitForLVT() Retrieve the single transaction amount limit for LVT
boolean	isBiometricEnabled() Check if biometric authentication is allowed.
boolean	isOnlinePinPriority() Check if the Online PIN is priority
boolean	isTransitExperienceAllowed() Check if the transit experience is allowed
void	setContactlessTransactionListener(ContactlessTransactionListener contactlessListener) Set the default contactless transaction listener to handle the payment transaction
void	setDomesticCurrencyCode(int currencyCode) Set the domestic currency code
void	setKeyValidityPeriod(int validityPeriod) Set the key validity period
void	setMaxConsecutivePaymentsForLVT(int maxConsecutiveLVT) Set the max consecutive payments for LVT (Low Value Transaction)
void	setMaxCumulativeAmountForLVT(int maxCumulativeLVTAmount) Set the max cumulative amount for LVT (Low Value Transaction)
void	setNotification(Notification notification) Set the notification to be shown when receiving status update from D1 Pay.
void	setOnlinePinPriority(boolean priority) For VISA only.
void	setPollingEndTimeForDigitization(int pollingEndTime) Set the polling end time which is used when there is issue on Push Notification.
void	setPollingIntervalForDigitization(int pollingInterval) Set the polling interval.
void	setReplenishAuthenticationUIStrings(String title, String subtitle, String description, String negativeButton) For VISA only.
void	setSingleTransactionAmountLimitForLVT(int singleLVTAmount) Set the single transaction amount limit for LVT (Low Value Transaction)
void	setTransitExperienceAllowed(boolean allowed) In D1 Pay "Transit experience" is the transit transaction without consumer authentication.

Methods inherited from class com.thalesgroup.gemalto.d1.D1Params

getType

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

@NonNull
public static D1PayConfigParams getInstance()

Retrieve the instance of this D1PayConfigParams

Returns:

The instance

setKeyValidityPeriod

public void setKeyValidityPeriod(int validityPeriod)

Set the key validity period

Parameters:

validityPeriod - The wait period (in seconds) between user authentication and tap to POS during a transaction. Must be from 0 to 300. Default value is 45.

setDomesticCurrencyCode

public void setDomesticCurrencyCode(int currencyCode)

Set the domestic currency code

Parameters:

currencyCode - The domestic currency code (ISO-4217 Standard) used for local transaction. Default code is 978 (EUR).

setTransitExperienceAllowed

public void setTransitExperienceAllowed(boolean allowed)

In D1 Pay "Transit experience" is the transit transaction without consumer authentication. If transit experience is allowed, the transaction at transit gateway is performed in one TAP without CDCVM.
Consumer does not need to provide any biometric or device credentials at transit gateway, consumer must turn the screen on to allow transaction.

A transaction is identified as transit transaction:

• For Mastercard, as 0€ transaction with eligible Merchant Category Code as defined in MCBP specification
• For VISA, as a 0€ transaction with ODA.

For Mastercard, the card profile must support be a FLEXIBLE_CDCVM CVM model.
For VISA, it's requiring a dedicated configuration at D1 Pay server.

Parameters:

allowed - true, Transit will not have CDCVM; false, Transit will have CDCVM

setMaxConsecutivePaymentsForLVT

public void setMaxConsecutivePaymentsForLVT(int maxConsecutiveLVT)

Set the max consecutive payments for LVT (Low Value Transaction)

Parameters:

maxConsecutiveLVT - maximum allowed consecutive low value transactions before device authentication will be asked. Maximum allowed value is 50. Default value is 0 so LVT behavior is disabled.

setSingleTransactionAmountLimitForLVT

public void setSingleTransactionAmountLimitForLVT(int singleLVTAmount)

Set the single transaction amount limit for LVT (Low Value Transaction)

Parameters:

singleLVTAmount - The threshold amount value for LVT. Even if the terminal decides it is a LVT, if the transaction amount exceeds this limit, it will be treated as a High Value Transaction (HVT) and device authentication will be asked. Default value is 0 so LVT behavior is disabled.

setMaxCumulativeAmountForLVT

public void setMaxCumulativeAmountForLVT(int maxCumulativeLVTAmount)

Set the max cumulative amount for LVT (Low Value Transaction)

Parameters:

maxCumulativeLVTAmount - If the accumulated amount of all low value consecutive transactions is more than this config, SDK will trigger device authentication. If set to 0 all transactions will require device authentication from user. Default value is 0 so LVT behavior is disabled.

setOnlinePinPriority

public void setOnlinePinPriority(boolean priority)

For VISA only.

In case of profile supporting several CVM (Online PIN, CDCVM), D1 Pay is supporting by default "CDCVM Priority" as defined in VCPCS. Using this API, the mobile banking application could select "Online PIN" priority as defined in VCPCS.

Parameters:

priority - Flag to set online pin as priority

setPollingIntervalForDigitization

public void setPollingIntervalForDigitization(int pollingInterval)

Set the polling interval.

Polling time interval for D1PayWallet.addDigitalCard(String, D1Task.Callback). Polling time is only used if there is issue on Push Notification. Default value is 15s.

Parameters:

pollingInterval - The polling interval (in seconds).

setPollingEndTimeForDigitization

public void setPollingEndTimeForDigitization(int pollingEndTime)

Set the polling end time which is used when there is issue on Push Notification.

D1 Pay digitization may take quite some time, which may be more than 1 minute but must be less than 5 minutes. Default value is 300s.

Parameters:

pollingEndTime - The polling end time (in seconds)

disableBiometricAuthentication

public void disableBiometricAuthentication(boolean disabled)

Disable the biometric authentication.

Parameters:

disabled - Flag to enable/disable the biometric authentication. Default value is false (biometric is enabled).

setNotification

public void setNotification(@NonNull
                            Notification notification)

Set the notification to be shown when receiving status update from D1 Pay.

This notification usually happens during the card digitization for D1 Pay, D1PayWallet.addDigitalCard(String, D1Task.Callback).

Parameters:

notification - The notification to be shown

See Also:

D1PayWallet.addDigitalCard(String, D1Task.Callback)

setContactlessTransactionListener

public void setContactlessTransactionListener(@NonNull
                                              ContactlessTransactionListener contactlessListener)

Set the default contactless transaction listener to handle the payment transaction

Parameters:

contactlessListener - The default listener

See Also:

ContactlessTransactionListener

setReplenishAuthenticationUIStrings

public void setReplenishAuthenticationUIStrings(@NonNull
                                                String title,
                                                @NonNull
                                                String subtitle,
                                                @NonNull
                                                String description,
                                                @NonNull
                                                String negativeButton)

For VISA only.

Set UI strings to be shown on the device authentication screen (if needed) while doing the replenishment.

Parameters:

title - The title text

subtitle - The sub-title text

description - The description text

negativeButton - The negative button text

See Also:

D1PayWallet.replenish(String, boolean, DeviceAuthenticationCallback, D1Task.Callback)

getKeyValidityPeriod

public int getKeyValidityPeriod()

Retrieve the key validity period

Returns:

The key validity period

getDomesticCurrencyCode

public int getDomesticCurrencyCode()

Retrieve the domestic currency code

Returns:

The domestic currency code

isTransitExperienceAllowed

public boolean isTransitExperienceAllowed()

Check if the transit experience is allowed

Returns:

true if transit transaction without consumer authentication is allowed, otherwise false.

getMaxConsecutivePaymentsForLVT

public int getMaxConsecutivePaymentsForLVT()

Retrieve the maximum consecutive payment for LVT

Returns:

The maximum consecutive payment for LVT

getSingleTransactionAmountLimitForLVT

public int getSingleTransactionAmountLimitForLVT()

Retrieve the single transaction amount limit for LVT

Returns:

The single transaction amount limit for LVT

getMaxCumulativeAmountForLVT

public int getMaxCumulativeAmountForLVT()

Retrieve the maximum cumulative amount for LVT

Returns:

The maximum cumulative amount for LVT

getPollingInterval

public int getPollingInterval()

Retrieve the polling time interval for D1PayWallet.addDigitalCard(String, D1Task.Callback).

Polling time is only used if there is issue on Push Notification.

Returns:

The polling interval (in seconds).

getPollingEndTime

public int getPollingEndTime()

Retrieve the polling end time settings

Returns:

The polling end time

isBiometricEnabled

public boolean isBiometricEnabled()

Check if biometric authentication is allowed.

Returns:

The biometric authentication enabled status.

isOnlinePinPriority

public boolean isOnlinePinPriority()

Check if the Online PIN is priority

Returns:

true if the Online PIN is prioritized.

getReplenishAuthTitle

@NonNull
public String getReplenishAuthTitle()

For VISA only.

Retrieve the authentication title shown while processing the replenishment

Returns:

The title

getReplenishAuthSubtitle

@NonNull
public String getReplenishAuthSubtitle()

For VISA only.

Retrieve the authentication subtitle shown while processing the replenishment

Returns:

The subtitle

getReplenishAuthDescription

@NonNull
public String getReplenishAuthDescription()

For VISA only.

Retrieve the authentication description shown while processing the replenishment

Returns:

The title

getReplenishAuthCancel

@NonNull
public String getReplenishAuthCancel()

For VISA only.

Retrieve the authentication cancel button's text shown while processing the replenishment

Returns:

The cancel text

getContactlessTransactionListener

@NonNull
public ContactlessTransactionListener getContactlessTransactionListener()

Retrieve the default contactless transaction listener

Returns:

The default contactless transaction listener

getNotification

@NonNull
public Notification getNotification()

Retrieve the registered notification

Returns:

The notification