Transactions represent financial events that impact the balance of a line of credit or loan, such as draws, repayments, fees, or adjustments.

Each transaction has distinct statuses that Canopy uses to track and launch automated workflows on behalf of the lender. Transactions can also carry metadata, such as currency information, links to payment processors, or custom tags, providing lenders and borrowers with detailed context and traceability.

In our system, transactions are meticulously ledgered, ensuring accurate tracking of financial activity and supporting transparency, reconciliation, and reporting for all parties involved.

Transaction Statuses

Below represents the unique, top level status a transaction can have. Some transactions may have all four specified, while other transactions may only have a few. In which case their sub-status for the respective high level status would be null

Value	Description
SETTLEMENT	Indicates the transaction's progression through financial processing.
POURING	Tracks how payments and similar transactions are distributed across other balance-bearing transactions (e.g., how a payment is allocated between ("poured into") principal and interest).
REVERSAL	Documents if the transaction has been or is currently in the process of being reversed.
DISPUTE	Captures any challenges or resolutions related to the transaction.

Transaction Status Subtypes

Each of the above transaction_statuses can carry more granular sub-status information, a transaction with a DISPUTE status could be in a DISPUTED or LENDER_LOST sub-status. This fine-grained control allows for optimal understanding of ledger transactions and can be combined with Notifications or Canopy Connect to provide custom workflows based on sub-status transitions.

SETTLEMENT SUB-STATUSES

Value	Description
PENDING	The transaction is in the process of being finalized or settled.
DECLINED	The transaction failed to settle due to insufficient funds, errors, or other issues.
SETTLED	The transaction has been successfully processed and finalized.

POURING SUB-STATUSES

Value	Description
PENDING	The transaction is waiting to be poured (allocated) across balance-bearing transactions (e.g., principal, interest).
POURED	The transaction has been successfully poured to the appropriate balance-bearing transactions.
REPOURED	The transaction has been repoured (reallocated), typically due to adjustments or corrections.
UNPOURED	The transaction's pouring (allocation) has been undone or reversed, resetting its impact on balances. Note: This is a transitory state and will not be shown in Canopy's ledger

REVERSAL SUB-STATUSES

Value	Description
NONE	No reversal action has been initiated for the transaction.
PENDING	The transaction is in the process of being reversed.
FAILED	The reversal attempt was unsuccessful.
REVERSED	The transaction has been successfully reversed, undoing its financial impact.
VALID	The reversal has been confirmed and is considered valid.

DISPUTE SUB-STATUSES

Value	Description
NONE	No dispute has been raised regarding the transaction.
DISPUTED	The transaction is under review due to a challenge or claim.
REFUNDED	The disputed amount has been refunded to the borrower.
LENDER_WON	The dispute has been resolved in favor of the lender, and the transaction stands as originally processed.
LENDER_LOST	The dispute has been resolved in favor of the borrower, resulting in adjustments or reversals.