> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bloobank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel payment order

Cancels an outbound payment order awaiting approval. Transitions `status` from `AWAITING_APPROVAL` to `CANCELED` **without** submitting it to the provider — no money moves.

## Preconditions

| Condition                             | Failure                                   |
| ------------------------------------- | ----------------------------------------- |
| Order must be `direction: OUT`.       | `PAYMENT_ORDER_INVALID_STATE` (HTTP 422). |
| Order must be in `AWAITING_APPROVAL`. | `PAYMENT_ORDER_INVALID_STATE` (HTTP 422). |

<Note>
  **Cancel is only valid before approval.** Once an order moves to `PENDING` (after [approve](/api-reference/payment-orders/approve)), it cannot be canceled — it will run to completion on the provider's timeline. To reverse a successful payment, you need a separate refund flow, not a cancel.
</Note>

## Effect

* `status` → `CANCELED` (terminal)
* `locked` on the wallet is unchanged (the order never reserved funds — reservation happens at `approve`)
* The order is never submitted to the provider

The `CANCELED` state is **terminal**. Once an order is canceled, it cannot be revived; if you need to re-attempt the operation, create a new order with a different `idempotencyKey`.