Transaction Statuses

A description of the transaction statuses in the Canopy system, and whether they represent a final state or control certain functionality.

This is a description of the transaction statuses in the Canopy system and what they mean in terms of how they control functionality.

πŸ“˜

Line Item Statuses

Line Item Statuses and Transaction Statuses are equivalent in semantics and application in the system.

Transaction Status

Description

Final State?

VALID

A status used to indicate that the transaction's balance has been finalized and posted to the account. An example would be a charge against an an account that had been authorized then posted. PAYMENT transactions in this status typically initiate a transfer of funds.

Yes

INVALID

A final status used to indicate that a transaction's balance should not be applied to the account.

Yes

OFFSET
(Deprecated)

An offset transaction is functionally equivalent to an invalid transaction.

Yes

PENDING

A status used to indicate a transactions which has been initiated, but not yet completed.PAYMENT transactions in this status should not initiate a transfer of funds.

No

AUTHORIZED

A status used to indicate a pending CHARGE transaction, for which the transaction balance has not yet been posted to the account.

No

DECLINED

A final status used for PAYMENT transactions that signifies there is insufficient balance in the third party account to cover the transaction amount.

Yes

POSTED
(Deprecated)

Deprecated

β€”

VOID

A final status used to indicate that a transaction has been cancelled by the merchant.

Yes

REVERSED

A final status used to indicate that a transaction previously in a PENDING status has been retroactively reversed. It should be noted that PAYMENT transactions marked with this status had never initiated a transfer of funds.

Yes

RETRO_VALID

A final status used internally by Canopy to indicate a parent transaction created in retroactive processing: such a transaction will have child transactions in VALID status.

Yes

SPLIT VALID

A status used internally by Canopy to indicate a PAYMENT_SPLIT transaction has had its balance applied against the corresponding fee, interest, or principal transaction. See Payment Split

Yes


What’s Next