Skip to main content
Use the /fraud endpoint to create a fraud feedback request that informs the Real-Time Decisioning risk model whether an approved transaction was confirmed to be fraud. For details on how to use this endpoint, see Using the Fraud Feedback API. For general information on Real-Time Decisioning, see Real-Time Decisioning Overview.

​
Create fraud feedback

Create feedback on whether an approved transaction was confirmed to be fraud. Action: POST
Endpoint: /fraud

​
Body field details (request)

FieldsDescription
transaction_token

string

Required		Unique identifier of the transaction.

Allowable Values:

Format: UUID
is_fraud

boolean

Required		Indicates whether the transaction has been determined to be fraud.

Allowable Values:

true, false
status

string

Required		The fraud status.

Allowable Values:

CONFIRMED, DISPUTED
actor

string

Required		The party making the call.

Allowable Values:

UNKNOWN, THIRD_PARTY_FRAUD, CARD_USER_FRAUD
amount

string

Required		The amount of the transaction.

Allowable Values:

A valid transaction amount.

​
Sample request body

JSON
{
  "transaction_token": "9xf93ekp-e03a-4fe3-baeb-ppde1e9db665",
  "is_fraud": true,
  "status": "CONFIRMED",
  "actor": "UNKNOWN",
  "amount": "108.95",
}

​
Feedback response

Returns a response code and message from the feedback request. For a successful request: 201
{"message":"success"}
FieldsDescription
message

string

Returned		The message from the feedback request.

Allowable Values:

maxLength: 256

​
Response errors

Error codeDescription
400Bad request.
401Unauthorized.
403Forbidden.
500Internal server.

​
Sample response

JSON
201

{
  "message": "success."
}

Related topics

Using the Fraud Feedback APIFraud IntelligenceRelease NotesRiskControl OverviewAbout Customer Due Diligence