> ## 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)).

# Changelog

> Every change to the Mart Partner API, the partner panel and how money works, newest first; filter by API, Money, Orders or Panel, or follow the RSS feed.

**Payout methods**

Cash at the office

## Cash at the office; Mart may also offer bank transfer

* **Save a payout method once before your first withdrawal.** Cash at the office is pre-selected: save who collects it, you in person or someone else with an ID number. Only that collector can collect. The save locks withdrawals for a while, as every payout method change does.
* **Mart may also offer bank transfer.** The **Payout method** page shows the IBAN form only then.
* **A saved IBAN is kept but not paid to** while bank transfer is not offered: save cash to withdraw. Saving cash replaces the IBAN, which stays in your payout history.
* **API:** [`GET /payout-method`](https://docs.mart.ps/api-reference/money/get-payout-method) reports only the saved method, and `POST /withdrawals` with nothing saved answers `409 payout_method_missing`. A new error, `422 bank_transfer_not_allowed`, answers [`PUT /payout-method`](https://docs.mart.ps/api-reference/money/put-payout-method) with bank details where bank transfer is not offered, and `POST /withdrawals` on a kept IBAN until cash is saved.

See [Get paid](https://docs.mart.ps/manual/get-paid.md) and [Payout and withdrawals](https://docs.mart.ps/developers/money/payout-and-withdrawals.md).

**Version 1.1.0**

v1.1.0

## What's new in 1.1.0

**Nothing you call today changes unless you call something new.** Existing request fields, error codes, status codes, rate limits and key formats are unchanged, and unknown fields are still ignored.

### Added to existing answers

* A `money` block (`gross`, `shipping_deduction`, `net`, `earning_state`, `available_at`) on the order you create and the order you read.
* `delivery` fee brackets on every town of [`GET /states`](https://docs.mart.ps/api-reference/delivery/list-states).
* A `quote` on a valid [`POST /orders/validate`](https://docs.mart.ps/api-reference/orders/validate-order).

### New calls

| What | Where |
| - | - |
| Your orders as a list | [List orders](https://docs.mart.ps/api-reference/orders/list-orders.md) |
| Order totals over 3, 6 or 12 months | [Reports summary](https://docs.mart.ps/api-reference/reports/get-reports-summary.md) |
| Your account | [Your account](https://docs.mart.ps/api-reference/account/get-account.md) |
| Balance, movements and statements | [Balance](https://docs.mart.ps/api-reference/money/get-balance.md), [Movements](https://docs.mart.ps/api-reference/money/list-ledger.md), [Statements](https://docs.mart.ps/api-reference/money/list-statements.md) |
| Your payout method | [Read](https://docs.mart.ps/api-reference/money/get-payout-method.md), [save](https://docs.mart.ps/api-reference/money/put-payout-method.md) |
| Withdrawals | [List](https://docs.mart.ps/api-reference/money/list-withdrawals.md), [ask](https://docs.mart.ps/api-reference/money/create-withdrawal.md), [read](https://docs.mart.ps/api-reference/money/get-withdrawal.md), [cancel](https://docs.mart.ps/api-reference/money/cancel-withdrawal.md) |
| An events feed | [Events](https://docs.mart.ps/api-reference/money/list-events.md) |
| The products you are offered | [Offered product ids](https://docs.mart.ps/api-reference/products/list-product-ids.md), the `product_ids` filter, and `422 product_not_offered` |

[Balance](https://docs.mart.ps/api-reference/money/get-balance.md) also reports `pending` (what undelivered orders will earn) and `under_review`. **Earnings can be withdrawn only while their order is delivered.**

### Keys and scopes

Every endpoint names the scope a key needs; a key without it gets `403 insufficient_scope`. **Keys you already have keep exactly their access.** See [Authenticate and keys](https://docs.mart.ps/developers/authenticate.md).

### Changed behaviour

* `GET /products?product_ids=` with anything but 1 to 100 positive ids used to be ignored. It now answers `422 invalid_parameter`.
* `GET /orders` used to answer `405`. It now lists your orders.
* Money reads answer `503 ledger_unavailable` when your balance or an order's `partner_reference` cannot be read, never zeros or a `null` reference. A malformed body still gets `400 bad_request` first.
* A **closed** account's key can read your money and ask to withdraw, where it used to get `403`. It cannot change the payout method or place orders.
* A new order can be missing from `GET /reports/summary` for a short time, until it is recorded.
* Some new reads have their own rate limit. Existing limits are unchanged.

The partner panel on mart.ps can show the same money, once Mart turns it on for your account.


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