CHcheckout
Cards

Revoke a card

Revokes an inactive, active, or suspended card to permanently decline all incoming authorizations.

This is a permanent action. Revoked cards cannot be reactivated.

post/issuing/cards/{cardId}/revoke

Request

Path parameters

cardIdstring required

The card's unique identifier.

Example:crd_fa6psq242dcd6fdn5gifcq1491

Request body

reason'expired' | 'reported_lost' | 'reported_stolen'

The reason why the card is being revoked.

Example request

{
  "reason": "reported_lost"
}

Response

Card revoked successfully

Example response

{
  "_links": {
    "self": {
      "href": "https://{prefix}.api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491",
      "actions": [
        "GET"
      ],
      "types": [
        "application/json"
      ]
    },
    "controls": {
      "href": "https://{prefix}.api.checkout.com/issuing/controls?target_id=crd_fa6psq42dcdd6fdn5gifcq1491",
      "actions": [
        "GET"
      ],
      "types": [
        "application/json"
      ]
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.