Cheque lifecycle

A cheque progresses through two phases:

  • Transaction – where the cheque is issued and dispatched, following the standard transaction lifecycle
    For more information, see Transaction lifecycle.
  • Cheque – where the cheque is either cashed or voided

As the cheque progresses through these phases, its status updates until it reaches a terminal state.

Checking the current cheque status using the API

Send:

GET /transactionRequests/{id}

To check the current status of a cheque, retrieve the transaction request using its ID.

For more information, see Retrieve a transaction.

You can also monitor cheque status updates using webhook notifications.

For more information, see Webhooks.

Cheque statuses

After a cheque is successfully issued as a transaction (with a Succeeded status), it enters the cheque-specific phase of the lifecycle.

StatusDescription
UncashedThe cheque is issued but the recipient has not yet cashed it.
CashedA terminal state. The cheque is successfully cashed and payment received.
VoidedA terminal state. The cheque was not cashed and was voided because it expired or was cancelled.