> ## 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 orders: follow, cancel and changes by Mart

> Find any order in the partner panel, read its status and earnings, learn how to cancel it, and see how a change by Mart affects what you earn.

Every order of your account is in the **Orders** tab. Its page shows the status your customer sees, what the order earns you, and every change Mart made.

## Find and read an order

1. Open the **Orders** tab.
2. Narrow the list with **From**, **To**, **Status**, **Payment** or **Search**, then select **Filter**. **Search** finds a reference, a customer name or a phone: at least 4 digits, with or without spaces or the country code.
3. Select the order's reference to open it.

Each row shows the order's reference, the one your store sent, and its **Customer** and **Phone**. On the order page:

* **The status** is the one your customer sees on mart.ps. **Status history** lists each one, with its time.
* **Changes by Mart** lists each change Mart made, with its time.
* **Your earnings on this order** shows one of these:

| State | Meaning |
| - | - |
| **To be earned** | "You earn this when the order is delivered." |
| **Being added** | Delivered; the earnings are being recorded. |
| **On hold** | Earned, available from the date shown. |
| **Earned** | The hold has ended. |
| **Reversed** | Taken back after delivery, or not earned because the order was cancelled first. |

## Cancel an order

The panel has no cancel button. The last line of the order page says how:

* "To cancel this order, contact Mart.": contact Mart through [Get help](https://docs.mart.ps/manual/get-help.md) with the reference.
* "To cancel this order, use the API cancellation endpoint or contact Mart.": cancel it from your store, or contact Mart.

Mart decides until when an order can be cancelled. Past that point, a cancellation is refused and the order stays as it is. A paused account can still cancel its orders.

What cancelling changes:

* **Before delivery:** the order earns nothing. **After delivery:** its earnings are taken back as **Commission deducted**.
* **It is not a refund.** For anything already paid or sent out, talk to Mart.
* **Only a new delivery undoes it:** the earnings come back with a new hold.

## When Mart changes an order

Mart can change an order after it is placed, for example when your customer lowers a quantity or a line is refunded. Each change is listed under **Changes by Mart**: a changed quantity, a removed or added line, a partial refund, a cancelled product, or a removed voucher. Mart never adds a voucher to your order.

* **The price of each unit never moves.** Your earnings follow the quantity that remains, at the same margin per unit.
* **The delivery fee you cover stays as it was** when the order was placed. A removed voucher changes nothing for you.
* **Before delivery,** a change moves **To be earned**. **After delivery,** it posts **Commission deducted** or **Commission restored**, and it can make your balance negative.

If a free-shipping order shrinks so that your reward no longer covers the delivery fee:

* **Before the parcel leaves the warehouse,** free shipping ends. Your customer pays the delivery fee, and you earn the full remaining reward.
* **After it has left,** your customer's charge does not change. Mart absorbs the shortfall, and your earnings on that order become zero.

## Troubleshooting

* **"No order with this reference on your account.":** check the reference. The panel shows only your own orders.
* **"This order could not be displayed. Please try again later.":** the order has no status your customer can see yet.
* **"The products of this order could not be read. Please try again later.":** try again later.

**Through the API.** `GET /api/v1/orders/{partner_reference}` answers the live order: `status` as `{id, name}` (treat `id` as opaque), live quantities and the `money` block. `POST /api/v1/orders/cancel/{partner_reference}` cancels; past Mart's limit it answers `409 order_not_cancellable`. See [Cancel an order](https://docs.mart.ps/developers/orders/cancel-an-order.md).


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