/
5 minute read
June 1, 2023

Fraud Feedback

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.

Create fraud feedback

Create feedback on whether an approved transaction was confirmed to be fraud.

Action: POST
Endpoint: /fraud

Body field details (request)

Fields Description

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
Copied

Is this helpful?

Yes
No

Feedback response

Returns a response code and message from the feedback request. For a successful request:

201
{"message":"success"}

Fields Description

message

string
Returned

The message from the feedback request.

Allowable Values:

maxLength: 256

Response errors

Error code Description

400

Bad request.

401

Unauthorized.

403

Forbidden.

500

Internal server.

Sample response

JSON
Copied

Is this helpful?

Yes
No

Subscribe to our developer newsletter