Home / Issuing / Issue Cards

Issue Cards

Prerequisites

Note: This guide provides an overview of issuing a financial account and virtual card product using the Highnote API. For instructions on issuing cards using the dashboard and an overview of payment cards, see Payment card basics.

  1. A Highnote account
  2. An API key or the API Explorer
  3. An account holder with approved application

Issue a financial account

Warning: For security and compliance reasons, do not use the account holder's name when assigning a name to a financial account.

Once you have an account holder with an approved application, you can issue a financial account. Financial accounts hold funds for an account holder's payment card(s).

Use the following mutation to issue a financial account, using the approved application's applicationId as an input:

Add account notes

After issuing a financial account, you can use the following mutation to allow your agents to add notes to a financial account. Adding notes is useful for various internal servicing needs:

Find account notes by financial account

Use the following query to display notes on a financial account:

Find account notes by account holder

Use the following query to find account notes for all financial accounts for an account holder:

Payment card lineage

When a new payment card is issued, a hierarchy of cards called a "lineage" is established. This lineage is made up of a Payment Account Reference (PAR) and a unique primary account number (PAN):

  • Payment Account Reference (PAR): The highest level in the payment card lineage; a non-financial reference value assigned by the network to a lineage of payment cards
  • Primary account number (PAN): Sits under a PAR in the payment card lineage; refers to the card number of the cardholder's payment card

A cardholder can only have one active payment card (PAN) in an existing lineage at a time. This is important to note for issuing new cards, reissuing cards, and terminating cards. Refer to the following guidelines for each use case:

Use caseExampleNotes
Issue a new cardAn account holder applies for your card product and is issued a payment card for the first time.When the new card is issued, a new PAR is established, with the new payment card as the PAR's one active PAN.
Reissue a cardAn account holder's payment card expired and they need a new one.A payment card is reissued under the same lineage (PAR) and when activated, the old PAN is automatically deactivated.
Terminate a cardAn account holder loses their payment card and needs a new one.Lost or stolen cards are reported to the card network, which results in the PAN and any predecessors in the card lineage being deactivated. To ensure a proper card termination and re-issuance flow, we recommend terminating the original PAN and issuing a new card to establish a new PAR. This ensures that the card network does not deactivate the new payment card for being associated with the lost or stolen card's card lineage.

Issue a virtual card

All payment cards start as virtual cards, with the option to issue physical or tokenized cards. After creating a financial account for the account holder, you can issue them a virtual card. Refer to the following guidelines when issuing virtual cards:

The following mutation can be used to issue a virtual card associated with a card profile set. If you are issuing a virtual card without a card profile set, remove the cardProfileSetId input variable:

Activate a card

You can either activate virtual cards at creation or provide an experience for account holders to activate their virtual cards from your app or website. The following graphic provides an overview of the card activation flow: payment-card-status-diagram.svg

Use the following mutation to activate a card:

Set a PIN

Warning: Payment cards must be activated before you set the PIN.

Prepaid cards have debit capabilities, so they must have a PIN set after activation. This allows access to ATMs and/or receive cashback at checkout.

You must create an interface for the account holder to set their PIN after activating their payment card. Refer to the following guides to create a PIN management interface:

  • For web-based integrations, Highnote recommends you set the PIN with the Secure Inputs SDK.
  • For iOS and Android based integrations, you can securely set a PIN from the API with a Client Token.

Use the following mutation to set a PIN:

Next steps

When a virtual card is issued, you can print it is a physical card or issue a tokenized card. For more information, see the following guides:

Provide Feedback

Was this content helpful?