Home / Issuing / Onboard Accounts

Onboard an Account


  1. A Highnote Account
  2. Access to the GraphQL API, API Explorer, or Dashboard


Card Products serve as a broad category that includes various components such as Applications, Financial Accounts, Payment Cards, and Bank Accounts, along with their associated Transactions. There are two main types of Card Products:

  • Commercial: Used by US Business Account Holders
  • Consumer: Used by US Person Account Holders

See the Quick Start Templates guides for more information on each vertical.

Create your Card Product

The Highnote Team sets up card products in the Live Environment on your behalf. However, Highnote provides self-service options for all card products in the Test Environment.

The following mutation can be used to create a card product in your Test Environment. There are several types of card product verticals you can offer. Replace the usage and vertical input variables with your card product's corresponding values.

Onboard an Account Holder

Once your card product is created, the next step is to create an account holder. There are two types of account holders, consumer and commercial. Both types of account holders can open applications and are issued payment cards and financial accounts. Account holders do not live under specific card products and can use multiple cards, such as a separate debit and credit card.

Onboard a US Business Account Holder

For enhanced security, you can use Client Tokens when onboarding Account Holders. See Client Tokens for more information.

A USBusinessAccountHolder is an account holder that uses a commercial card product. There are several different components that make up a US business account holder's details:

  • Business details: Includes business name, identification number (EIN), business type, business phone, and website.
  • Primary authorized person: Person authorized to act on behalf of the business. If a Primary Authorized Person owns or controls at least 25% of the business, they are also automatically added as a Beneficial Owner.
  • Beneficial owners: Person who owns or controls at least 25% of the business.

You can use the following mutation to create a USBusinessAccountHolder:

Onboard a US Person Account Holder

For enhanced security, you can use Client Tokens when onboarding Account Holders. See Client Tokens for more information.

A USPersonAccountHolder is an account holder that uses a consumer card product. This type of account holder has account details, including the account holder's name, address, contact information, date of birth, and social security number (SSN).

If you do not have a server or do not wish to store account holder data on a server, you can generate a Client Token to securely pass account holder data to Highnote. For more information on client tokens, see Using Client Tokens.

You can use the following mutation to create a USPersonAccountHolder:

Required Fields

When creating an account holder onboarding form or experience for your app or website, there are several required fields. These required fields are essentials for running identity checks and ensuring the account holder qualifies for your card product.

For a list of required fields for account holders, review the Create Account Holder section of the Design Your Card Experience guide.

Open an Application

With an account holder created, you can open an application for your card product. When an application is opened, the following verification checks are typically run:

  • Know Your Customer (KYC)
  • Know Your Business (KYB)
  • Office of Foreign Assets Control (OFAC) screening
  • First and third-party fraud risk

When an application is opened, you must present your compliance agreements and record the timestamp the account holder consents to the agreements. Once an application is submitted, it is reviewed by the Highnote team in an asynchronous process. We recommend displaying a view for the account holder that lets them know their application is being reviewed.

You can use the following mutation to create an account holder application for a card product. For this example mutation, include the following IDs as input variables:


These IDs are in the Onboard an Account Holder mutation response or can be found in the Highnote Dashboard.

Check Application Status


After an application is submitted, the application’s applicationState.status returned will be one of the following:

  • PENDING: The application has been received, and the system is running automated verifications.
  • IN_REVIEW: Sometimes, an application may be flagged for manual review because fraud is suspected or the information provided appears incorrect. This status indicates a Highnote agent is reviewing the application to determine a decision or if additional information is required from the account holder.
  • DENIED: The application has failed one or more card product policies. A payment card cannot be issued to this account holder. Customer notification of the denial and denial reason may be required.
  • APPROVED: The application has been approved. You may now issue a financial account for the account holder.

You can monitor an open application's status using the APPLICATION_ID created in the response of the open an application query. Use the following query to check the application status:

Next Steps: Issue Cards

After onboarding an account, you can issue a card to the account holder. This involves issuing a financial account to the account holder, issuing a virtual card, activating the card, and setting a PIN if applicable. See Issue Cards for more details on next steps.

Provide Feedback

Was this content helpful?