Package com.broadleafcommerce.cartoperation.domain.enums

Enum Class DefaultTransactionFailureTypes

java.lang.Object
java.lang.Enum<DefaultTransactionFailureTypes>
com.broadleafcommerce.cartoperation.domain.enums.DefaultTransactionFailureTypes
All Implemented Interfaces:
TransactionFailureType, Serializable, Comparable<DefaultTransactionFailureTypes>, Constable
public enum DefaultTransactionFailureTypes extends Enum<DefaultTransactionFailureTypes> implements TransactionFailureType
The default set of transactionFailureTypes that we expect to encounter with payment gateway interactions
Author:
Chris Kittrell (ckittrell)

  • Enum Constant Details

    • GATEWAY_CREDENTIALS_ERROR

      public static final DefaultTransactionFailureTypes GATEWAY_CREDENTIALS_ERROR
      The provided payment gateway credentials are not valid

    • GATEWAY_CONFIGURATION_ERROR

      public static final DefaultTransactionFailureTypes GATEWAY_CONFIGURATION_ERROR
      The gateway is incorrectly configured or is not configured to handle the attempted type of request

    • INVALID_REQUEST

      public static final DefaultTransactionFailureTypes INVALID_REQUEST
      There was a failure to process the request because the request itself is invalid.

    • INVALID_PAYMENT_METHOD

      public static final DefaultTransactionFailureTypes INVALID_PAYMENT_METHOD
      The provided payment method data is invalid. This could be an incorrect card number, expiration date, etc.

    • PROCESSING_FAILURE

      public static final DefaultTransactionFailureTypes PROCESSING_FAILURE
      The payment gateway failed to successfully process the transaction. This primarily represents a declined payment.

    • REQUIRES_3DS_VERIFICATION

      public static final DefaultTransactionFailureTypes REQUIRES_3DS_VERIFICATION
      Additional verification is required from the customer for the gateway to successfully process the transaction

    • REQUIRES_ADDITIONAL_ACTION

      public static final DefaultTransactionFailureTypes REQUIRES_ADDITIONAL_ACTION
      Additional action is required for the transaction to be successfully processed

    • GATEWAY_ERROR

      public static final DefaultTransactionFailureTypes GATEWAY_ERROR
      There was an unexpected error with the payment gateway itself.

    • NETWORK_ERROR

      public static final DefaultTransactionFailureTypes NETWORK_ERROR
      There was an error in communicating with the payment gateway. This can correlate to a known network failure/timeout or connection issue.

    • RESPONSE_VALIDATION_FAILURE

      public static final DefaultTransactionFailureTypes RESPONSE_VALIDATION_FAILURE
      There was an error when checking the validity of the response. Therefore, we're unsure if we can trust the contents of the response. In this case, it's best to treat the transaction as a failure and investigate it offline.

    • API_RATE_LIMIT_ERROR

      public static final DefaultTransactionFailureTypes API_RATE_LIMIT_ERROR
      An error that occurs when too many requests hit the gateway's API too quickly

    • INTERNAL_ERROR

      public static final DefaultTransactionFailureTypes INTERNAL_ERROR
      There was an error in our preparation of the gateway interaction or in our interpretation/storing of the response.

    • REQUIRES_EXTERNAL_INTERACTION

      public static final DefaultTransactionFailureTypes REQUIRES_EXTERNAL_INTERACTION
      This transaction requires additional interaction from the customer from an external source. This typically requires a external redirect to provide or verify customer banking details.

    • REQUIRES_HOSTED_PAYMENT_PAGE_INTERACTION

      public static final DefaultTransactionFailureTypes REQUIRES_HOSTED_PAYMENT_PAGE_INTERACTION
      Requires interaction with the gateway's hosted payment page. Completion of that interaction will trigger the execution of the transaction.

    • CANCELED

      public static final DefaultTransactionFailureTypes CANCELED
      The transaction has been cancelled by the customer. This is typically used for 3DS/HPP interactions where the customer has decided that they no longer want to use that payment method.

    • EXPIRED

      public static final DefaultTransactionFailureTypes EXPIRED
      The transaction has expired. This typically happens when an action was required by the customer to complete the transaction, but they failed to complete the action.

  • Method Details

    • values

      public static DefaultTransactionFailureTypes[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared

    • valueOf

      public static DefaultTransactionFailureTypes valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (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 class has no constant with the specified name
      NullPointerException - if the argument is null

    • isGatewayCredentialsError

      public static boolean isGatewayCredentialsError(String failureType)

    • isGatewayConfigurationError

      public static boolean isGatewayConfigurationError(String failureType)

    • isInvalidRequest

      public static boolean isInvalidRequest(String failureType)

    • isInvalidPaymentMethod

      public static boolean isInvalidPaymentMethod(String failureType)

    • isProcessingFailure

      public static boolean isProcessingFailure(String failureType)

    • isRequires3DSVerification

      public static boolean isRequires3DSVerification(String failureType)

    • isRequiresAdditionalAction

      public static boolean isRequiresAdditionalAction(String failureType)

    • isGatewayError

      public static boolean isGatewayError(String failureType)

    • isNetworkError

      public static boolean isNetworkError(String failureType)

    • isResponseValidationFailure

      public static boolean isResponseValidationFailure(String failureType)

    • isAPIRateLimitError

      public static boolean isAPIRateLimitError(String failureType)

    • isInternalError

      public static boolean isInternalError(String failureType)

    • isRequiresExternalInteraction

      public static boolean isRequiresExternalInteraction(String failureType)

    • isRequiresHostedPaymentPageInteraction

      public static boolean isRequiresHostedPaymentPageInteraction(String failureType)

    • isCanceled

      public static boolean isCanceled(String failureType)

    • isExpired

      public static boolean isExpired(String failureType)