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

# Programme rules at a glance

> The rules of the Mart partner programme that decide what you earn and when you are paid, on one page, each linked to the page that explains it.

The rules that decide your money. Values such as the hold period and the minimum withdrawal are set by Mart; the linked pages say where you see yours.

1. Your selling price must be at least your cost price when the order is created. A line with no price sells at cost and earns nothing. [How you earn](https://docs.mart.ps/manual/how-you-earn.md)
2. Net earnings are your selling price minus your cost price, times the quantity, less any delivery fee you cover. No other fee is taken, and free shipping is accepted only when the reward covers the fee.
3. A card order is charged to your saved card at cost price plus delivery, and earns nothing in your Mart balance.
4. An order earns only when it is delivered. Its earnings wait on hold, then are available only while the order stays delivered. [Your money](https://docs.mart.ps/manual/your-money.md)
5. Cancelling after delivery takes the earnings back, and returns or refunds lower them. Only a new delivery brings them back.
6. A refused parcel can be charged at most once, on the terms in force when the order was placed.
7. **Available to withdraw** is never negative. A debt is recovered from future earnings.
8. Save a payout method once before your first withdrawal: cash at the office, paid only to the collector you save, or bank transfer where Mart offers it. Each save that changes who is paid locks withdrawals for a while. [Get paid](https://docs.mart.ps/manual/get-paid.md)
9. A withdrawal request is checked in a fixed order, holds its amount while open, and can be cancelled only while **Requested**. [Why a withdrawal is refused](https://docs.mart.ps/manual/why-a-withdrawal-can-be-refused.md)

**Through the API.** The same rules apply to every call. `GET /api/v1/account` answers what the account allows: `price_override_allowed`, `free_shipping_allowed`, `card_enabled`, `orders_enabled` and `withdrawals`. Branch on `error.code`. See [Handle errors](https://docs.mart.ps/developers/operate/handle-errors.md).


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