/
5 minute read
August 18, 2022

Fraud Feedback

Use the /fraud_feedback 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 more 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_feedback

Body field details (request)

Fields Description

transaction

string
Required

Unique identifier of the transaction.

Allowable Values:

Format: UUID

program

string
Required

The program short code on the Marqeta platform.

Allowable Values:

255 char max

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.

created_time

datetime
Required

The date and time when the transaction was created, in UTC.

Allowable Values:

Format: yyyy-MM-ddTHH:mm:ssZ

source

string
Required

The source of the call.

Allowable Values:

API, REVIEW_MANAGER, NETWORK, HISTORICAL

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:

200 Fraud feedback is created successfully.

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

Join our developer newsletter