Types of ledgers in Blnk
Blnk includes two types of ledgers — a General Ledger and custom ledgers.- General Ledger: This built-in ledger is designed to group balances that represent accounts owned by your organization, similar to a Chart of Accounts. Unlike custom ledgers, balances in the General Ledger come with indicators, making it easier to reference them in your code when recording transactions. To learn more about the General Ledger, see the following: General Ledger.
- Custom ledgers: These are ledgers you create based on the ledger architecture you’ve defined for your application.
Creating a ledger
To create a ledger, call the Create Ledger endpoint:Response
Field | Description | Required | Type |
---|---|---|---|
name | A name that best describes the function of the ledger | Yes | string |
meta_data | Custom data associated with the ledger being created | No | object |
Practical example
Here’s an example with seven accounts to illustrate how to use ledgers in Blnk:Account name | Type(s) |
---|---|
Aria Collins | Savings |
Luca Sanders | Savings |
Ivy Monroe | Checking |
Jasper Hale | Checking, Savings |
Mia Delgado | Savings |
Ezra Donovan | Checking |
Ruby Foster | Checking, Savings |
Ledger grouping by type
In this approach, accounts are organized by type rather than by individual customer. Two separate ledgers are created— one for “Savings Accounts” and another for “Checking Accounts.” This setup groups accounts by their function, making it easy to reference all accounts within a specific type.Savings Account Ledger | Checking Account Ledger |
---|---|
- Aria Collins - Luca Sanders - Jasper Hale - Mia Delgado - Ruby Foster | - Ivy Monroe - Jasper Hale - Ezra Donovan - Ruby Foster |
Ledger grouping by name
In this approach, rather than organizing accounts by type (e.g., Savings or Checking), we create a separate ledger for each unique customer. This allows each customer’s accounts to be listed together under their name, making it easy to view all accounts belonging to a single individual.Aria Collins | Luca Sanders | Ivy Monroe | Jasper Hale | Mia Delgado | Ezra Donovan | Ruby Foster |
---|---|---|---|---|---|---|
- Savings | - Savings | - Checking | - Checking - Savings | - Savings | - Checking | - Checking - Savings |