Report
Create or update a fraud report for a transaction
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.
Path Parameters
transaction_tokenstring
formatuuid
Body Parameters
fraud_statusenum
Accepts one of the following: "SUSPECTED_FRAUD", "FRAUDULENT", "NOT_FRAUDULENT"
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 theSUSPECTED_FRAUDstate.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 theSUSPECTED_FRAUDstate.
commentstring
optional
Optional field providing additional information or context about why the transaction is considered fraudulent.
fraud_typeenum
optional
Accepts one of the following: "FIRST_PARTY_FRAUD", "ACCOUNT_TAKEOVER", "CARD_COMPROMISED", 2 more
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.
Returns
fraud_statusenum
Accepts one of the following: "SUSPECTED_FRAUD", "FRAUDULENT", "NOT_FRAUDULENT", "NO_REPORTED_FRAUD"
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 theSUSPECTED_FRAUDstate.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 theSUSPECTED_FRAUDstate.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_tokenstring
The universally unique identifier (UUID) associated with the transaction being reported.
formatuuid
commentstring
optional
Provides additional context or details about the fraud report.
created_atstring
optional
Timestamp representing when the fraud report was created.
formatdate-time
fraud_typeenum
optional
Accepts one of the following: "FIRST_PARTY_FRAUD", "ACCOUNT_TAKEOVER", "CARD_COMPROMISED", 2 more
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_atstring
optional
Timestamp representing the last update to the fraud report.
formatdate-time
Request example Request
curl https://api.lithic.com/v1/fraud/transactions/$TRANSACTION_TOKEN \
-H 'Content-Type: application/json' \
-H "Authorization: $LITHIC_API_KEY" \
-d '{
"fraud_status": "SUSPECTED_FRAUD"
}'200 Example
{
"fraud_status": "SUSPECTED_FRAUD",
"transaction_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"comment": "comment",
"created_at": "2019-12-27T18:11:19.117Z",
"fraud_type": "FIRST_PARTY_FRAUD",
"updated_at": "2019-12-27T18:11:19.117Z"
}