This guide explains how to design your physical and digital card products. In conjunction with your bank, you can design the appearance of your cards. Card design helps differentiate your card in the customer’s wallet.

## Designing your card art

Begin by consulting with your bank and your primary card network to get the required elements for a card design. These required elements could include the following:

  • Bank logo

  • Network logo

  • Your logo or company name

  • Card descriptor such as "Debit Card" or "Cashback"

  • Space for the cardholder name and optionally a line underneath

  • Space for an EMV chip

  • Optional security features such as a hologram

  • Disclaimers

  • Customer service information

As desired, you can create multiple card designs for the same product and give your cardholders a choice, or you can create different designs for different rewards tiers.

For each design you may need to create as many as three versions, depending on which card products you provide. Although the proportions of the card art for physical and digital cards are the same, you cannot use exactly the same image for all card types:

  • [**Physical**](🔗) — Usually requires labels such as "Valid thru" for the expiry date. Must include the design and text for the back of the card, where the CVV or CVC is printed and where you can include customer-service information and disclaimers.

  • [**Digital**](🔗) — The CVV or CVC is labeled and displayed on the front of the card with the expiry but embedded chip elements are not displayed.

  • [**Tokenized**](🔗) — Does not display the expiry, CVV or CVC, or full PAN.

Each major card network (Visa, MasterCard, and Discover for example) has its own naming conventions for security codes. Here's a breakdown:

  • **Visa**

    • **Security code:** Referred to as CVV2 (Card Verification Value 2).

    • **Placement:** CVV2 is usually a 3-digit code located on the back of the card.

  • **MasterCard**

    • **Security code:** Referred to as CVC2 (Card Verification Code 2).

    • **Placement:** CVC2 is usually a 3-digit code located on the back of the card.

  • **Discover**

    • **Security code:** Also referred to as CID (Cardmember ID).

    • **Placement:** CID is a 3-digit code located on the back of the card.

Note

All card art for all formats must be approved by your issuing bank.

### Physical card design

To make your card stand out among other cards, you can leverage the full sensory experience of physical card ownership—how the card looks, feels, sounds, and even smells! Instead of the conventional plastic, you can make your card out of novel materials such as metal, bamboo or wood, which changes how the card feels in the hand and affects how it sounds when dropped on a countertop. Novel surface textures can add to the card's tactile appeal, such as raised patterns or nubbly patches. Some emboss vendors even offer custom scents.

Your card's visual appeal continues with the card art, which displays your logo to its best advantage and establishes your branding theme. You can then add elements such as metallic, sparkling or transparent sectors.

You can also create a basic card design and then offer more "advanced" designs and materials for your more dedicated customers. For example, you could offer a plastic card for all cardholders at first, but after cardholders demonstrate loyalty or maintain an account-balance threshold, they can become eligible for a more elegant card, such as a metal card. When a cardholder presents an impressive card in public, onlookers are sure to ask about it, giving your cardholder the chance to share their experiences with your product.

The specifications for your card design are determined by your emboss vendor in conjunction with the card network and your bank. You will not provide Galileo with the physical card design, but if you have multiple designs for the same product, you will need a way to communicate the design for each card you create. See [Specifying a card design](🔗) for more information.

### Digital card design

Unlike a physical card, a digital card has only one side, which displays the cardholder name, PAN, expiry, and CVV or CVC, as well as the chosen artwork. For virtual cards and digital representations of physical cards (Digital First), follow these instructions to create the card template:

  1. Create two templates for the digital card:

    • One blank template

    • One template with all information populated: PAN, expiry, and CVV or CVC. This enables Galileo to know how to format the digital card image.

  2. Once you have designed the templates, work with Galileo to confirm that all the elements are properly included.

  3. Get approval from your bank.

  4. Register your blank template with Galileo.

500


Blank card template

<!--blank_virtual_card.jpgggggg-->

500


Card image with full PAN, name, expiry, and CVV

<!--populated_virtual_card.jpgggggg-->

If your digital card has a physical counterpart, you can reuse some elements of your physical card design such as font, graphics, or colors, but you cannot include textures, holograms, EMV chips, transparent sectors, or other elements that cannot be reproduced by pixels.

A digital card template must fulfill these requirements:

  • JPG or PNG file format (PNG is preferred)

  • 500 x 315 pixels

  • A label and space for the expiration date

  • A label and space for the CVV or CVC

  • Horizontal or vertical orientation

    • With vertical art, Galileo is flexible with the PAN layout—for example, you can have stacked blocks of 4, horizontal or sideways.

Additional card elements that Galileo can configure:

  • Font – Galileo offers a variety of fonts at no charge. See <a href="page:supported-fonts" target="_blank">Supported Fonts</a> for the list.

  • Font color

  • Font size

  • Lower-case letters and font mixing are not supported.

  • X/Y coordinates for data elements.

  • Spaces to use in between each card number chunk.

The cardholder name on the digital card image is limited to 21 characters. See [Names on cards](🔗) for the algorithm Galileo uses to present and truncate names.

### Tokenized card design

A tokenized (mobile wallet) card template is similar to a digital card template except that it does not display the CVV or CVC, expiry, or the entire PAN. You can include some elements from your physical or digital card design in your tokenized card template for branding continuity, but take note of the exceptions listed below.

  • PNG format

  • 1536 x 969 pixels

  • Image must include your logo and card network logo.

  • Image _must not_ contain these elements:

    • Embossed attributes

    • Transparency overlays

    • Magstripe

    • EMV chip faceplate or contacts

    • Hologram

    • Rounded corners

    • Shading or three-dimensional effects

    • Labels for "Member since," expiry date, or cardholder name

    • Miniature BIN under the PAN

    • White or other color background behind the image

  • Specify RGB values (255, 255, 255) for:

    • Card background, when the image cannot be rendered

    • Foreground, for the last four digits of the PAN

    • Label, for text on the front of the card

