Skip to main content
Transactions record the movement of money between balances. Blnk uses double-entry accounting by default, so every transaction must have both a source and a destination.

​
Create transactions

To create a new transaction:
1

Create transaction

Click Create transaction in the top-right corner of the Transactions table or press ⌥ + T (Alt + T for Windows).
Transactions table with Create new transaction panel open
2

Enter the required details

  • Amount: The amount of the transaction.
  • Currency: The currency the transaction will use.
  • Precision: The multiplier that converts the amount into the currency’s smallest unit.
  • Source: The balance from which funds will be debited.
  • Destination: The balance to which funds will be credited.
  • Description: A short note describing the purpose of the transaction.
Create new transaction form with required fields
3

Reference number

Blnk Cloud automatically generates a reference number for the transaction.
4

Complete

Click Create transaction to complete.
Transactions table showing a newly created transaction

​
Understanding precision

Balances are stored and calculated as integers to maintain accuracy. For example, a balance of $1,000.00 is stored as 100000 in Core. When creating transactions, apply precision by converting the amount into the currency’s smallest unit. For most fiat currencies this value is 100, while for cryptocurrencies like BTC it is 10^8.
To prevent rounding errors, we recommend using a consistent precision value for all transactions within the same currency.See transaction precision for details.

​
Applying overdrafts

Overdrafts let you create transactions even when the source balance does not have sufficient funds. This is commonly used in funding workflows, where one balance needs to act as the counterparty for the balance being funded. Apply overdraft toggle on the create transaction form
To apply an overdraft, enable Apply overdraft before creating the transaction.

​
Applying inflight

Inflight lets you create and hold transactions until certain conditions are met. This is commonly used in workflows that require a delay, such as payment processing, escrow releases, or order fulfillment. Apply inflight toggle on the create transaction form
To apply inflight, enable Apply inflight before creating the transaction.

​
Applying effective date

Effective date lets you record a transaction with a financial date in the past, separate from when it was entered in Blnk. If you do not set one, it defaults to the same value as the date created. Effective date toggle on the create transaction form
To apply an effective date, enable Effective date before creating the transaction, then provide the date and time when the transaction happened.
Effective date cannot be in the future. Use Schedule transaction instead.

​
Applying multiple sources

Multiple sources let you debit more than one balance and credit a single destination in one transaction. This is useful when several accounts fund one payout, wallet, or settlement balance. Create new transaction form with multiple source fields and one destination
To apply multiple sources, under Source click Add another source and set the balance and amount for each leg.

​
Applying multiple destinations

Multiple destinations let you debit one balance and credit more than one destination in one transaction. This is useful when one balance pays out or distributes to several recipients. Create new transaction form with one source and multiple destination fields
To apply multiple destinations, under Destination click Add another destination and set the balance and amount (or distribution) for each leg.
You can use multiple sources or multiple destinations in one transaction, not both.

Multiple sources

Multiple sources, one destination.

Multiple destinations

One source, multiple destinations.

​
Scheduling transactions

Scheduling lets you create transactions to be processed at a specific time in the future. Schedule transaction form with date and time selection
To schedule a transaction:
  1. Enable Schedule transaction before creating the transaction.
  2. Provide the date and time for the transaction to be scheduled.
  3. Click Create transaction to complete.
Scheduled transactions are shown with @SCHEDULED status in your Transactions table. On the specified date, transactions with this status will be processed automatically and added to the Core ledger.

​
Working with transactions

All records in Blnk are immutable. Once a transaction is created, it cannot be deleted or altered. Any status change is captured as a new transaction entry, which references the original transaction through the parent_transaction field.

​
Transactions table

The Transactions table shows a list of all transactions in your workspace. For each transaction, you can see: Transactions table showing all transaction information
  • Currency: The currency the transaction is in.
  • Amount: The amount of the transaction.
  • Status: The status of the transaction.
  • Source: The balance from which funds were debited.
  • Destination: The balance to which funds were credited.
  • Effective date: When the transaction actually happened. If not specified, it is the same as the date created.
Use the Add filters and Refresh buttons to customize your view and get the latest transaction data from your instance.

​
Transaction statuses

Transactions can exist in different states throughout their lifecycle: Visual representation of different transaction statuses: APPLIED, INFLIGHT, VOIDED, etc.
  • APPLIED: The transaction has been completed and the balances updated.
  • INFLIGHT: The transaction is pending and held in-flight until you commit or void it.
  • VOIDED: The inflight transaction was canceled and rolled back.
  • REJECTED: The transaction was not processed, typically due to issues like insufficient funds.
  • SCHEDULED: The transaction is queued for processing at a future time.

​
View transaction details

Click a transaction to see its summary details, including the amount, currency, status, source, destination, and effective date. Transaction details summary view For a complete view, select Full info in the top-right corner of the summary or press E to expand the details. To view all transactions performed on the balance, go to the Quick Actions section at the bottom of the summary and click View transactions.
Click the Refresh button on the Transactions table to get the latest transaction data from your instance.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.