Guides

Plastic Card Delivery and Activation Flow

Here's the guide how to track the physical card's delivery and activate the card.

Suggest Edits

Once card issuance is approved, the user can start using virtual equivalent of a plastic card without waiting for the physical card to arrive. All virtual card functionalities will be available: setting a PIN, ATM withdrawals, deposits, linking to Apple Pay, etc.

Card activation will only be possible after the user gets the physical card delivered.

Step 1. Receiving a Plastic Card

The issued card becomes available via the List All Cards endpoint that retrieves tracking information to monitor the delivery process.

Endpoint:

GET /card-holder/v1/cards

Response Example

  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "userId": "string",
    "accountId": "string",
    "additionalCardInfo": {},
    "status": "ACTIVE",
    "plasticCardStatus": "ORDERED",
    "last4": "string",
    "balance": {
      "amount": 100,
      "currency": "USD"
    },
    "cardType": "PHYSICAL",
    "cardDesign": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "description": "string",
      "image": "string",
      "thumbnail": "string"
    },
    "deliveryInfo": {
      "estimatedDeliveryDate": "2025-06-23T17:15:10.054Z",
      "trackingNumber": "string",
      "trackingUrl": "string"
    },
    "orderedAt": "2025-06-23T17:15:10.054Z"
  }

estimatedDeliveryDate, trackingNumber and trackingUrl parameters appear in the response once submitted by the delivery company, not upon initial order creation.


Possible values for the plasticCardStatus field

StatusDescription
ORDEREDThe physical card has been ordered, the print request is being processed by the partner.
SHIPPEDThe card has been handed over to the delivery service. It is being processed by the logistics partner.
DELIVEREDCard delivered to end user - ready for activation.
ACTIVATEDThe card has been activated by the user.
SUPPORTThe card delivery is declined by the card issuing partner — contact our support team.

Step 2. Activating a Plastic Card

The plastic card can only be activated if plasticCardStatus retrieves DELIVERED value.

Endpoint:

POST /cardholder/card/{cardId}/activate

Request Parameters

ParameterTypeRequiredDescription
cardIdstring✅The unique identifier for the physical card to ba activated.
activationCodestring✅A 6-digits code used to activate plastic card associated with the specified cardId.

Response Example

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "userId": "string",
  "accountId": "string",
  "additionalCardInfo": {},
  "status": "ACTIVE",
  "last4": "string",
  "balance": {
    "amount": 100,
    "currency": "USD"
  },
  "cardDesign": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "description": "string",
    "image": "string",
    "thumbnail": "string"
  }
}

Upon physical card activation, the value in plasticCardStatus field retrieved by List all cards endpoint transits to ACTIVATED.

If the activation code for a plastic card is lost, the user should contact our customer support team to to obtain a new one.

Updated 4 days ago