Cash at the office; Mart may also offer bank transfer
- Save a payout method once before your first withdrawal. Cash at the office is pre-selected: save who collects it, you in person or someone else with an ID number. Only that collector can collect. The save locks withdrawals for a while, as every payout method change does.
- Mart may also offer bank transfer. The Payout method page shows the IBAN form only then.
- A saved IBAN is kept but not paid to while bank transfer is not offered: save cash to withdraw. Saving cash replaces the IBAN, which stays in your payout history.
- API:
GET /payout-methodreports only the saved method, andPOST /withdrawalswith nothing saved answers409 payout_method_missing. A new error,422 bank_transfer_not_allowed, answersPUT /payout-methodwith bank details where bank transfer is not offered, andPOST /withdrawalson a kept IBAN until cash is saved.
What’s new in 1.1.0
Nothing you call today changes unless you call something new. Existing request fields, error codes, status codes, rate limits and key formats are unchanged, and unknown fields are still ignored.Added to existing answers
- A
moneyblock (gross,shipping_deduction,net,earning_state,available_at) on the order you create and the order you read. deliveryfee brackets on every town ofGET /states.- A
quoteon a validPOST /orders/validate.
New calls
Balance also reports
pending (what undelivered orders will earn) and under_review. Earnings can be withdrawn only while their order is delivered.Keys and scopes
Every endpoint names the scope a key needs; a key without it gets403 insufficient_scope. Keys you already have keep exactly their access. See Authenticate and keys.Changed behaviour
GET /products?product_ids=with anything but 1 to 100 positive ids used to be ignored. It now answers422 invalid_parameter.GET /ordersused to answer405. It now lists your orders.- Money reads answer
503 ledger_unavailablewhen your balance or an order’spartner_referencecannot be read, never zeros or anullreference. A malformed body still gets400 bad_requestfirst. - A closed account’s key can read your money and ask to withdraw, where it used to get
403. It cannot change the payout method or place orders. - A new order can be missing from
GET /reports/summaryfor a short time, until it is recorded. - Some new reads have their own rate limit. Existing limits are unchanged.
