Cards

Description of the Bond Cards and Card Account resources, their relationship to each other and to other resources.

2589

You can create a card for customers who have passed either the KYC verification. For details, see Know your customer.

The cards API is used to create a card and manage cards for your customers. Creating a card generates a card_id (unique ID that identifies the card) and a card_account_id (unique Bond ID for the card account).

Once a card is created, you can manage the card, for example, close and reissue the card. Part of managing a card is changing its status to active, lost, stolen, and so on.

A card (card_id) and its card account (card_account_id) are closely coupled but logically distinct, the difference being in what is being managed. The card ID contains information about the actual card, while the card account ID stores broader account information, such as:

  • The KYC provider
  • Whether it is a debit/credit program
  • The card processor
  • The BIN provider

Card configurations

A card can be virtual, physical, or dual, which is determined by the program_id that is provided by Bond based on your requirements. For details, see Card configurations.

Funding a card

A card can be funded from either another card or from an external bank account. To be able to fund a card from a bank account, your customer needs to link the card to the bank account by requesting to link a bank account to their card. The customer then logs in to their bank account and chooses which account to link to the card. The connection between the bank account and the card uses the card_account_id, not the card_id.

Your customer can now transfer funds to and from the card and make purchases.

For a complete specification and interactive examples, see Creating a card in the Bond API Reference.