Cancel Card

Permanently cancels a card. This action is irreversible. A reason must be provided.

Common reasons: lost, stolen, fraud, customer_request, account_closure

Cancellation fees may apply depending on the product configuration. Any remaining balance should be handled separately.

📋 Request Body Fields

⚠️ Required Fields

Field	Type	Description	Constraints
`reason`	`string`	Reason for cancellation (max 500 chars). E.g., `lost`, `stolen`, `customer_request`. Example: `Customer reported card as lost.`	Max length: 500

📤 Response Fields

Field	Type	Description	Notes
`card_id`	`string (uuid)`	-	-
`customer_id`	`string (uuid)`	-	-
`product_id`	`string`	-	nullable
`card_type`	`string`	-	nullable
`action`	`string`	The operation performed: `activate`, `freeze`, `unfreeze`, `cancel`, `replace`, `set_pin`. Example: `activate`	-
`status`	`string`	New card status after the operation. Example: `active`	-
`message`	`string`	-	nullable
`task_id`	`string`	Async task ID for operations processed in the background.	nullable
`performed_at`	`string (date-time)`	-	-

curl --location -g --request POST '{{baseUrl}}/api/v1/cards/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11/cancel' \ --header 'X-API-Key;' \ --header 'X-Signature;' \ --header 'X-Timestamp;' \ --header 'X-Nonce;' \ --header 'X-Body-Hash;' \ --header 'Content-Type: application/json' \ --data-raw '{ "reason": "Customer reported card as lost." }'

📋 Request Body Fields#

📤 Response Fields#

Request

Responses

📋 Request Body Fields

📤 Response Fields