Cancel Card

POST

/api/v1/cardoperations/{cardId}/cancel

Cancels (permanently terminates) a card. This is irreversible — a cancelled card cannot be reactivated, unfrozen, or topped up again. Use freeze instead for a temporary block.

⚠️ Required Fields

Field	Type	Description	Constraints
`reason`	`string`	Why the card is being cancelled	Min: 2 · Max: 500

📤 Response Fields

Field	Type	Description
`id`	`string (uuid)`	Card identifier
`status`	`string`	New card status, `cancelled`
`reason`	`string`	The supplied cancellation reason
`cancelledAt`	`string (date-time)`	Timestamp the card was cancelled

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Card cancelled.

Bodyapplication/json

🟠401

🟠404

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/cardoperations/6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f/cancel' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data '{
    "reason": "Card reported lost by customer."
}'

Response Example

200 - Success

{
    "id": "6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f",
    "status": "cancelled",
    "reason": "Card reported lost by customer.",
    "cancelledAt": "2026-01-15T11:10:00Z"
}

Modified at 2026-08-10 12:35:25

Replace Card

Get Card Limits