Skip to content

Revoke card

This method revokes a specified card. A revoked card is immediately stopped from authorizing any transaction and cannot be activated again. A revoked card can only be replaced if it is not already scheduled for replacement. After end of card validity, card is automatically revoked by internal job.

URL test:

https://test.lightcms.io/cms/v1/cards/{id}/revoke

Method:

POST

Path items:

/cards (Card Service)

/{id} (ID code of revoked card)

/revoke (Method name)

Parameters:

Parameter Location Type Example Description Required
ID Path string "108564234" Internal ID of Card Yes
x-idempotency-key header "string" 1 Idempotency key to guarantee safe retries of the activation. No
x-tenant header "string" 1 Tenant identifier (used in multi‑tenant deployments). No

Example:

curl -X 'POST' \
  'https://test.lightcms.io/cms/v1/cards/30/revoke' \
  -H 'accept: */*' \
  -H 'x-idempotency-key: 1' \
  -H 'x-tenant: 1' \
  -d ''

Responses:

200 - OK

Status Code: 200 OK

404 - Not found

Status Code: 404 Not found

    {
    "errorMessage": "Entity with id 132132123 not found in DB."
    }
Parameter Location Type Example Description
errorMessage body string "Entity with id 132132123 not found in DB." Error message