About transaction statuses

Learn about the different statuses that a transaction can have, depending on its order type.

info

For card transactions, the final outcome is described by a response code rather than a status. See About transaction response codes for the full list of card transaction response codes.

Card transaction statuses

Diagram showing the different statuses that a card transaction can have

Status	Description
`pending`	A transaction that hasn't been fully processed yet. This includes card payments and any order (exchange, payment, deposit) that has been debited from a budget but has not yet fully completed.
`complete`	A transaction that has successfully been completed. This includes all completed types of orders and currency balance credits/debits. For example, a card transaction that has been fully processed by a merchant. This is a final status.
`cardCheck`	A merchant-initiated check on a card, to ensure they've got the correct details and that the card is active. Once they've completed their check, the status will change to `pending` if successful or `declined` if unsuccessful.
`declined`	A transaction that has been declined. This is a final status.
`reverted`	A card transaction that has been cancelled before it was fully processed. This is a final status.
`refunded`	A card transaction that has been refunded. This is a final status.

Payment statuses

Diagram showing the different statuses that a payment can have

Status	Description
`pending`	A payment order that has been debited from a budget but has not yet been fully completed.
`complete`	A payment that has been successfully completed and settled. This is a final status.
`cancelled`	A payment order that has been cancelled. This is a final status.

Forward contract statuses

Diagram showing the different statuses that a forward contract can have

Status	Description
`pending`	A forward contract order that has been submitted but has not yet been fully settled.
`complete`	A forward contract that has been fully settled. This is a final status.
`open`	A forward contract which has been booked and had its deposit paid. Once it has been fully paid, the status will change to `complete`.

Other statuses

The following statuses may also appear when filtering transactions using the List transaction activity endpoint.

Status	Description
`needsApproval`	An order that requires approval before it can be processed.
`fundsRequired`	An order that is awaiting the required funds before it can be completed.
`fundsSettled`	An order where the funds have been settled.