Límites
Límites de tasa, headers de cuota y cómo responder a un 429.
Esta página cubre los rate limits de la API (peticiones por minuto). Para los límites de monto por transacción de cada método, consulta Límites de métodos de pago.
Rate limits por defecto
Si excedes estos límites, la API responde con HTTP 429 Too Many Requests.
| Endpoint | Límite | Ventana |
|---|---|---|
POST /process/ | 100 peticiones | por minuto |
GET /transactions/{transaction_id}/ | 300 peticiones | por minuto |
Si tu aplicación necesita límites más altos, contacta a soporte para discutir tu caso de uso.
Headers de rate limit
La API incluye estos headers en cada respuesta para que rastrees tu estado:
| Header | Descripción |
|---|---|
X-RateLimit-Limit | Máximo de peticiones permitidas en la ventana actual. |
X-RateLimit-Remaining | Peticiones restantes en la ventana actual. |
X-RateLimit-Reset | Timestamp Unix de cuándo se reinicia la ventana. |
Manejo del error 429
Al exceder el límite, la API devuelve HTTP 429 con un cuerpo que indica cuándo reintentar:
{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests",
"retry_after": 60
}
}El campo retry_after indica los segundos que debes esperar antes de reintentar.
Buenas prácticas
- Espera al menos los segundos de
retry_afterantes de reintentar tras un429. - Implementa backoff exponencial para errores del servidor o rate limits.
- Cachea respuestas para evitar repetir peticiones por la misma información (especialmente
GET). - Controla la concurrencia para no exceder el límite con peticiones en paralelo.
Siguientes pasos
¿Te resultó útil esta página?