Home / Issuing / Onboard Accounts

Update Account Information

Update Person Account Holder

If an account holder has a pending application, you can't update their account holder information. To request changes to account holder information on a pending application, contact support@highnote.com.

You can use Highnote's API to update the following account holder information:

  • Address
  • Phone number
  • Email

Other account holder information such as Social Security Number (SSN), date of birth, or account holder name must be updated by the Highnote team to ensure compliance with Know Your Customer or Know Your Business (KYC-KYB).

Address

An account holder has two billing addresses, one at the account holder level and another associated with an account holder's payment card. Refer to the following table for an overview of each billing address object:

ObjectDescriptionUse case
billingAddressThe account holder level billing addressUsed for KYC-KYB verification and mailing address if a separate mailing address is not set for the PaymentCardDeliveryDetails object
billingAddressOnCardThe billing address associated with an account holder's payment cardUsed for transaction authorization

When updating an account holder's address, you must update the billingAddress and billingAddressOnCard. Updating both addresses ensures data accuracy across account holder and payment card objects. The updateUSPersonAccountHolder mutation uses the following input fields to update both addresses:

  • billingAddressInput: The account level billing address
  • accountHolderId: The global ID for the account holder
  • updatePaymentCardBillingAddress: Boolean field used to update the billingAddressOnCard; must set the value to true

When updating an account holder's address, note the following requirements:

  • The new address must be a US-based physical address and can’t be a PO box.
  • The full address must be provided with the update, even if only a partial update is needed. For example, if the street address changes and the zip code remains the same, the full address is still needed for the update.

Use the following mutation to update an account holder's billingAddress and billingAddressOnCard:

Phone Number

When updating an account holder's phone number, note the following:

  • The new phone number must include the country code.
  • Only one phone number can be associated with an account holder.
  • Updating the account holder's phone number replaces the current one, regardless of the phone type in the update request. For example, this means the account holder can only have a home or office phone number listed and not both.

Use the following query to update an account holder's phone number:

Email

When updating an account holder’s email, note the following:

  • The new email must be a valid email address.
  • We recommend you send an email to your account holder using the old email address to notify them of the email update and mitigate potential fraud risks.

Use the following query to update an account holder's email:

Credit Risk Attributes

You can update the credit risk attributes for a person account holder. These credit risk attributes include the following:

  • Annual income
  • Debt obligations
  • Employment status

Use the following mutation to update a person account holder's credit risk attributes:

Update Business Account Holder

There are times when onboarded USBusinessAccountHolders may need to update their personal information. You can provide the ability for account holders to update their address, phone number, and website. Other account holder information, such as Employer Identification Number (EIN), Social Security Number (SSN), date of birth, or name may need to be manually reviewed by an agent to ensure compliance with Know Your Customer (KYC) or Know Your Business (KYB).

If an account holder has a pending application, changes cannot be made to their information. If you need to change information on a pending application, contact support@highnote.com.

Address

An account holder has two billing addresses, one at the account holder level and another associated with an account holder's payment card. Refer to the following table for an overview of each billing address object:

ObjectDescriptionUse case
billingAddressThe account holder level billing addressUsed for KYC-KYB verification and mailing address if a separate mailing address is not set for the PaymentCardDeliveryDetails object
billingAddressOnCardThe billing address associated with an account holder's payment cardUsed for transaction authorization

When updating an account holder's address, you must update the billingAddress and billingAddressOnCard. Updating both addresses ensures data accuracy across account holder and payment card objects. The updateUSPersonAccountHolder mutation uses the following input fields to update both addresses:

  • billingAddressInput: The account level billing address
  • accountHolderId: The global ID for the account holder
  • updatePaymentCardBillingAddress: Boolean field used to update the billingAddressOnCard; must set the value to true

When updating an account holder's address, note the following requirements:

  • The new address must be a US-based physical address and can’t be a PO box.
  • The full address must be provided with the update, even if only a partial update is needed. For example, if the street address changes and the zip code remains the same, the full address is still needed for the update.

Use the following mutation to update an account holder's billingAddress and billingAddressOnCard:

Phone Number

When updating an account holder's phone number, note the following:

  • The new phone number must include the country code.
  • Only one phone number can be associated with an account holder.
  • Updating the account holder's phone number replaces the current one, regardless of the phone type in the update request. For example, this means the account holder can only have a home or office phone number listed and not both.

Use the following query to update a business account holder's phone number:

Website

Use the following query to update a business account holder's website URL:

Update Business Associated Person

Business account holders may need to update the information of the primary authorized person and/or beneficial owner(s). You can provide the ability for account holders to update the address, phone number, and email of the primary authorized person and/or beneficial owner(s). Other account holder information, such as Social Security Number (SSN), date of birth, or name may need to be manually reviewed by an agent to ensure compliance with Know Your Customer (KYC) or Know Your Business (KYB).

If an account holder has a pending application, changes cannot be made to their information. If you need to change information on a pending application, contact support@highnote.com.

Address

This section provides an example of updating an business associated person’s address stored at the account holder level. An address is also stored on the payment card, known as the billing address. The billing address is used during authorization for address verification checks, not the business associated person's address. You can use the example query provided in the following section to update both addresses.

When updating a business associated person's address, note the following requirements:

  • The new address must be a U.S. physical address and cannot be a PO box.
  • The full address must be provided with the update, even if only a partial update is needed. For example, if the street address changes and the zip code remains the same, the full address is still needed for the update.

Use the following query to update a business associated person's address:

Phone Number

When updating a business associated person's phone number, note the following:

  • The new phone number must include the country code.
  • Only one phone number can be associated with an account holder.
  • Updating the account holder’s phone number replaces the current one, regardless of the phone type in the update request. For example, this means the account holder can only have a home or office phone number listed and not both.

Use the following query to update a business associated person's phone number:

Email

When updating a business associated person's email, note the following:

  • The new email must be a valid email address.
  • We recommend you send an email to your account holder using the old email address to notify them of the email update and mitigate potential fraud risks.

Use the following query to update a business associated person's email:

Update Authorized User

There are times when onboarded authorized users may need to update their personal information. You can provide the ability for authorized users to update their address, phone number, and email. Other information, such as Social Security Number (SSN), date of birth, or name may need to be manually reviewed by a Highnote agent to ensure compliance with Know Your Customer (KYC) or Know Your Business (KYB).

If an authorized user has a pending application, changes cannot be made to their information. If you need to change information on a pending application, contact support@highnote.com.

Address

This section provides an example of updating an authorized user’s address stored at the account holder level. An address is also stored on the payment card, known as the billing address. The billing address is used during authorization for address verification checks, not the authorized user's address. You can use the example query provided in the following section to update both addresses.

When updating an authorized user’s address, note the following requirements:

  • The new address must be a U.S. physical address and cannot be a PO box.
  • The full address must be provided with the update, even if only a partial update is needed. For example, if the street address changes and the zip code remains the same, the full address is still needed for the update.

Use the following query to update an authorized user’s address:

Phone Number

When updating an authorized user's phone number, note the following:

  • The new phone number must include the country code.
  • Only one phone number can be associated with an account holder.
  • Updating the authorized user’s phone number replaces the current one, regardless of the phone type in the update request. For example, this means the account holder can only have a home or office phone number listed and not both.

Use the following query to update an authorized user's phone number:

Email

When updating an authorized user's email, note the following:

  • The new email must be a valid email address.
  • We recommend you send an email to your authorized user using the old email address to notify them of the email update and mitigate potential fraud risks.

Use the following query to update an authorized user's email:

Provide Feedback

Was this content helpful?