Rate limiting guideline

DocsLimited

Last updated: Oct 1st, 9:19am

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 4-hour session timeout period.

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

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