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. |