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

# How you earn on each order

> What each order earns you, which prices you may sell at, how card orders and free shipping work, and what a refused parcel can cost your account.

On a cash-on-delivery order you earn your selling price minus your cost price, on every unit, less the delivery fee if you offer free shipping. No other fee is taken from an order.

* **Your selling price** is what your customer pays per unit, tax included. The panel shows it as **Your price**.
* **Your cost price** is what one unit costs you, tax included, set by Mart. The panel shows it as **Group price**.

## A worked example

The numbers are an illustration, not Mart's prices: 2 units at 120.00, a cost price of 100.00, and a delivery fee of 35.00 for this town.

| | Customer pays delivery | Free shipping |
| - | - | - |
| Reward on the products: (120.00 − 100.00) × 2 | 40.00 | 40.00 |
| Delivery fee you cover | 0.00 | 35.00 |
| **Your net earnings** | **40.00** | **5.00** |
| The courier collects | 275.00 | 240.00 |

## Which prices can you sell at?

Mart checks every line when the order is created. One failed line refuses the whole order, and nothing is created.

* **At or over your cost price:** accepted. Exactly equal passes.
* **Under your cost price:** refused.
* **No price sent:** the line sells at your cost price and earns nothing.
* **Only your cost price:** if Mart turns off custom prices for your account, any other price is refused.

The cost price that counts is the one when the order is created, not the one you saw earlier. Keep a margin, so a price change costs you margin instead of refusing the order.

## How does a card order work?

Mart charges your own saved card the cost price plus the delivery fee, and the courier collects nothing. You collect your margin from your customer yourself, so a card order earns nothing in your Mart balance. A card order needs a saved card and card payment turned on by Mart. It takes no price of yours and cannot have free shipping.

Your card is on the **Payments** tab.

## How does free shipping work?

Your customer pays for the products only, and the delivery fee comes out of your earnings on that order.

* Mart accepts it only when your reward on the products covers the fee. Net earnings of exactly zero pass.
* The fee depends on the destination and the products total, so changing your prices can change it.
* It works on cash-on-delivery orders only, and only while Mart allows free shipping for your account.
* Refused for not covering the fee? Raise your prices, or send the order without free shipping.

The panel marks the order **Free delivery**, shows **Paid by you** beside its **Delivery fee**, and deducts the line **Delivery fee you cover (free delivery)**.

## What stays fixed after the order is placed?

* **The margin on each unit.** Mart never re-prices an order against a later catalogue.
* **The delivery fee you cover,** as it stood when the order was placed.
* **Your earnings follow the quantity that remains.** A refund, a return or a removed line lowers them. [When Mart changes an order](https://docs.mart.ps/manual/your-orders.md#when-mart-changes-an-order) explains each change.

## What does a refused parcel cost?

Mart can charge your account when your customer refuses a parcel that had already left the warehouse. Whether you pay, and how much, are set by Mart, and the terms in force when the order was placed apply. Ask Mart for yours.

* The amount is a fixed sum, the order's delivery fee, or a percentage of the goods at your selling prices.
* An order is charged at most once. If Mart undoes a charge, the undo is final.
* The charge counts at once, stays if the parcel is delivered later, and can make your balance negative.

It appears on **Movements** as **Refused parcel charge**.

## Where do you see what an order earns?

Open the order from the **Orders** tab. **Your earnings on this order** shows **Reward on the products**, any **Delivery fee you cover (free delivery)**, and **Your net earnings**. The **Products** table shows **Your price**, **Group price** and **Your reward** per line.

**Through the API.** Send `products[].price` on `POST /api/v1/orders`, or omit it to sell at `price.group_price`. Refusals: `422 price_below_minimum`, `422 price_override_not_allowed`, `422 card_price_not_allowed`, `422 free_shipping_not_covered`, `422 free_shipping_not_allowed` and `422 card_free_shipping_not_allowed`. `POST /api/v1/orders/validate` returns `data.validation.quote.reward` without creating anything. See [Create an order safely](https://docs.mart.ps/developers/orders/create-an-order.md).


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