com.paypal.sdk.models

Enum OrdersCardVerificationMethod

java.lang.Object

java.lang.Enum<OrdersCardVerificationMethod>

com.paypal.sdk.models.OrdersCardVerificationMethod

All Implemented Interfaces:

Serializable, Comparable<OrdersCardVerificationMethod>

public enum OrdersCardVerificationMethod
extends Enum<OrdersCardVerificationMethod>

OrdersCardVerificationMethod to be used.

Enum Constant Summary

Enum Constants

Enum Constant and Description
_UNKNOWN Unknown values will be mapped by this enum member
AVS_CVV Places a temporary hold on the card to ensure its validity.
ENUM_3D_SECURE The contingency surfaced as an additional security layer that helps prevent unauthorized card-not-present transactions and protects the merchant from exposure to fraud.
SCA_ALWAYS Selecting this option will attempt to force a strong customer authentication for the authorization/transaction.
SCA_WHEN_REQUIRED This is the default.

Method Summary

Modifier and Type	Method and Description
static OrdersCardVerificationMethod	constructFromString(String toConvert) Returns the enum member associated with the given string value.
static OrdersCardVerificationMethod	fromString(String toConvert) Returns the enum member associated with the given string value.
String	toString() Get string representation of this enum.
static List<String>	toValue(List<OrdersCardVerificationMethod> toConvert) Convert list of OrdersCardVerificationMethod values to list of string values.
String	value() Returns the string value associated with the enum member.
static OrdersCardVerificationMethod	valueOf(String name) Returns the enum constant of this type with the specified name.
static OrdersCardVerificationMethod[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

SCA_ALWAYS

public static final OrdersCardVerificationMethod SCA_ALWAYS

Selecting this option will attempt to force a strong customer authentication for the authorization/transaction. In countries where SCA has been defined and implemented it will result in a contingency and HATEOAS link being returned. The API caller should redirect the payer to that link so that they can authenticate themselves against their issuing bank or other entity. As noted, the HATEOAS link is only available in all regions where strong authentication is supported, (e.g. in European countries where 3DS is live). Merchants can use this setting as an additional layer of security if they choose to. In all cases, when an authorization is requested the AVS/CVV results will be returned in the response.

SCA_WHEN_REQUIRED

public static final OrdersCardVerificationMethod SCA_WHEN_REQUIRED

This is the default. When an authorization or transaction is attempted this option will return a contingency and HATEOAS link only when local regulations require strong customer authentication, (e.g. 3DS in countries and use cases where it is mandated). The API caller should redirect the payer to the link so that they can authenticate themselves. In all cases, when an authorization is requested the AVS/CVV results will be returned in the response.

ENUM_3D_SECURE

public static final OrdersCardVerificationMethod ENUM_3D_SECURE

The contingency surfaced as an additional security layer that helps prevent unauthorized card-not-present transactions and protects the merchant from exposure to fraud.

AVS_CVV

public static final OrdersCardVerificationMethod AVS_CVV

Places a temporary hold on the card to ensure its validity. This process protects the merchant from exposure to fraud. This verification method will confirm that the address information or CVV included matches what the issuing bank has on file for the associated card, ensuring that only authorized card users are able to make purchases from you.

_UNKNOWN

public static final OrdersCardVerificationMethod _UNKNOWN

Unknown values will be mapped by this enum member

Method Detail

values

public static OrdersCardVerificationMethod[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (OrdersCardVerificationMethod c : OrdersCardVerificationMethod.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static OrdersCardVerificationMethod valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

constructFromString

public static OrdersCardVerificationMethod constructFromString(String toConvert)
                                                        throws IOException

Returns the enum member associated with the given string value.

Parameters:

toConvert - String value to get enum member.

Returns:

The enum member against the given string value.

Throws:

IOException - when provided value is not mapped to any enum member.

fromString

public static OrdersCardVerificationMethod fromString(String toConvert)

Returns the enum member associated with the given string value.

Parameters:

toConvert - String value to get enum member.

Returns:

The enum member against the given string value.

value

public String value()

Returns the string value associated with the enum member.

Returns:

The string value against enum member.

toString

public String toString()

Get string representation of this enum.

Overrides:

toString in class Enum<OrdersCardVerificationMethod>

toValue

public static List<String> toValue(List<OrdersCardVerificationMethod> toConvert)

Convert list of OrdersCardVerificationMethod values to list of string values.

Parameters:

toConvert - The list of OrdersCardVerificationMethod values to convert.

Returns:

List of representative string values.