v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

card

Update card status

Update the status of a card. For cards issued with an INACTIVE status, updating to ACTIVE will activate the card and move the card order status to COMPLETED.

Available status transitions:

ACTIVE - The card is active and usable
FROZEN - The card is temporarily frozen; all authorization requests will be declined
BLOCKED - The card is irreversibly blocked and is no longer usable

put/v3/spend/profiles/{profileId}/cards/{cardToken}/status

Path parameters

profileIdinteger required

The ID of the profile that owns the card.

cardTokenstring uuid required

The unique token identifying the card.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

status'ACTIVE' | 'FROZEN' | 'BLOCKED' required

The status to update the card to.

Example request

{
  "status": "ACTIVE"
}

Response

Card status updated successfully.

tokenstring

Unique identifier for the card.

profileIdinteger

Profile ID that owns this card.

clientIdstring

Client ID of the partner that issued the card.

cardHolderNamestring

Name of the card holder.

expiryDatestring date-time

Date when the card will expire.

lastFourDigitsstring

Last 4 digits of the card number.

bankIdentificationNumberstring

Bank identification number (BIN) of the card.

phoneNumberstring

Phone number associated with the card.

unlockSpendingPermissions'WITH_PARTNER_API' | 'WITH_FIRST_CHIP_AND_PIN_TRANSACTION' | 'NONE'

Method with which physical card spending permissions can be unlocked. One of:

WITH_PARTNER_API - Unlock via Partner API
WITH_FIRST_CHIP_AND_PIN_TRANSACTION - Unlock with first chip and PIN transaction
NONE - Not applicable (for virtual cards)

creationTimestring date-time

Time when the card was created.

modificationTimestring date-time

Time when the card was last modified.

Example response

{
  "token": "ca0c8154-1e14-4464-a1ce-dcea7dc3de52",
  "profileId": 123456,
  "clientId": "wise_api_docs",
  "status": {
    "value": "ACTIVE"
  },
  "cardHolderName": "John Smith",
  "expiryDate": "2028-05-31T00:00:00Z",
  "lastFourDigits": "6320",
  "bankIdentificationNumber": "459661",
  "phoneNumber": "+441234567890",
  "cardProgram": {
    "name": "VISA_DEBIT_BUSINESS_UK_1",
    "scheme": "VISA",
    "defaultCurrency": "GBP",
    "cardType": "VIRTUAL"
  },
  "unlockSpendingPermissions": "WITH_PARTNER_API",
  "creationTime": "2022-05-31T01:43:24.596321434Z",
  "modificationTime": "2022-05-31T01:43:24.596321825Z"
}