> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://doc.cheddar.biz/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://doc.cheddar.biz/_mcp/server.

# Transaction statuses

Every deposit and withdrawal Cheddar records carries a `status`. This page lists
them, explains confirmation tiers, and gives the expected time per chain.

## Statuses

| Status                  | Meaning                                                                                                     | Funds                                                                   |
| ----------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `PENDING`               | Recorded, not yet sent or not yet seen on chain.                                                            | Withdrawals: reserved.                                                  |
| `AWAITING_CONFIRMATION` | A withdrawal held for approval, or sent and waiting to land in a block.                                     | Reserved.                                                               |
| `PREFUNDING`            | A withdrawal waiting for Cheddar to fund the sending wallet before it is sent.                              | Reserved.                                                               |
| `PROCESSING`            | In a block, but not yet at its confirmation target (see below).                                             | **Not spendable.** Shown as pending. Withdrawals stay reserved.         |
| `CONFIRMED`             | Reached its confirmation target. Final.                                                                     | Deposits: spendable.                                                    |
| `FAILED`                | The transaction did not complete, or left the chain (see [Reorgs](#reorgs-and-failed-transactions)). Final. | Withdrawals: the reserved amount is released. Deposits: never credited. |
| `REJECTED`              | A withdrawal an approver rejected, before it was sent. Final.                                               | Released.                                                               |
| `FLAGGED`               | A deposit held for risk review. See [Deposits](/guides/deposits).                                           | Not spendable until approved.                                           |

> **Note**
>
> `PROCESSING` funds are never part of the spendable or withdrawable balance. They
> appear only in the pending figure until the transaction confirms.

## Confirmation tiers

On Ethereum, BSC, Polygon, Robinhood Chain, Tron and Solana, Cheddar holds a
transaction in `PROCESSING` from the block that includes it until it reaches a
**confirmation target**. The target depends on the chain and on the
transaction's USD value when Cheddar first sees it:

| Tier     | Default USD band                         |
| -------- | ---------------------------------------- |
| `LOW`    | under \$1,000                            |
| `MEDIUM` | $1,000 – $10,000                         |
| `HIGH`   | over \$10,000, or no USD price available |

The tier is frozen at first sighting; later price moves don't change it. A
target is a number of blocks on top of the including block, or the chain's
**finalized** block (Solana: the `confirmed` or `finalized` commitment).

> **Info**
>
> Confirmation targets are switched on per chain. Until a chain is switched on,
> its transactions confirm as soon as they land in a block, as before. Cheddar
> announces each switch at least two weeks ahead.

## Default targets and expected time

Times are typical; a congested or slow chain takes longer.

| Chain           | `LOW`               | `MEDIUM`              | `HIGH`                                |
| --------------- | ------------------- | --------------------- | ------------------------------------- |
| Ethereum        | 3 blocks (\~36 s)   | 12 blocks (\~2.5 min) | finalized (\~13 min)                  |
| BSC             | 5 blocks (\~2 s)    | 15 blocks (\~7 s)     | finalized (\~2 s after fast finality) |
| Polygon         | 5 blocks (\~10 s)   | 16 blocks (\~32 s)    | finalized (\~10 s)                    |
| Robinhood Chain | 1 block (\<1 s)     | 10 blocks (\~1 s)     | finalized on Ethereum L1 (\~30 min)   |
| Tron            | 6 blocks (\~18 s)   | 19 blocks (\~1 min)   | solidified (\~1 min)                  |
| Solana          | `confirmed` (\~1 s) | `finalized` (\~15 s)  | `finalized` (\~15 s)                  |

Average block times used above: Ethereum 12 s, BSC 0.45 s, Polygon 2 s,
Robinhood Chain 0.1 s, Tron 3 s.

## Reorgs and failed transactions

While a transaction is `PROCESSING`, Cheddar re-checks it against the chain:

* **Moved to another block** (a reorg re-included it): the count restarts from
  the new block. The status stays `PROCESSING`.
* **Result changed** (the transaction now shows as failed or reverted): it moves
  to `FAILED` at once.
* **Gone from the chain** for more than 10 minutes: it moves to `FAILED`
  (reorged out).

A deposit that fails this way is never credited. A withdrawal that fails
releases its reserved amount; you can retry it.

## Related

* [Deposits](/guides/deposits) and [Withdrawals & approvals](/guides/withdrawals)
* Webhooks: [custodial events](/webhooks/custodial), [checkout events](/webhooks/checkout)