CHcheckout
Cards

Suspend a card

Suspends an active or inactive card to temporarily decline all incoming authorizations.

A suspended card can be reactivated.

post/issuing/cards/{cardId}/suspend

Request

Path parameters

cardIdstring required

The card's unique identifier.

Example:crd_fa6psq242dcd6fdn5gifcq1491

Request body

reason'suspected_lost' | 'suspected_stolen'

The reason why the card is being suspended.

Example request

{
  "reason": "suspected_lost"
}

Response

Card suspended successfully

Example response

{
  "_links": {
    "self": {
      "href": "https://{prefix}.api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491",
      "actions": [
        "GET"
      ],
      "types": [
        "application/json"
      ]
    },
    "activate": {
      "href": "https://{prefix}.api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491/activate",
      "actions": [
        "POST"
      ],
      "types": [
        "application/json"
      ]
    },
    "revoke": {
      "href": "https://{prefix}.api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491/revoke",
      "actions": [
        "POST"
      ],
      "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.