Home / Ledgers
Ledgers are the building blocks of account balances in the Highnote Platform. Transaction Events generate Journal Entries that in turn affect the ledger balances. Thus, Ledgers represent the impact of Transaction Events, like a card swipe or ACH receipt on various account balances. This can be used to create periodic statements or account snapshots. You can also use the ledgers to understand the balance and available balance of an account or the status of any fund movement or anticipated fund movement.
For example, if you wanted to know the balance available to spend on an account you would look at the Available cash ledger balance. If you wanted to know how much of the reduction in available cash balance was from pending activity you wouldn’t have to do any calculations, you could just look at the Auth ledger balance.
Ledgers are created automatically with the creation of your Card Product based on the type. You won’t see all ledgers on a Financial Account, just the ones that impact that account’s balances, informing how the account can be used.
This guide will walk you through how to inspect your Ledger Balances and query activity across the Ledgers. At the end of this guide is an end-to-end example that will help you see how you can use ledgers to understand balances in an account.
Ledgers have a
description, and a
normalBalance determined by the Ledger category. For example, a
CASH Ledger has a category of
ASSETS and has a normal balance of
debit. This normal balance is important in interpreting the balance of the Ledger in a meaningful way as ledger balances are represented as either debit or credit balances.
|Cash||Cash||This is the actual cash in an account or allocated to a card||Debit|
|Available Cash||Available Cash||Cash Available to transact against the account: spend, transfer, advance, or repay||Credit|
|Reserve||Reserve||The Reserve is an organization ledger. See your MSA for Reserve requirements on your account. These are funds held from available cash for emergency funding.||Credit|
|[various] Receivable||*** Receivable||Receivables are created on the originating account when funds are advanced from one account to another. There are several types of advances, in addition to a generic advance, that generate a corresponding receivable; e.g., overdraft receivable, provisional credit receivable Example: Overdraft Receivable, Provisional Credit Receivable, Advance Receivable, etc.||Debit|
|[various] Payable||*** Payable||Payables are generated on accounts receiving any type of advance. They can be used to track repayment for various program use cases such as payroll advance or recouping a provisional credit. Example: Overdraft Payable, Advance Payable||Credit|
|[various] Hold||*** Hold||Hold ledgers are sometimes used by the Highnote Platform to review a transaction for regulatory or compliance reasons. This doesn’t mean anything is wrong simply that we are managing compliance and risks on your behalf. Example: deposit hold, refund hold, fundin hold, etc. (Deposit Hold represents holds on incoming deposit via a payment card, such deposit at an ATM. Refund Hold represents holds on refunds into a payment card. Fundin hold represents holds on fundin to a Financial Account, such as ACH and wire)||Credit|
|Auth||Payment Card Authorizations||The “Auth” ledger is all the currently pending events like a payment card authorization. When an authorization is received funds are deducted from the Available cash ledger and placed here to represent the pending obligation. These may be completed by clearing or reversed at some future date.||Credit|
|RefundAuth||Payment Card Refund Authorizations||This ledger is the pending refunds or returns against a card account||Debit|
|Deposit Auth||Payment Card Deposit Authorizations||This ledger is the pending deposit against a card account||Debit|
|Fee Auth||Payment Card Fee Authorizations||This ledger is the pending fee against a card account||Credit|
|Available Credit||The amount of credit available for the Account Holder to utilize||Credit|
|Secured Deposit||The deposit amount collateralized against the credit line||Credit|
|Outstanding Balance||The balance owed on the credit account||Credit|
|Pending Payment||The Account Holder’s pending repayment towards their outstanding balance||Debit|
|External Bank Account Payment||The Account Holder’s initiated payment amount from an external bank account towards to their Financial Account||Credit|
|External Bank Account Payment Pending||The Account Holder’s pending payment amount from an external bank account||Credit|
|Payment Pending||Pending payment amount from an Account Holder’s external bank account||Credit|
|Payment Pending||Payment amount expected to be received from Account Holder’s external bank account||Debit|
|Outstanding Credit Exposure||The amount of un-utilized credit extended to Account Holders||Debit|
|Outstanding Balance||The amount of credit utilized by Account Holders||Debit|
|Secured Deposit Payable||The secured deposit amount expected to paid by Account Holders||Credit|
|Secured Deposit Receivable||The secured deposit amount expected to be received from Account Holders||Debit|
|Secured Deposit Collateral||The secured deposit amount received from Account Holders||Credit|
|Rewards Balance||The Account Holder’s reward point balance||Debit|
|Rewards Balance available for redemption||The Account Holder’s reward point balance available for redemption||Credit|
Balances are shown as debit or credit balances. If the balance of the Ledger and the normal balance agree, then the balance can be interpreted as positive. If the balance and the normal balance disagree then the balance may be negative.
CASH example again. If the balance of a
CASH Ledger is a debit balance (remember the normal balance for cash is debit) then the balance is positive - money in your account. If the balance of a
CASH Ledger is a credit balance; then, the balance and the normal balance disagree and the credit balance represents a deficit or negative balance in the cash account.
Because the ledger system is based on generally accepted accounting principles cash and activity are represented independently. Meaning, that the balance of an account is the balance for a point in time. There are no pending or available balances, this type of account-level information can be calculated across ledgers if desired.
You can list all the Ledgers for a particular
financialAccount. These Ledgers are generated on entity creation for you and give you the information you need to track cash and activity throughout the Highnote Platform.
Balances are the result of
debits against a particular account. The balance of the account is the excess of either
credits on the account. The account balance is represented by a single positive number, the direction of the balance, either
credit (depending on the side of the account that has the excess balance), and the account's normal balance. Querying the Ledger returns these fields. The meaning of the balance can be derived depending on the perspective and the situation.
For example, a cash account balance of $1,000 with a direction of
debit and a normal balance of
debit represents a balance above zero in the cash ledger. A cash ledger balance of $1,000 with a direction of
credit and a normal balance of debit represents a deficit or funds less than zero. In this case, meaning the account has gone negative.
Activity in a Ledger is a ledger entry. Two or more Ledger Entries that offset each other make up a Journal Entry. Every Journal Entry resulting from an event has two or more Ledger Entries in the form of
debits (the left side) and
credits (the right side). Alone, a Ledger Entry represents the impact of an event on a single Ledger. A Journal Entry is made up of two or more Ledger Entries that offset each other and represent the activity on the Ledger Journal or multiple accounts. The magic of the Ledger is that in any Journal Entry, the Ledger Entries MUST offset each other i.e., debits and credits must be equal.
To make funds available to your Card Product you must transfer money from your bank accounts via a bank transfer. Highnote’s Platform will automatically reconcile the funds into your deposit account once we recognize the cash in your account, which happens once daily.
In our Test Environment, you will not be able to transfer real funds to your card product. Therefore, you should use the
simulateWireTransfer mutation to add funds to your Organization.