Transaction statuses

The status flows for payments, transactions, and transaction statements.

Payment statuses

Payment status	Explanation
ConsentPending	Status only occurs when consent is required for the payment Next step: Transaction flow blocked while waiting for consent; when consent is received, transaction flow resumes and payment status changes to Initiated
Initiated	Payment successfully requested; enters the transaction flow
Rejected	Payment rejected, either directly after payment initiation or from the Initiated status

Transaction statuses

There are six possible statuses for Swan transactions: Upcoming, Pending, Booked, Released, Canceled, and Rejected. Transactions directly impact account balances.

Each payment method uses a different combination of these statuses with specific flows. Refer to the schemas for credit transfers, direct debits, and cards for more information about statuses for that payment method. Not all statuses are used for all transaction types.

Transaction status	Explanation
Upcoming	Transaction was initiated and consent was granted, but the transaction isn't executed yet. Upcoming transactions don't impact the account balance.
Pending	Transaction was initiated, consent was granted, and the transaction is set to happen within a few days. The transactions aren't debited from the account yet, but they impact the account's Pending balance.
Booked	Completed transactions that are displayed on the official account statement. These transactions have been debited from the account, and they impact the account's Booked balance.
Released	Unique to card transactions, card authorizations might be released for specific reasons. Released transactions can impact the account balance. Refer to the card payments section for more information.
Canceled	An Upcoming transaction is canceled by someone with the right to do so, such as the account holder, an account member, or a merchant. Only transactions with the status Upcoming can be Canceled, and Canceled transactions don't impact the account balance.
Rejected	Declined or refused transactions. For example, the beneficiary account might be closed, or the account's Available balance isn't sufficient to complete the transaction without resulting in a negative balance.

Transaction statement statuses

Transaction statement status	Explanation
Pending	Transaction statement is being generated.
Generated	Transaction statement was generated successfully, triggering a TransactionStatement.Generated webhook notification.
Failed	The statement couldn't be generated. You can try again.
Expired	Transaction statement was generated successfully. However, it wasn't downloaded within seven days and therefore expired.