Rate limiting guideline

DocsLimited

Last updated: Oct 24th, 2:45am

PayPal may temporarily apply rate limiting when detecting unusual or abusive traffic to ensure platform stability. While no fixed rate limits are published, if your integration exceeds limits, you may receive an HTTP 429 - RATE_LIMIT_REACHED error.

Note:

Use webhooks instead of polling to receive updates.

Reuse OAuth 2.0 access tokens until they expire to avoid unnecessary auth requests.

Avoid repeated order status checks during the session timeout period (10 minutes for the US, 168 hours for Australia).

Allow sufficient time for buyer approval on Zip's hosted page before retrying.

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