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

# Get started as a Mart partner

> See how a Mart order becomes money in four steps, then open the partner panel, follow your first order and get paid in your first days as a partner.

You sell Mart products to your own customers at your own prices. Mart delivers each order, collects cash on delivery, and pays you what the order earns.

## How does an order become money?

```mermaid theme={null}
flowchart LR
    A[Order placed] -->|Delivered| B[On hold]
    A -->|Cancelled before delivery| X[Nothing earned]
    B -->|Hold ends| C[Available to withdraw]
    B -->|Hold ends during a ticket or exchange| R[Under review]
    R -->|Delivered again| C
    B -->|Whole order cancelled| T[Taken back]
    C -->|Whole order cancelled| T
    C -->|You withdraw| D[Paid to you]
```

1. **Placed.** Your store sends the order to Mart. What it will earn shows as **To be earned**.
2. **Delivered.** The earnings join your balance, **On hold**.
3. **Hold ends.** The earnings become **Available to withdraw**, as long as the order is still delivered.
4. **You withdraw.** Mart pays you in cash at the office, or by bank transfer where Mart offers it.

Orders reach Mart only through the Mart Partner API, sent by your store or whoever runs its ordering. The partner panel shows your orders but does not place them.

## Your first days

1. **Open the panel.** Sign in on mart.ps, open **My account**, then select **Partner panel**. If it says "This account is not a partner account. To become a partner, contact Mart.", ask Mart to set up your account.
2. **Read the Overview.** **Your money** shows **To be earned**, **On hold**, **Available to withdraw**, **Requested** and **Paid to you**. **Needs your attention** lists anything to act on.
3. **Save your payout method early.** Open **Balance**, then **Payout method**. Cash at the office is pre-selected: save who collects it, you in person or someone else. Mart may also offer bank transfer. The save is needed before your first withdrawal and locks withdrawals for a while.
4. **Follow your first order.** Open **Orders** and select the order's reference. **Your earnings on this order** shows **To be earned** until delivery, then **On hold** with its **Available from** date.
5. **Withdraw.** When **Available to withdraw** reaches your **Minimum amount**, select **Withdraw**, enter the **Amount** and select **Request withdrawal**.

If you do not see the **Balance** tab, Mart has not turned on money pages for your account yet.

## Where next

* [How you earn](https://docs.mart.ps/manual/how-you-earn.md): what each order earns, and the prices you may sell at.
* [Your money](https://docs.mart.ps/manual/your-money.md): every figure in your balance.
* [Get paid](https://docs.mart.ps/manual/get-paid.md): payout methods and withdrawals.

**Through the API.** `GET /api/v1/account` says what the account may do (`orders_enabled`, `price_override_allowed`, `free_shipping_allowed`, `withdrawals`). Follow an order with `GET /api/v1/orders/{partner_reference}` (`money.earning_state`: `pending`, `held`, `available` or `reversed`). See [Quickstart](https://docs.mart.ps/developers/quickstart.md).


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