Sign in

v1

latestOpenAPI 3.0.32026-07-26208618579.9 KB
Update Fraud Case

Finalize case

Finalizes the fraud case identified by {id}. This action is allowed only if every transaction in the case has customerDecision = RISK or NO_RISK.

Once finalized:

  • All transactions become immutable.
  • Case status is set to CLOSED.
  • An optional comment can be stored on the case
  • resolutionStatus is derived for the case:
    • NO_RISK if all transactions are NO_RISK
    • RISK if at least one transaction is RISK
post/v1/{id}/finalize

Path parameters

idstring uuid required

The unique identifier of the fraud case

Query parameters

auditUserstring required

The audit user to log the request

Request body

commentstring nullable

Optional plain text comment on case (set via PATCH or finalize).

Response

Case finalized successfully — returns updated case

idstring uuid required

Unique identifier of the fraud case

status'OPEN' | 'PENDING' | 'CLOSED' required

Current status of the fraud case

cardIdstring biginteger required

Unique identifier of the card on the fraud case

createdTimestring date-time required

Time when the fraud case was created

lastUpdatedTimestring date-time required

Time when the fraud case was last updated

commentstring nullable

Optional plain text comment on case (set via PATCH or finalize).

resolutionStatus'RISK' | 'NO_RISK'

Final case resolution derived when the case is CLOSED:

  • NO_RISK if all transactions are NO_RISK
  • RISK if at least one transaction is RISK Omitted for OPEN or PENDING cases.

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "OPEN",
  "cardId": "54321",
  "createdTime": "2025-07-01T10:00:00Z",
  "lastUpdatedTime": "2025-07-02T14:30:00Z",
  "transactions": [
    {
      "transactionId": "12345",
      "customerDecision": "PENDING",
      "customerComment": "Looks good to me",
      "lastUpdatedTime": "2025-07-02T15:00:00Z",
      "reason": {
        "type": "RISK"
      }
    }
  ]
}