Statuses, Messages, Webhook Events

Overview

This guide provides an overview of Ledger Transaction statuses, which reflect the state and progression of financial entries within the ledger system. It outlines key status types—pending, posted, and archived—each impacting how balances are computed and reported. Whether you're tracking transaction lifecycle, reconciling balances, or managing account flows, understanding these statuses is essential for accurate ledger operations.

Use this guide alongside the Ledger Account documentation to ensure reliable and consistent financial data handling.

Statuses

Ledger Transactions include a status field that indicates whether a transaction is pending, posted, or archived, reflecting its current state in the ledger.

Correspondingly, Ledger Accounts expose multiple balance types—pending_balance, posted_balance, and available_balance—which update based on the status of transactions written to them.

These fields help ensure accurate, real-time visibility into funds at various stages of processing.

StatusMeaning
PendingThe transaction has been initiated but not yet finalized; it may still be canceled or modified.
PostedThe transaction has been completed and reflected in the ledger or bank account; it is now immutable.
ArchivedThe record is no longer active but retained for historical or reference purposes; it cannot be acted upon.