Home / Issuing / Onboard Accounts
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:
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).
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:
Object | Description | Use case |
---|---|---|
billingAddress | The account holder level billing address | Used for KYC-KYB verification and mailing address if a separate mailing address is not set for the PaymentCardDeliveryDetails object |
billingAddressOnCard | The billing address associated with an account holder's payment card | Used 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 addressaccountHolderId
: The global ID for the account holderupdatePaymentCardBillingAddress
: Boolean field used to update the billingAddressOnCard
; must set the value to true
When updating an account holder's address, note the following requirements:
Use the following mutation to update an account holder's billingAddress
and billingAddressOnCard
:
When updating an account holder's phone number, note the following:
Use the following query to update an account holder's phone number:
When updating an account holder’s email, note the following:
Use the following query to update an account holder's email:
You can update the credit risk attributes for a person account holder. These credit risk attributes include the following:
Use the following mutation to update a person account holder's credit risk attributes:
There are times when onboarded USBusinessAccountHolder
s 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.
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:
Object | Description | Use case |
---|---|---|
billingAddress | The account holder level billing address | Used for KYC-KYB verification and mailing address if a separate mailing address is not set for the PaymentCardDeliveryDetails object |
billingAddressOnCard | The billing address associated with an account holder's payment card | Used 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 addressaccountHolderId
: The global ID for the account holderupdatePaymentCardBillingAddress
: Boolean field used to update the billingAddressOnCard
; must set the value to true
When updating an account holder's address, note the following requirements:
Use the following mutation to update an account holder's billingAddress
and billingAddressOnCard
:
When updating an account holder's phone number, note the following:
Use the following query to update a business account holder's phone number:
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.
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:
Use the following query to update a business associated person's address:
When updating a business associated person's phone number, note the following:
Use the following query to update a business associated person's phone number:
When updating a business associated person's email, note the following:
Use the following query to update a business associated person's email:
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.
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:
Use the following query to update an authorized user’s address:
When updating an authorized user's phone number, note the following:
Use the following query to update an authorized user's phone number:
When updating an authorized user's email, note the following:
Use the following query to update an authorized user's email: