Rate limiting guideline

PayPal may return a 429 RATE_LIMIT_REACHED error if your integration exceeds allowed request limits.

To avoid this:

• Reuse the OAuth 2.0 access token until it expires (typically 9 hours).
• Implement exponential backoff when polling: start with 5 seconds and increase over time.
• Poll only as long as the order is valid (based on QR expiry).
• Avoid polling more than once every 3–5 seconds during active payment windows.

If rate limiting affects your integration, contact Merchant Technical Support.