Rate limits

The store API is rate-limited to:

60 requests / minute / store

This is generous for typical shop volumes — a few hundred orders a day at peak sits well under the ceiling.

When you exceed it

Exceeding the limit returns:

HTTP/1.1 429 Too Many Requests
Retry-After: <seconds>

Respect the Retry-After header and resume after the window resets. Standard X-RateLimit-* headers are returned on every response so you can track your remaining budget proactively.

Staying under the limit

• Batch by event, not by field. Send one complete order upsert rather than several partial PATCHes.
• Don't poll. Push data when it changes; never loop the API to "sync".
• Back off on 429. Use exponential backoff with jitter; retries are safe (see Idempotency).