Rate Limits

Mekari API Gateway limits how many requests a merchant's integrations can send.

• The limit is per merchant company: all applications connected to the same company share one limit.

• The size of the limit and a monthly request quota depend on the merchant's Mekari POS package:

  Package	Public API	Requests per minute	Monthly request quota
  Essential	Not included	–	–
  Plus	Included	120	25,000
  POS 360	Included	240	100,000

• When the per-minute limit or the monthly quota is reached, the gateway answers 429 until the current time window ends (the next minute, or the next month for the quota). Requests are not queued.

Handling 429

1. Stop sending requests for that company.
2. If the response has a Retry-After header, wait that long. Otherwise wait with exponential backoff (for example 1, 2, 4, 8 seconds, up to a minute), with some random jitter.
3. Retry a write with the same Idempotency-Key (see Idempotency).

To stay under the limit, read lists with limit=100, avoid polling the same data often, and spread bulk jobs over time.