Overview
When you issue a corporate card, you can choose its visual design. Altery offers four ready-made designs. Each design has a numeric cardDesignId that you pass when issuing a card.
Available designs
1 - Visa Generic Orange
5 - Visa Business Card Virtual
10 - VISA Generic Black
11 - VISA Generic White
Choosing a design when issuing a card
cardDesignId is an optional field on:
- Issues new card –
POST /v1/corporate-cards - Reissues a virtual card to physical –
POST /v1/corporate-cards/{cardId}/physical
If you do not specify cardDesignId, the card is issued with the default design 1 – Visa Generic Orange.
AttentionEarlier, at your request, we may have linked a specific design to your user profile. If you'd like to restore the ability to choose, please contact us so we can remove this link.
Reading the design from a card
The design of an already-issued card is returned in the card object as the designId field (an integer that matches one of the cardDesignId values listed above). It always reflects the design the card was actually issued with — including the default 1 when no design was requested, or a design linked to your profile.
In requests the field is namedcardDesignId, but in responses the same value is returned asdesignId.
designId is present on the card object in the responses of:
- Get card –
GET /v1/corporate-cards/{cardId} - Get cards –
GET /v1/corporate-cards - Issue new card –
POST /v1/corporate-cards - Reissue a virtual card to physical –
POST /v1/corporate-cards/{cardId}/physical - Bind a promo card –
POST /v1/corporate-cards/promo/bind
The same card object (and its designId) is also delivered in the card webhook payload, so you can capture the actual design as soon as the card is issued.
Using the design assets in your app
You can download the design images above and reuse them in your own applications.
Google Pay and Apple Pay recommend that the design of an issued card matches what the user sees in your app, so we recommend reusing these assets for card visuals and wallet provisioning.