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 Google Wallet, 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

The following statuses are applied based on the delivery type configured for your account through your Account Manager.

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.
DELIVEREDThe card was delivered to end user.
READY_FOR_ACTIVATIONThe card is being delivered and will be ready for activation as soon as it arrives to the end user.
ACTIVATEDThe card has been activated by the user.
SUPPORTThe card delivery is declined by the card issuing partner — contact our support team.

Individual Delivery Type:

  • ORDERED;
  • READY_FOR_ACTIVATION;
  • ACTIVATED;
  • SUPPORT.

Bulk Delivery Type:

  • ORDERED;
  • SHIPPED;
  • DELIVERED;
  • ACTIVATED;
  • SUPPORT.

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 about 8 hours ago