Class FraudTransactionReportParams

  • All Implemented Interfaces:
    com.lithic.api.core.Params

    
    public final class FraudTransactionReportParams
     implements Params
                        

    Report fraud for a specific transaction token by providing details such as fraud type, fraud status, and any additional comments.

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      public final class FraudTransactionReportParams.Builder

      A builder for FraudTransactionReportParams.

      public final class FraudTransactionReportParams.FraudReportRequest
      public final class FraudTransactionReportParams.FraudStatus

      The fraud status of the transaction, string (enum) supporting the following values:

      • SUSPECTED_FRAUD: The transaction is suspected to be fraudulent, but this hasn’t been confirmed.

      • FRAUDULENT: The transaction is confirmed to be fraudulent. A transaction may immediately be moved into this state, or be graduated into this state from the SUSPECTED_FRAUD state.

      • NOT_FRAUDULENT: The transaction is (explicitly) marked as not fraudulent. A transaction may immediately be moved into this state, or be graduated into this state from the SUSPECTED_FRAUD state.

      public final class FraudTransactionReportParams.FraudType

      Specifies the type or category of fraud that the transaction is suspected or confirmed to involve, string (enum) supporting the following values:

      • FIRST_PARTY_FRAUD: First-party fraud occurs when a legitimate account or cardholder intentionally misuses financial services for personal gain. This includes actions such as disputing legitimate transactions to obtain a refund, abusing return policies, or defaulting on credit obligations without intent to repay.

      • ACCOUNT_TAKEOVER: Account takeover fraud occurs when a fraudster gains unauthorized access to an existing account, modifies account settings, and carries out fraudulent transactions.

      • CARD_COMPROMISED: Card compromised fraud occurs when a fraudster gains access to card details without taking over the account, such as through physical card theft, cloning, or online data breaches.

      • IDENTITY_THEFT: Identity theft fraud occurs when a fraudster uses stolen personal information, such as Social Security numbers or addresses, to open accounts, apply for loans, or conduct financial transactions in someone's name.

      • CARDHOLDER_MANIPULATION: This type of fraud occurs when a fraudster manipulates or coerces a legitimate cardholder into unauthorized transactions, often through social engineering tactics.

    • Field Summary

      Fields 
      Modifier and Type Field Description
    • Constructor Summary

      Constructors 
      Constructor Description
    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description
    • Constructor Detail

    • Method Detail

      • fraudStatus

         final FraudTransactionReportParams.FraudStatus fraudStatus()

        The fraud status of the transaction, string (enum) supporting the following values:

        • SUSPECTED_FRAUD: The transaction is suspected to be fraudulent, but this hasn’t been confirmed.

        • FRAUDULENT: The transaction is confirmed to be fraudulent. A transaction may immediately be moved into this state, or be graduated into this state from the SUSPECTED_FRAUD state.

        • NOT_FRAUDULENT: The transaction is (explicitly) marked as not fraudulent. A transaction may immediately be moved into this state, or be graduated into this state from the SUSPECTED_FRAUD state.

      • comment

         final Optional<String> comment()

        Optional field providing additional information or context about why the transaction is considered fraudulent.

      • fraudType

         final Optional<FraudTransactionReportParams.FraudType> fraudType()

        Specifies the type or category of fraud that the transaction is suspected or confirmed to involve, string (enum) supporting the following values:

        • FIRST_PARTY_FRAUD: First-party fraud occurs when a legitimate account or cardholder intentionally misuses financial services for personal gain. This includes actions such as disputing legitimate transactions to obtain a refund, abusing return policies, or defaulting on credit obligations without intent to repay.

        • ACCOUNT_TAKEOVER: Account takeover fraud occurs when a fraudster gains unauthorized access to an existing account, modifies account settings, and carries out fraudulent transactions.

        • CARD_COMPROMISED: Card compromised fraud occurs when a fraudster gains access to card details without taking over the account, such as through physical card theft, cloning, or online data breaches.

        • IDENTITY_THEFT: Identity theft fraud occurs when a fraudster uses stolen personal information, such as Social Security numbers or addresses, to open accounts, apply for loans, or conduct financial transactions in someone's name.

        • CARDHOLDER_MANIPULATION: This type of fraud occurs when a fraudster manipulates or coerces a legitimate cardholder into unauthorized transactions, often through social engineering tactics.

      • _headers

         Headers _headers()

        The full set of headers in the parameters, including both fixed and additional headers.

      • _queryParams

         QueryParams _queryParams()

        The full set of query params in the parameters, including both fixed and additional query params.