Skip to main content

Audience:

DevelopersOperators

Card products

A reusable collection of design, settings, and package that defines the cards you offer, identified by a cardProduct.id.

A card product is a collection of design information and configuration settings for the cards you ultimately offer your users. You can have several card products within the same project, each with a unique cardProduct.id.

Each card product can have its own card design, settings, and package. Alternatively, card products might have common designs and settings, depending on your needs. For example, you might choose to offer a single design, but have several card products with different settings based on the intended users.

The very first card product created is your default card product. You won't need to include the id for this card product when issuing cards. If you disable the default card product, however, you must include the CardProductId anytime you call a mutation to add cards (addCard, addCards, and addCardsWithGroupDelivery).

All new card products undergo a review before you can add cards with that design. You can also suspend a card product if you don't want it to be available to your users anymore.

Learn more about designing your card products in the card design section.

Printing hub

The printing hub, where physical cards are printed then shipped to your cardholders, is defined in the card product ID. You must have one dedicated card product per hub, though the designs can be identical.

Each card product includes a card package: a bundle of features, insurance, and pricing that applies to every card you issue, letting you quickly launch market-ready offers without building everything from scratch. Insurance coverage to protect cardholders is determined by the selected card package tier.

Card language

Your card's language (the language that appears on payment terminals, for example) is usually the same as the language chosen for the Swan account.

For Swan's no-code and open source Web Banking interface, the card language is determined by the default language of the browser where the card is created.

When using the API, the default language is the account language. You can update the default language by calling the bindAccountMembership mutation and adding accept-language to the HTTP header. This lets users choose their card language.

Finnish (fi)

Finnish is a supported account language and account membership language with certain limitations:

  • Finnish isn't available as a card language. When the account language is Finnish, the card language defaults to English, which includes card packaging and the language displayed on payment terminals.
  • Finnish isn't available for the bank details document. When the account language is Finnish, the bank details document is generated in English.
Card products

Audience:

DevelopersOperators

On this page