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

# Why a withdrawal is refused, and what to do

> Look up each reason the panel refuses or Mart rejects a withdrawal request, the exact message you see, and what to change before you ask again.

The panel checks your request in a fixed order and shows the first rule that fails. A refused request records nothing. In the messages, … stands for the amount the panel shows.

## When no request can be made

The **Withdrawals** page shows the reason in place of the form.

| # | What the panel says | What to do |
| - | - | - |
| 1 | "Withdrawals are not enabled for your account. Please contact Mart." | Your partner account is closed: ask Mart about any remaining balance. |
| 2 | "Changes are not available for your account right now. Please contact Mart." | Your API access is paused or revoked: ask Mart. |
| 3 | "Withdrawals are not enabled for your account. Please contact Mart." | Mart has not turned on withdrawals for you: ask Mart. |
| 4 | "No payout method is saved yet. Save one to withdraw your earnings." | [Save one](https://docs.mart.ps/manual/get-paid.md#choose-how-you-are-paid), or select **Save cash at the office** here to save cash collected by you in person. |
| 5 | "Withdrawals are locked until … because your payout method changed." | Wait until that date. |
| 6 | "Bank transfer is not offered to your account for now. Save cash at the office as your payout method to withdraw." Without cash either: "Neither a bank transfer nor cash at the office is offered to your account right now. Please contact Mart." | Save cash at the office, here in one click or on **Payout method**. Otherwise ask Mart. |
| 7 | "Cash pickup is no longer available; choose bank transfer" Without bank transfer either: "Cash at the office is not available for your account right now. Please contact Mart." | Save a bank account, or ask Mart. |
| 8 | "One cash payout is at most …, less than the minimum withdrawal. Choose bank transfer to withdraw." | Switch to bank transfer if Mart offers it (the switch locks withdrawals for a while), or ask Mart. |
| 9 | "You can withdraw once at least … is available." | Wait until your minimum is available. |
| 10 | "You have too many open withdrawal requests. Wait for one to be paid or cancel one." | Wait, or cancel a request. |
| 11 | "Nothing is available to withdraw yet. Earnings become available when their hold ends." | Wait: see [Your money](https://docs.mart.ps/manual/your-money.md). |

The minimum, the most open requests and the most paid in cash at once are set by Mart. The form shows your **Minimum amount**.

## When your amount breaks a rule

The form keeps your amount and says:

| What the panel says | What to do |
| - | - |
| "The amount is above the maximum for one cash payout (…)." | Ask for that or less, or switch to bank transfer. |
| "The amount is below the minimum (…)." | Ask for at least the minimum. |
| "The amount is above what is available (…)." | Ask for no more than **Available to withdraw**. |
| "Enter an amount greater than zero with at most two decimals." | Mart never rounds an amount for you. |
| "This form was already submitted with a different amount. Reload the page to start a new request." | Reload and enter the amount again. |
| "Your account is busy. Try again in a moment." | Send it again in a moment. |

## When Mart rejects a request later

Mart reviews each request. A rejected request shows **Rejected** with Mart's reason, and its amount is available again. Mart approves only when your payout method's lock has ended and enough is available; if an order goes under review or a charge is posted after you asked, the request waits.

If your API key is paused or revoked, the whole panel may instead say "This account is not a partner account. To become a partner, contact Mart." See [Get help](https://docs.mart.ps/manual/get-help.md).

**Through the API.** `POST /api/v1/withdrawals` refuses in this order: `403 withdrawals_disabled`, `409 payout_method_missing` (nothing saved), `409 withdrawals_locked`, `422 bank_transfer_not_allowed`, `403 cash_not_allowed`, `422 amount_above_cash_maximum`, `422 amount_below_minimum`, `409 too_many_open_withdrawals`, `409 insufficient_available`. A repeat of an earlier request is answered first. 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.