Rate Limits

API Usage Limits

Our VoP API has generous rate limits designed for real-world payment processing:

📊 Default Limits

• 1,000 requests per minute per client
• 10,000 requests per hour per client
• 100,000 requests per day per client
• Burst capacity available for peak loads

⚡ Response Times

• Average: 500ms - Typical verification response
• Maximum: 2 seconds - Guaranteed response time
• 99.9% uptime - Service availability

Rate Limit Headers

Every API response includes usage information:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1640995200

What this means:

• Limit: 1,000 requests per minute allowed
• Remaining: 847 requests left in current window
• Reset: When the limit resets (Unix timestamp)

Handling Rate Limits

✅ Best Practices

// Check rate limit headers
if (response.headers['x-ratelimit-remaining'] < 10) {
  // Slow down requests
  await delay(1000);
}

// Handle rate limit exceeded
if (response.status === 429) {
  const resetTime = response.headers['x-ratelimit-reset'];
  const waitTime = resetTime - Date.now();
  await delay(waitTime);
  // Retry request
}

🚫 What Happens When Exceeded

{
  "error": "RATE_LIMIT_EXCEEDED",
  "message": "Too many requests. Try again in 60 seconds.",
  "retry_after": 60
}