> ## 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 paid: payout method and withdrawals

> Choose how Mart pays you, request a withdrawal of the money available to you, follow it until it is paid, collect cash at the office, or cancel a request.

Save a payout method once, before your first withdrawal: cash at the office, or bank transfer where Mart offers it. Then ask to withdraw money that is **Available to withdraw**. Mart reviews each request before paying it, so a request pays nothing until it shows **Paid**. Everything here is under the **Balance** tab.

## Choose how you are paid

Open **Balance**, then **Payout method**. With nothing saved, a request is refused with "No payout method is saved yet. Save one to withdraw your earnings."

* **Cash at the office** is pre-selected. Under **Who collects the cash?**, choose **You, in person** or **Someone else**, with the **Full name of the collector** and the **ID number of the collector**, then select **Save**. Only the collector saved here can collect; renaming your account changes nothing. The **Withdrawals** page also offers a one-click **Save cash at the office** for you in person.
* **Bank transfer (IBAN):** Mart may also offer it, and the IBAN form appears only then. Enter the **IBAN**, the **Account holder** and, if you want, the **National ID (optional)**, then select **Save**. You may type the IBAN with spaces or in lower case. Mart checks its country, length and check digits, and accepts only the countries it has enabled for you.
* **If Mart stops offering bank transfer,** your IBAN is kept but not used, and you save cash to withdraw: "Bank transfer is not offered to your account for now. Your IBAN is kept but not used: save cash at the office below to withdraw." Saving cash replaces the IBAN, which stays in your payout history.

Cash is offered once Mart has published **Where and when to collect**. If Mart offers you neither cash nor bank transfer, the page says "No payout method is offered to your account right now. Please contact Mart."

Every save that changes who is paid locks withdrawals for a number of hours set by Mart: your first save, cash included, a new IBAN, a switch between bank and cash, and a new collector or collector ID number. So save early. The page shows "Withdrawals are locked until" and when the lock ends.

A new holder name or national ID for the same IBAN, or the same details again, does not lock; a second change never shortens a running lock; and a switch between bank and cash never carries the ID number over.

If the page says "Withdrawals are not enabled for your account.", Mart has not turned on withdrawals for you.

## Request a withdrawal

1. Open **Balance**, then **Withdrawals**, or select **Withdraw** next to **Available to withdraw**.
2. Enter the **Amount**: more than zero, at most two decimals, at least your **Minimum amount**, and no more than **Available to withdraw**.
3. Select **Request withdrawal**. The page confirms "Your withdrawal request was received."

Sending the form twice never makes two requests. When a request cannot be made now, the page says why in place of the form: see [Why a withdrawal is refused](https://docs.mart.ps/manual/why-a-withdrawal-can-be-refused.md).

## Follow your request

Each request is listed under **Your requests**, with its **Dates** (requested, then each later step), **Amount**, **Paid by** and **Status**.

| Status | Meaning |
| - | - |
| **Requested** | Mart has it, and its amount is held back. You can still cancel it. |
| **Approved** | Bank transfer only: Mart checked it and is paying it. Its IBAN is fixed from now on. |
| **Paid** | Sent to your bank account, or handed over at the office. Cash goes from **Requested** straight to **Paid**. |
| **Rejected** | Mart refused it; the reason shows under the status. The amount is available again. |
| **Cancelled** | You cancelled it. |

## Collect cash at the office

After you request, **Paid by** shows **Collect at the office**, and the collector brings an ID card during the published hours: Mart checks it against the collector you saved. At the counter you may ask for a different amount, within **Available to withdraw** plus what this request holds and any most Mart pays in cash at once; Mart records the payment, then hands over the cash, and **Amount** shows what was paid beside what you asked.

Mart hands over nothing if the request is no longer **Requested**, the collector changed after you asked or its lock has not ended, or the amount is over what is allowed. If Mart stops offering cash, a cash request you already made can still be collected.

## Cancel a request

While it is **Requested**, select **Cancel** under **Your requests** and confirm "Cancel this withdrawal request?". Its amount is available again at once. Any other request says "That withdrawal can no longer be cancelled."

## Troubleshooting

* **"The IBAN is not valid.":** check the country, the length and every digit.
* **"Enter the ID number of the collector.":** someone else who collects needs an ID number.
* **"Cash at the office is not available for your account. Choose a bank transfer.":** Mart does not offer you cash. Without bank transfer either, the message ends "Please contact Mart."
* **"Bank transfer is not offered to your account for now. Save cash at the office as your payout method.":** Mart does not offer you bank transfer.
* **"You cannot switch between bank transfer and cash while a withdrawal request is open. Cancel it first, or wait until it is paid.":** cancel the open request, or wait.
* **"Your account is busy. Try again in a moment.":** another change is in progress; send it again.

**Through the API.** `GET /api/v1/payout-method` and `PUT /api/v1/payout-method` (scope `iban:write`) read and save the payout method under the same lock rules. `POST /api/v1/withdrawals` (scope `withdrawals:write`) takes `{amount, idempotency_key}`; the same key and amount again return the original request, never a second. See [Payout method and withdrawals](https://docs.mart.ps/developers/money/payout-and-withdrawals.md).


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