Cards

Manage your customers' cards programmatically. These APIs allow you to list cards, retrieve card details, control card status, and manage spending permissions.

Key capabilities:

List and retrieve card details for a profile
Update card status (active, frozen, blocked)
Control spending permissions (e-commerce, ATM, contactless, magnetic stripe, etc.)
Reset PIN attempt counter after incorrect PIN entries
Update card phone number for verification purposes

For accessing sensitive card data (PAN, CVV, PIN), see the Sensitive Card Details API. For ordering new cards, see the Card Orders API. For transaction history, see the Card Transactions API.

SchemasOperations

Card

The Card resource represents a Wise card linked to a profile.

tokenstring

Unique identifier for the card.

Example:"ca0c8154-1e14-4464-a1ce-dcea7dc3de52"

profileIdinteger, (int64)

Profile ID that owns this card.

Example:123456

clientIdstring

Client ID of the partner that issued the card.

Example:"wise_api_docs"

statusobject

Current status of the card.

cardHolderNamestring

Name of the card holder.

Example:"John Smith"

expiryDatestring, (date-time)

Date when the card will expire.

Example:"2028-05-31T00:00:00Z"

lastFourDigitsstring

Last 4 digits of the card number.

Example:"6320"

bankIdentificationNumberstring

Bank identification number (BIN) of the card.

Example:"459661"

phoneNumberstring

Phone number associated with the card.

Example:"+441234567890"

cardProgramobject

Card program details.

unlockSpendingPermissionsstring

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)

Enum:"WITH_PARTNER_API""WITH_FIRST_CHIP_AND_PIN_TRANSACTION""NONE"

Example:"WITH_PARTNER_API"

creationTimestring, (date-time)

Time when the card was created.

Example:"2022-05-31T01:43:24.596321434Z"

modificationTimestring, (date-time)

Time when the card was last modified.

Example:"2022-05-31T01:43:24.596321825Z"

{
  "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"
}