Subledgers

1. A checking account is opened with an initial deposit of $500. An implicit subledger with the same number is created and is tracking the balance of the master.

   Master Account #	Subledger Account #	Balance
   2000012345	--	$500
   	2000012345 (Implicit)	$500

2. Next, two subledgers are created at the request of the partner:

   Master Account #	Subledger Account #	Balance
   2000012345	--	$500
   	2000012345 (Implicit)	$500
   	300007770001	$0
   	300007770002	$0

3. A wire for $500 is sent to each of the subledgers:

   Master Account #	Subledger Account #	Balance
   2000012345	--	$1500
   	2000012345 (Implicit)	$500
   	300007770001	$500
   	300007770002	$500

4. $1,000 is pulled from the master account directly:

   Master Account #	Subledger Account #	Balance
   2000012345	--	$500
   	2000012345 (Implicit)	($500)
   	300007770001	$500
   	300007770002	$500

   The implicit subledger is now negative but the sum of the subledger still correctly reflects the master account balance.

   Best practice

   Transfer subledger funds to the master account before spending the money. The implicit balance should match the master balance.

Passthrough subledgers

With passthrough subledger configuration, the master account balance is the true representation of value in the account when determining funds availability for transactions. Thus only the master account balance will be used in transaction decisions. The master account balance is not dependent on subledgers, and the master account balance can move above or below the aggregate value reflected in the subledger balances. Thus the sub ledger balance is ignored.

An individual subledger balance in this configuration can go negative, as can the implicit subledger balance. However, the master account must have a sufficient balance for a withdrawal to post.

Usually, with a passthrough configuration the partner maintains a ledger with end-user (customer) balances on its own systems. The partner can also maintain a customer ledger at CR with the passthrough configuration. However, that requires that the partner actively maintain a true balance by transferring funds to and from the master and subledgers as needed (for example, a withdrawal from the master account requires a corresponding transfer from a subledger to the master account).

For this reason, passthrough subledgers aren’t an optimal way to maintain a balance of all their customers’ dollars when compared to the direct subledger configuration.

Withdrawing funds with passthrough subledgers

With passthrough subledgers, partners can withdraw funds from the master account or directly from a subledger.

Withdrawing funds from master account (passthrough)

When funds are withdrawn from the master account, they are debited from the implicit subledger (which represents the true balance), as well as from the master account. This is because in the passthrough configuration the aggregate value in the non-implicit subledgers does not equal the total balance in the master account.

Partners can withdraw funds from the master account without first transferring funds from a subledger to the master account. In this case, the subledger will represent a balance which is not a true representation of available funds.

Withdrawing funds from subledger account (passthrough)

If a partner wants to withdraw funds directly from the subledger, there is a corresponding debit to the implicit subledger. If the master account is designated in the API as the account to withdraw from, funds will be debited from the master account and the implicit subledger. If a subledger is used in your transaction or payment request, the CR system will transact on the master by that amount.

Depositing funds with passthrough

In passthrough, when funds are deposited they are credited to the designated subledger, the implicit subledger, and the master ledger.

Direct subledgers

Under a direct ledger configuration the aggregate subledger balance will be used in transaction decisions. The implicit subledger cannot go negative, and neither can any of the individual sub ledger balances.

With direct subledgers, the aggregate sub ledger balance must equal the value in the master account. If the partner wishes to withdraw funds from the master account, the funds must be transferred from a sub ledger account to the master account.

With a direct subledger, when a partner makes a withdrawal, funds are debited from the subledger. Funds cannot be withdrawn from the master account without transferring them first from the subledger to the master account.

Passthrough vs. direct subledgers

Regardless of what type of subledger is used, the balance of the subledgers including the implicit subledger add up to the master account balance.

For direct subledgers, the implicit subledger is only dealing with funds coming in and out of the master. The implicit subledger doesn’t float to balance the subledgers with the master as it does with passthrough subledgers. With direct, if the master account is funded directly, the implicit subledger will reflect that value. The rest of the value is in the other subledgers.

For instance, with direct, if a master account has 3 subledgers with $100 each and the implicit balance is at $0, the master will say $300. If $100 is deposited to the master account directly, then the implicit subledger will have a balance of $100, and the account will have a total balance of $400. If $400 was to then be withdrawn from the master, there would need to be a transfer of $300 ($100 from each subledger) to the master.

With a passthrough configuration, if the master account balance is $300, then $300 is withdrawn from the master without any corresponding debits from the subledgers.

With both passthrough and direct subledger configurations, all subledgers + implicit subledger = funds availability (master). The difference is that with a passthrough configuration, the implicit subledger and individual subledgers can be negative, whereas with direct configuration they cannot.

Conclusion

Passthrough is generally better for situations where a partner manages end-user deposits in multiple banks. For instance, a partner can manage customer funds at CR and two other banks, where the aggregate customer funds total $3 million, with 10 customers. With passthrough subledgers, there is no need for partners to specify which customer dollar is held in which subledger. With direct subledgers, it’s more tricky, because partners need to not only consider how much their deposit balance is at CR in general, but how much they have allocated for each of their customers in subledgers.

A direct ledger system can be more difficult to manage, since in order to withdraw funds from the master account, the funds must be transferred from its subledger accounts to the implicit master account. For this reason, it is recommended to consider the use case and configure in a way that will best serve your needs.

The only information required to open a sub ledger is the master account number and Title field. The Title is typically set to the name of the partner. Subledgers also support a beneficiary profile for storing additional data such as the name and address associated with the subledger. Your Integration manager will assist you with any questions related to the data used to populate these fields, as they can vary by use case and program.

Once opened, the subledger is ready within a few seconds.

POST /core/v1/dda/subaccounts
{
  "masterAccountNumber": "2001231234",
  "title": "Acme Co",
  "beneficiary": {
    "referenceId": "ABC789",
    "entityName": "Acme Co",
    "streetAddress1": "400 Business Street",
    "streetAddress2": "Suite 123",
    "city": "New York",
    "state": "NY",
    "postalCode": "10025",
    "countryCode": "US",
    "phoneNumber": "2015551234",
    "emailAddress": "acme@test.com",
    "notes": "Testing 123"
  }
}