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

> ## Agent Instructions
> These rules protect a Mart partner's money. Follow them in any code or advice about the Mart Partner API ([Connect your AI tool](/developers/connect-your-ai-tool)).
> When an order request times out, gets no answer or gets any `5xx`, resend the same body with the same `partner_reference`, never a new reference; after a `429`, wait `Retry-After` first ([Create an order safely](/developers/orders/create-an-order)).
> A `200` with `meta.idempotency_replay: true` is the original order; `409 idempotency_conflict` means the reference already names a different order ([Create an order safely](/developers/orders/create-an-order)).
> Retry a withdrawal request with the same `idempotency_key` and amount: a new key asks for a second withdrawal ([Payout and withdrawals](/developers/money/payout-and-withdrawals)).
> Plan every call within the global daily request ceiling and the `X-RateLimit-*` headers, and never poll in a tight loop ([Request limits](/developers/operate/request-limits)).
> Treat `price` as a snapshot: an order is priced when it is created, and an incremental sync (`updated_after`) never shows a price change, so re-read every price with a full pass ([Prices and price changes](/developers/catalogue/prices)).
> Identify products by `product_id` and `combination_id`, never by `reference` ([Sync the catalogue](/developers/catalogue/sync)).
> Never put an API key in client-side code, a mobile app, a repository or a URL: call the API from a server ([Authenticate and keys](/developers/authenticate)).
> Money is in shekels (`ILS`), as JSON numbers, never agorot. Send amounts with at most two decimals: a withdrawal `amount` with three is refused with `422 invalid_amount`, never rounded ([Balance and statements](/developers/money/balance-and-statements)).
> Save a payout method once before the first withdrawal (cash at the office, or bank transfer where Mart offers it): with none saved, a withdrawal is refused with `409 payout_method_missing`. Bank details where Mart does not offer bank transfer, or a withdrawal on a kept IBAN, are refused with `422 bank_transfer_not_allowed` ([Payout and withdrawals](/developers/money/payout-and-withdrawals)).

# Your money: balance, holds, movements and statements

> Understand every figure on the Balance tab, when earnings become money you can withdraw, why your balance changed, and how to read a statement.

Only **Available to withdraw** can be withdrawn. Every other figure is money on its way, money held back, or money already paid. Each order moves through the states on its own.

## What does each figure mean?

| Figure | What it is | Withdrawable? |
| - | - | - |
| **To be earned** | What orders not delivered yet will earn. Not money yet, and not in your balance or statements. | No |
| **On hold** | Earned on delivered orders, kept until the hold ends. **Next release** shows the next amount and date. | No |
| **On hold: order under review** | The hold has ended, but the order is not delivered right now, for example during a ticket or an exchange. | Not until it is delivered again |
| **Available to withdraw** | Earnings whose hold has ended, after charges, corrections and payments, less money under review and your open requests. Never negative: if your account owes money, new earnings first cover the debt, shown as **To be recovered from future earnings**. | Yes |
| **Requested** | Your open withdrawal requests, each held back until it is paid, rejected or cancelled. | Already asked for |
| **Paid to you** | Every payment Mart has made to you. | Already paid |

Your **Balance** is the sum of every movement, held earnings included. The figures each have their own meaning and do not add up to it.

A figure the panel could not read shows a dash, never zero. Try again later.

## When does an order's money become available?

When the order is delivered, its earnings go on hold for a period set by Mart. Their **Available from** date is fixed at delivery and shown on the order page and on **Movements**. Each order keeps the hold length in force when it was placed: a later change never moves an existing date.

After that date the money is available while the order stays delivered. A charge, a payment or a correction always counts at once, whatever its order's state.

## What takes earnings back?

* **The whole order is cancelled after delivery:** its earnings are taken back as **Commission deducted**.
* **Products are returned or refunded, or Mart removes part of the order:** earnings drop by what those products earned.
* **A cancelled order is delivered again:** its earnings come back with a new hold.
* **The order is cancelled before delivery:** it earns nothing.

A ticket or an exchange never takes earnings back. It only holds them under review.

## Why did your balance change?

Every change comes from one movement. Open **Balance**, then **Movements**: each row has its **Date**, its **Order** when it has one, its **Status** and a signed **Amount**.

| Movement | Why | Balance |
| - | - | - |
| **Order commission** | An order was delivered. | Up |
| **Commission deducted** | The order was cancelled, returned or partly refunded. | Down |
| **Commission restored** | The order was delivered again, or corrected in your favour. | Up |
| **Payment to you** | Mart paid you, in cash, by bank transfer or directly. | Down |
| **Adjustment due** / **Adjustment in your favour** | A correction by Mart. | Down / Up |
| **Refused parcel charge** / **Refused parcel charge undone** | See [refused parcels](https://docs.mart.ps/manual/how-you-earn.md#what-does-a-refused-parcel-cost). | Down / Up |
| **Commission movement** | Any other movement. | By its sign |

A payment lowers your balance because the money has reached you.

## How do you read a statement?

A statement is the closed record of one period: your **Opening** balance, every movement recorded in the period, and your **Closing** balance. Open **Balance**, then **Statements**, and select **Statement #** and its number.

* **Closing** equals **Opening** plus the period's movements, and each **Opening** equals the previous statement's **Closing**.
* Both include held earnings, so neither is an amount Mart owes you on that date.
* A movement belongs to the period it was recorded in. A closed statement never changes: a later correction appears in a later statement.
* Statements are records of your account, not tax documents.

## Troubleshooting

* **No Balance tab:** Mart has not turned on money pages for your account yet.
* **"Balance and withdrawals are not available right now. Please try again later.":** your money is untouched. Try again later.
* **"The total appears once Mart has checked an order." under To be earned:** Mart is checking one of your orders. The panel shows a total only when it is exact.

**Through the API** (scope `money:read`). `GET /api/v1/balance` answers `balance`, `available`, `held`, `next_maturity`, `under_review`, `owed`, `pending` and `pending_state`: show each with its own meaning. `GET /api/v1/ledger` lists movements (`type`: `earning`, `reversal`, `payment`, `adjustment`, `charge`). `GET /api/v1/statements` lists statements. See [Balance and statements](https://docs.mart.ps/developers/money/balance-and-statements.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.