Create a physical card

A physical card will be printed when created and delivered directly to your Enduser. It can be used in-store, at an ATM, and online. Physical cards support chip-and-PIN and contactless payment methods.

The card will be attached to a carrier, which can be customized. The design for the carrier will have been set up into the card programme based on the carrier template design you've sent.

Prerequisite

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

• A validated 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 Physical Cards. See Card Programs page for more details [Here.] (./card-program.mdx)

Creating the card

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

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

You could also provide extra informations :

• Delivery Method : Type of delivery for the physical card : "FRENCH_MAIL", "FRENCH_MAIL_TRACKING", "INTERNATIONAL_MAIL"

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

• Name on card : The name that will be embossed/printed on the card, limited to 21 characters. If not provided, the name of the related Enduser will be taken. By default, name on card is firstName + lastName.

This is an example Payload for a physical Card creation :

{
  "deliveryMethod": "FRENCH_MAIL",
  "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 Physical card is NOT activated.

It has to be activated when received by the cardholder.

See Card Activation page for details.

Card Shipment

Physical card will be created and shipped within days, according to the selected Delivery Method. Card is sent directly to the Enduser Address.

No tracking is available for now. We are looking to add this possibility as soon as possible.

Extra costs may apply depending on the Delivery Method.

Fetch the card

You can 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.