Subledgers
cross river subledger solution cross river gives you the ability to open a subledger docid\ xqdrbzh8lzhuqiwzedhoz instantly and on demand a subledger is linked to a master account, usually an fbo subledgers (sometimes referred to as subaccounts or virtual accounts in the broader fintech industry) allow segregation of funds within the fbo/master account each subledger is assigned its own account and routing numbers so that payment transactions (such as ach, wire, or rtp) can be originated from or received by the individual subledger this allows partners who use fbos to create a bank account like experience for their customers, unlocking payment and card experiences in subledger api endpoints, the term subaccounts is used instead of subledgers for instance, post /v1/dda/subaccounts what is a subledger a subledger is a virtual account that sits under a master account (usually an fbo) this means that any activity on the funds in the subledger are reflected as activities of the main account however, the subledger can have a beneficiary who is not the owner of the main account this makes subledgers an ideal way for you to send and track payments for your end users (customers), instead of maintaining a separate deposit account for each one a single fbo account can have a very large number of subledgers in the cross river banking core, a subledger is a first class citizen, meaning it supports all the operations available to accounts all transactions first go through the subledger, followed by the master account there are a few types of subledgers funds flow into and out of each more or less the same way, but with certain specific differences all the subledgers under a single master account always sum to the balance of the master account it is virtually impossible for a master account and its subledgers to be out of balance the figure below illustrates the relationship among the subledgers (subaccounts) the subledger and master account balances are updated atomically and never out of sync funds posted to a subledger are immediately available subledger types in cross river, there are a few different types of subledgers implicit passthrough direct implicit subledgers every master account has what is called an implicit subledger , which is automatically created and maintained the implicit subledger accounts for the portion of the balance directly attributed to the master account's activity and has the same account number as the master the implicit subledger is how the cross river banking core ensures that all the subledgers sum to the master account balance if more funds are attributed to other subledgers than directly in the master account, the implicit subledger account balance could go negative passthrough subledgers a passthrough subledger does not require a sufficient balance to fulfill a payment or transaction request in other words, a passthrough subledger can have a negative balance the banking core relies on the master account balance to determine whether to fulfill the request or not even if a specific subledger doesn't have enough funds to send a payment, the payment goes through if the master account has the funds your onboarding manager will guide you in your configuration, based on your operational model and funds flows direct subledgers under a direct ledger configuration, unlike passthrough subledgers, the banking core uses the subledger balance in transaction decisions this means that a payout that exceeds the subledger balance will be rejected by cos comparing direct and passthrough subledgers types and funds flows key features passthrough direct instantaneous rollup of transactions to the master account balance y y fully routable on all payment rails (for example, ach, wires, instant payments) y y supports webhooks on subledger events (such as inbound transactions) y y reflects balance of transactions cleared against account y y subledger can carry a negative balance y n will allow transactions to clear against subledger when balance < $0 (as long as the master account has sufficient funds) y n best for model where funds availability is managed at the subledger level n y best for model where funds availability is managed outside of subledger with need for visibility and efficiency of transactional flows with co mingled funds y n subledger funds flow the following example shows funds movement in a master account with 2 passthrough subledgers in this example, a checking account has been opened with an initial deposit of $500 note that an implicit subledger with the same number has been created and is tracking the balance of the master master account # subledger # balance 2000012345 $500 2000012345 (implicit) $500 next, two subledgers are created at the request of the partner master account # subledger # balance 2000012345 $500 2000012345 (implicit) $500 300007770001 $0 300007770002 $0 a wire for $500 is then sent to each of the subledgers master account # subledger # balance 2000012345 $1500 2000012345 (implicit) $500 300007770001 $500 300007770002 $500 finally, an ach for $1,000 is pulled from subledger 300007770002 master account # subledger # balance 2000012345 $500 2000012345 (implicit) ($1000) 300007770001 $500 300007770002 ($500) note that the implicit subledger is now negative; however, the sum of the subledger still correctly reflects the master account's balance it is good practice to transfer subledger funds to the master account before spending the money ideally the implicit balance should match the master balance no bank statement subledgers are essentially temporary holding places for funds before they move into or out of the master account therefore, there is no way for the system to generate a statement or balance report for a subledger to substantiate a subledger balance, the sum of all subledger balances must total the master account balance since subledgers do not settle , their activity does not re sequence like that of the master account therefore, there is no way to produce a historical record of subledger balance history