Skip to main content
POST
Respond to alert
Required scope: FRAUD_ALERTS_RESPOND

Authorizations

Authorization
string
header
required

API key as Bearer token

Headers

Reap-Version
enum<string>
required

API version (YYYY-MM-DD)

Available options:
2025-02-14
Example:

"2025-02-14"

Reap-Subproject-Id
string<uuid>

Selects the subproject the request operates on; only accepted with a parent project credential.

Idempotency-Key
string

Unique key for safely retrying this request. Up to 255 characters; we recommend a UUIDv4. The first request executes and its response is cached; subsequent requests with the same key replay the cached response (24h retention).

Required string length: 1 - 255

Path Parameters

id
string<uuid>
required

Fraud alert ID

Body

Respond to a pending detected fraud alert. Confirming blocks the card; declining does not.

Confirm a pending detected fraud alert.

response
string
required

Confirm the alert as fraud

Allowed value: "CONFIRMED"
type
enum<string>
required

Fraud classification

Available options:
CARD_LOST,
CARD_STOLEN,
ACCOUNT_NUMBER_MISUSE,
OTHER
Example:

"CARD_LOST"

Response

Fraud alert resource

id
string<uuid>
required

Unique fraud alert identifier

cardId
string<uuid>
required

ID of the card this alert is for

transactionId
string<uuid>
required

ID of the card transaction this alert is for

status
enum<string>
required

Current fraud alert status

Available options:
PENDING,
CONFIRMED,
DECLINED,
EXPIRED
Example:

"PENDING"

origin
enum<string>
required

How the alert entered the system (DETECTED via fraud monitoring, or REPORTED by the partner)

Available options:
DETECTED,
REPORTED
Example:

"DETECTED"

type
enum<string> | null
required

Fraud classification. Present only when status is CONFIRMED; null for others

Available options:
CARD_LOST,
CARD_STOLEN,
ACCOUNT_NUMBER_MISUSE,
OTHER
Example:

"CARD_LOST"

detectionReason
string | null
required

Reason supplied with a detected alert, when present

cardholderMessage
string | null
required

Cardholder-facing message from the Reap or Card Network, when present. Display only - do not branch on its contents

transactionOccurredAt
string<date-time>
required

ISO 8601 timestamp of the underlying transaction (anchors the reporting window)

detectedAt
string<date-time>
required

ISO 8601 timestamp when the alert was raised (anchors the response window)

respondedAt
string<date-time> | null
required

ISO 8601 timestamp when the alert was confirmed or declined, if resolved that way

resolvedAt
string<date-time> | null
required

ISO 8601 timestamp when the alert reached a terminal status

reportableUntil
string<date-time> | null
required

ISO 8601 deadline for a report after an unanswered detected alert expired. Null unless status is EXPIRED

respondableUntil
string<date-time>
required

ISO 8601 deadline for confirming or declining a detected alert

createdAt
string<date-time>
required

ISO 8601 timestamp of creation

updatedAt
string<date-time>
required

ISO 8601 timestamp of last update