Activate a card

Last updated: October 22, 2025

The following cards must be activated before the cardholder can perform transactions:

Newly created physical cards
Virtual cards created using the API with "activate_card": false
Suspended cards

You can activate cards using:

The cardholder can activate the card in the following ways:

Performing their first Chip and PIN transaction at a point of sale (PoS) – This also enables the card for contactless payments.
Withdrawing cash from an ATM

The cardholder can access the card's personal identification number (PIN) in your mobile app, using the Android or iOS Card Management SDK. Alternatively, you can send them the PIN via mail.

Note

Cardholders cannot make contactless payments until after they perform a Chip and PIN transaction, even if the card is already successfully activated.

You must have one of the following user roles:

Admin
Support manager
A custom role with the Create and edit cards and cardholders; Simulate transactions permission

Sign in to the Dashboard.
Go to Issuing > Cards.
Select the card you want to activate.
In the Card details page, select Activate card.

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

post

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


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

After you've integrated the Card Management Android SDK or iOS SDK, you can activate your cardholder's 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 activate the card if the status was returned by possibleStateChanges
5if (possibleNewStates.contains(CardState.ACTIVE)) {
6  card.activate(completionHandler)
7}


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 activate the card if the status was returned by possibleStateChanges
9if possibleNewStates.contains(.active) {
10    card.activate(completionHandler: cardStateChangeCompletion)
11}

Complete the change to active 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 activated:

Activate a card

Activation by cardholder

Note

Activate a card in the Dashboard

Activate a card using the API

Response example

Activate a card in your app

Set up webhooks