Create or update a fraud report for a transaction

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

Path Params
uuid
required

The token of the transaction that the enhanced data is associated with.

Body Params

The details of the fraud report to create or update.

string
enum
required

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.
Allowed:
string
enum

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.
Allowed:
string

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

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json