Create a virtual card

A virtual card is a card aimed at online transactions.

It has its very own card design, PAN, CVV and Expiration date.

A virtual card should be displayed as an image to the cardholder.

Prerequisite

Before being able to create a Virtual card, you must have :

• A Valitaded Enduser with a ledger.
  The Ledger doesn't need to be upgraded.
  This Ledger will be debited at each transaction.

• A Card Program matching the Enduser type and the Ledger type, and allowing Virtual Cards.
  See Card Programs page for more details.

Creating the card

Virtual Cards can be created either by a Partner, or directly by the Enduser himself.

To create a Virtual Card, use the "Create a Card" endpoint and provide the Ledger Id as well as the Card Program.

You could also provide extra informations :

• friendlyName : A custom name you want to give to this card.

DeliveryMethod and nameOnCard are not relevant for Virtual cards

Request Body format :

{
  "ledgerId": "a2873d47-59a8-4daf-a325-cb2c04557dd7",
  "profileId": "faebe71b-2bf8-4bdb-9b67-258e4d6aa00a",
  "nameOnCard": "FIRSTNAME LASTNAME",
  "friendlyName": "string",
  "rules": [
    {
      "type": "DAILY_MAX_COUNT",
      "value": 1,
      "name": "string"
    }
  ]
}

A successful Card creation will return a unique id :

{
  "id": "120e9d1f-8444-4b91-85e8-5b208615a3e5",
}

When created, a Virtual card is activated as soon as created.

Fetch the card

You can now Fetch the card by the id to get all its information :

Card status

Cards can have mutliples status during life cycle :

You can close / suspend a card for multiple reasons :

The operator is the one which has decided to close / suspend the card. It can be you as a Partner, an Enduser request or us.