Skip to main content
APIMoneyPanel
Cash at the office

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-method reports only the saved method, and POST /withdrawals with nothing saved answers 409 payout_method_missing. A new error, 422 bank_transfer_not_allowed, answers PUT /payout-method with bank details where bank transfer is not offered, and POST /withdrawals on a kept IBAN until cash is saved.
See Get paid and Payout and withdrawals.
APIMoneyOrdersPanel
v1.1.0

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 money block (gross, shipping_deduction, net, earning_state, available_at) on the order you create and the order you read.
  • delivery fee brackets on every town of GET /states.
  • A quote on a valid POST /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 gets 403 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 answers 422 invalid_parameter.
  • GET /orders used to answer 405. It now lists your orders.
  • Money reads answer 503 ledger_unavailable when your balance or an order’s partner_reference cannot be read, never zeros or a null reference. A malformed body still gets 400 bad_request first.
  • 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/summary for a short time, until it is recorded.
  • Some new reads have their own rate limit. Existing limits are unchanged.
The partner panel on mart.ps can show the same money, once Mart turns it on for your account.