Suspend a card

Last updated: August 27, 2025

If you suspect your cardholder's card has been lost, stolen, or used for fraudulent activity, you can suspend the card to temporarily freeze it and automatically block any new transactions.

The following actions are still allowed on a suspended card:

Authorization requests linked to a previous transaction, for example, an incremental authorization
Chargebacks
Recurring payments through merchant-initiated transactions (MITs)
Refunds
Reversals
Tokenization

You can suspend a card using:

You must have on of the following user roles:

Admin
A custom role with the Manage Issuing data permission

Sign in to the Dashboard.
Go to Issuing > Cards.
Select the card you want to suspend.
In the Card details page that appears, select Suspend card.

Call the Suspend a card endpoint, and provide the card ID prefixed with crd_ as the {cardId} path parameter.

In the request body, set the reason field to one of the following reasons for suspending the card:

suspected_lost
suspected_stolen

post

https://api.checkout.com/issuing/cards/{cardId}/suspend


1{
2  "reason": "suspected_lost"
3}


1{
2  "_links": {
3    "self": {
4      "href": "https://api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491"
5    },
6    "activate": {
7      "href": "https://api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491/activate"
8    },
9    "revoke": {
10      "href": "https://api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491/revoke"
11    }
12  }
13}

You can now either reactivate the suspended card, or permanently revoke it.

After you've integrated the Card Management Android SDK or iOS SDK, you can suspend cards in your mobile app.

Follow these steps:

Call the getCards() method to get a list of the cardholder's cards:


1cardManager.getCards { result: Result<List<Card>> ->
2  result.onSuccess {
3    // You receive a list of the cardholder's cards that you can display in your UI
4    // The card details returned include the last four digits of the PAN, expiry date, cardholder name, card status, and card ID
5  }.onFailure {
6    // If something goes wrong, you receive an error with more information
7  }
8}


1cardManager.getCards { result in
2  switch result {
3  case .success(let cards):
4    // You receive a list of the cardholder's cards that you can display in your UI
5    // The card details returned include last four digits of the PAN, expiry date, cardholder name, card status, and card ID
6  case .failure(let error):
7    // If something goes wrong, you receive an error with more information
8  }
9}

Call the Card.possibleStateChanges() method to request the possible statuses you can change the card to:


1// Returns a list of possible statuses you can change the card to
2val possibleNewStates = card.possibleStateChanges
3
4// You can suspend the card if the status was returned by possibleStateChanges
5if (possibleNewStates.contains(CardState.SUSPENDED)) {
6  // Optionally, you can pass the reason for suspending the card
7  val reason: CardSuspendReason? = CardSuspendReason.LOST
8  card.suspend(reason, completionHandler)
9}


1import CheckoutCardManagement
2
3class YourObject {
4
5  // Returns a list of possible statuses you can change the card to
6let possibleNewStates = card.possibleStateChanges
7
8// You can suspend the card if the status was returned by possibleStateChanges
9if possibleNewStates.contains(.suspended) {
10    // Optionally, you can pass the reason for suspending the card
11    let reason: CardSuspendReason? = .lost
12
13    card.suspend(reason: reason, completionHandler: cardStateChangeCompletion)
14}

Complete the change to suspended status:


1fun cardStateChangeCompletionHandler(result: Result<Unit>): Unit {
2  result
3    .onSuccess {
4      // The card status is successfully updated and reflected by both the back end and the SDK
5    }.onFailure {
6      // If something goes wrong, you receive an error with more details
7    }
8}


1func cardStateChangeCompletion(_ result: CheckoutCardManager.OperationResult) {
2    switch result {
3    case .success:
4        // The card status is successfully updated and reflected by both the back end and the SDK
5    case .failure(let error):
6        // If something goes wrong, you receive an error with more details
7    }
8}

You can configure webhooks to be notified when cards are suspended:

Suspend a card

Suspend a card in the Dashboard

Suspend a card using the API

Request example

Response example

Suspend a card in your app

Set up webhooks