## Names on cards

In some cases, a cardholder's full name is too long to fit on a card, either a physical or virtual card. To shorten the name to fit the name space, Galileo uses an algorithm to determine what to include and what to leave out. The `firstName`, `middleName`, and `lastName` fields in the enrollment endpoints or <<glossary:CST>> entry screens are taken into consideration, and the length of the name space can vary depending on embosser and other requirements.

Galileo applies these conditions to the values in the name fields, in this order, until it finds a match:

  1. The combined length of `firstName`, `middleName`, and `lastName` is no more than the name limit

  2. The combined length of `firstName`, the first character of `middleName` and `lastName` is no more than the name limit.

  3. The combined length of `firstName` and `lastName` is no more than the name limit.

  4. The combined length of the first character of `firstName` and the full `lastName` is no more than the name limit.

  5. The length of the `lastName` is no more than the name limit.

  6. If none of the previous conditions apply, then `lastName` is printed, up until the name limit, and then it is cut off.

#### Examples

These examples assume that the name limit is 21 characters.

`firstName``middleName``lastName`Name on card
DavidLewisJonesDavid Lewis Jones
GwynethElizabethSchwartzerGwyneth E Schwartzer
ArabellaMariaSchwarzkopfArabella Schwarzkopf
WilliamRandolphJankowskimarszW Jankowskimarsz
JeanneSuzanneWeatherington-RobertsWeatherington-Roberts
JamesWilsonWeatherington-GreenbergWeatherington-Greenbe

Tip

As desired, you can add the algorithm to your name-input interface to show customers how their name will appear on the card, and you can permit them to update the fields until they get the name that they want.

### Names in Latin America

By request, Galileo can use an algorithm that is better suited to the conventions that are common in Latin American names. As with the default algorithm, the `firstName`, `middleName`, and `lastName` fields in the enrollment endpoints or <<glossary:CST>> entry screens are taken into consideration, and the length of the name space can vary depending on embosser and other requirements. However, with this algorithm, if two or more names are present in `firstName`, then the algorithm breaks `firstName` down into `fname1` (all characters up to the first space) and `fname2` (the rest of the characters).

Galileo applies these conditions to the values in the name fields, in this order, until it finds a match:

  1. The combined length of `firstName`, `middleName`, and `lastName` is no more than the name limit.

  2. The combined length of `firstName`, the first character of `middleName`, and `lastName` is no more than the name limit.

  3. The combined length of `firstName` and `lastName` is no more than the name limit.

  4. The combined length of `fname1` and `lastName` is no more than the name limit.

  5. If none of the previous conditions apply, then `fname1` and `lastName` are printed, up until the name limit, and then it is cut off.

#### Examples

These examples assume that the name limit is 21 characters.

`firstName``middleName``lastName`Name on card
JuanLopezPerezJuan Lopez Perez
Alejandrina
Hernandez RodriguezAlejandrina Hernandez
Luz Marina
Hernandez RodriguezLuz Marina Hernandez
AlejandrinaMariaGarcia RojasAlejandrina M Garcia
AlejandrinaMariaDe OliveraAlejandrina De Oliver
Alejandrina Hernandez
RodriguezAlejandrina Rodriguez
Juan Alejandro
Hernandez RodriguezJuan Hernandez Rodrig
Alejandrinaahernandez
RodriguezAlejandrinaahernandez
Maria de
los Angeles Rodriguez LopezMaria los Angeles Rod

Tip

As desired, you can add this algorithm to your name-input interface to show customers how their name will appear on the card, and you can permit them to update the fields until they get the name that they want.

## Specifying a card design

To specify which card art to use for a digital card (virtual only or Digital First), see <a href="doc:retrieving-card-information#digital-card-images" target="_blank">Digital card images</a> in the _Retrieving Card Information_ guide.

To specify which card design to use when creating a physical or tokenized card, you have several options. For each option you will have to coordinate with your emboss vendor or the card network to determine which value means which image, and you will have to arrange with Galileo to pass that value to the embosser (or the card network for tokenized cards) using one of these methods:

  • Pass a value for one of these parameters with the <a href="ref:post_createaccount" target="_blank">Create Account</a> or <a href="ref:post_startenrollment" target="_blank">Start Enrollment</a> endpoint.

    • `id2` — When passing card art information in this field, you must also pass `idType2: 14` so that `id2` does not have to pass a validation test. This option requires that the EMBFL parameter be set to `GID2`. If you are not using Galileo's integrated CIP process, also make sure there is no value set for VALID and VLDLV; otherwise, you must populate `id` with unique values such as the account holder's phone number.

    • `externalAccountId` — This value will also be included in the Customer Master RDF. (This value is in the <a href="ref:post_completeenrollment" target="_blank">Complete Enrollment</a> endpoint instead of Start Enrollment.) Not valid for mobile wallets.

  • Immediately after account creation, call the <a href="ref:post_setaccountfeature" target="_blank">Set Account Feature</a> endpoint with these settings:

    • `featureType: 16`

    • `featureValue: string|A` — The `string` is a designator for the card art.

Note

If you want to update an image for a tokenized card, first you send the new image to the card network, and then it can take up to 10 days for the new image to be propagated to individual cardholder wallets. If cardholders want to update the image sooner, they can re-provision the card to the wallet.