LogoLithic API Documentation

Fraud

fraud

Fraud

Transactions

fraud.transactions

Methods

Get A Fraud Report For A Transaction -> { fraud_status, transaction_token, comment, 3 more... }
get/v1/fraud/transactions/{transaction_token}

Retrieve a fraud report for a specific transaction identified by its unique transaction token.

path Parameters
transaction_token: string
(format: uuid)
Response fields
fraud_status: "SUSPECTED_FRAUD" | "FRAUDULENT" | "NOT_FRAUDULENT" | 1 more...

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.
  • NO_REPORTED_FRAUD: Indicates that no fraud report exists for the transaction. It is the default state for transactions that have not been analyzed or associated with any known fraudulent activity.
transaction_token: string
(format: uuid)

The universally unique identifier (UUID) associated with the transaction being reported.

comment: string
Optional

Provides additional context or details about the fraud report.

created_at: string
Optional
(format: date-time)

Timestamp representing when the fraud report was created.

fraud_type: "FIRST_PARTY_FRAUD" | "ACCOUNT_TAKEOVER" | "CARD_COMPROMISED" | 2 more...
Optional

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.
updated_at: string
Optional
(format: date-time)

Timestamp representing the last update to the fraud report.

Request example
200Example
Create Or Update A Fraud Report For A Transaction -> { fraud_status, transaction_token, comment, 3 more... }
post/v1/fraud/transactions/{transaction_token}

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