Update card status

POST 
/cards/:cardId/status

Use this endpoint to change the status of the card. This is typically used to apply a temporary block (e.g. in the event of a lost card).

This endpoint:

• Changes card status (active, blocked, etc.)
• Maintains card history
• Triggers necessary notifications
• Updates related systems

Request

Path Parameters

cardId stringrequired

The ID of the card to update

application/json

Body

required

Card status update data

status stringrequired

Possible values: [ACTIVE, BLOCKED]

The new status to set for the card (only ACTIVE or BLOCKED allowed)

Responses

201

The card status was successfully updated.

application/json

Schema

Schema

traceId string
message string

data

object

id stringrequired

The ID of the card

referenceNumber stringrequired

The system card reference number

status stringrequired

Possible values: [ACTIVE, BLOCKED, SUSPENDED, CANCELLED]

The status of the card

success booleanrequired

Whether the operation was successful

Example (from schema)

{
  "traceId": "string",
  "message": "string",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "referenceNumber": "CARD-REF-12345",
    "status": "BLOCKED",
    "success": true
  }
}

400

Invalid request payload. This can happen if required fields are missing or have invalid formats.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

403

The API key is invalid or the client does not have sufficient permissions.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

404

One of the specified resources was not found. Does not apply for empty result set.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

Loading...