A Commercial Secured Credit Card Product allows you to issue credit cards funded from a secured deposit. These Payment Cards may be Virtual Cards available on your app or website, Physical Cards mailed to your Business Account Holder, or both.
In the Test Environment, you can create a Commercial Secured Credit Card Product from the Highnote Dashboard or with the
CreateCardProduct mutation in the Highnote GraphQL API.
Once you've created your Commercial Card Product, you create a Business Account Holder. Account Holders may be issued Payment Cards from multiple Card Products.
For compliance and fraud, we currently prevent opening an Application from the Dashboard in all Live Environments.
Once you have created an Account Holder, you can open an Application to onboard them to your Card Product.
Opening an Application triggers the identity verification checks (KYC) necessary for your Card Product. These checks must pass in order to onboard the Account Holder. To create the Application you will need the
When the Application is opened, it will be in a
PENDING state. This means the Application is being reviewed and the appropriate KYC checks are running against the Account Holder. You can only have one Application open at a time for a given Card Product and Account Holder.
You can monitor the status of the Application by querying for it using the ID returned in the create call.
The status returned will be:
Financial Accounts hold the balance for Payment Cards. To create a new Financial Account pass the ID of a verified Application.
Financial Accounts have an
externalID that allows you to tie the Financial Account to an entity in your system. If you do not pass in an
externalID, Highnote will generate one.
Secured Deposits are initiated by the Account Holder, we do not allow the creation of a Secured Deposit from the Dashboard in the Live Environment.
Prior to transferring from an external bank account, you’ll need to ensure the external bank account is verified via Plaid or Finicity. Following Verification, you can use the Financial Account ID of the verified account and Financial Account ID of the Highnote account.
For Card Products requiring a Secured deposit, such as Secured Commercial Credit, you’ll need to initiate a deposit to the Financial Account of the Account Holder using the External Financial Account ID of the verified account. Once the deposit is successful, this will set the credit limit for the Account Holder.
Once you have created and funded a Financial Account, you can issue a Payment Card.
Once you have issued a Payment Card you can create an Order for a Physical Card. When ordering a Physical Card, you can ship to the Account Holder's address on file or specify a different shipping address.
Physical Card Orders require:
Note: You may only submit one Order for a given Payment Card. If the Order is canceled or fails, you may try again for the same card. However, if an Order is successful and you need another Physical Card, you will need to issue a new Payment Card.
cvv fields requires that you are PCI compliant.
Highnote recommends using the Card Viewer SDK to securely display payment card data and and reduce PCI burden.
To display the primary account number (PAN) and CVV to users, you can fetch them from the API by adding
cvv to the selection set
Highnote provides the data necessary to create a statement for a Financial Account, which you can leverage to populate your own statement template and provide to your customers.
Billing statement data is created on Financial Accounts and becomes available at the end of a billing cycle. For Credit Card products, the billing period end date may vary across Financial Accounts on your portfolio. Statement data is typically available within 48 hours of a billing period end date.
You can query the latest billing statement data for a Financial Account to generate the Account’s statement in the
latestClosedStatement. Billing statements will only include posted transactions and the associated balances for a given billing period. Transactions for the Financial Account’s current billing period and their next, upcoming due date can be found in the
When there is a balance due on the Financial Account, the
currentAmountDue will be updated based on credits (e.g. payments, refunds) to the Financial Account between the billing period end date and the due date. You’ll need to reference the type of
SecuredDepositCommercialCreditCardFinancialAccountStatement Snapshot to retrieve the current amount due, based on your Card Product. You can present this balance to your customer outside of the statement itself so they are informed on the remaining amount owed since their last statement was generated.
In the Test Environment, you can end a Financial Account’s billing period early so you can simulate a billing period’s statement without waiting for the billing period to end.
The new period must be at least 60 seconds in the future, and if the periodBoundary is not supplied, the statement endPeriod will be set to 60 seconds in the future.
In the Test Environment, you can roll over a Financial Account’s billing period to the next billing cycle so you can simulate ending and starting a new billing cycle for a Financial Account. Rolling over to the next billing period allows you test and view how the statement data for a closed billing period is calculated without waiting until the actual calendar day for the billing period to close.
Once you've completed the basics of setting up your card product, you can expand and test your integration further: