Skip to main content
Mouv aplica rate limiting por IP origen sobre el header X-Forwarded-For (vía CloudFront). Los límites se aplican por minuto rolling window.

Límites actuales

Respuesta cuando se excede

El header Retry-After indica los segundos exactos hasta que la ventana se libera. La respuesta 429 NO consume cuota adicional.

Estrategia recomendada

Tips para evitar rate limiting

Cachear saldo

GET /wallets/balance retorna header Cache-Control: private, max-age=10. Cacheá 10s en tu cliente — reduce ~50% del tráfico.

Batch consultas

En lugar de N llamadas a /transactions/:id, usá /transactions con paginación. Una sola request retorna hasta 100 movimientos.

Webhooks (próximo)

Cuando habilitemos webhooks salientes, podrás recibir notificaciones de transfer.completed en lugar de pollear estados.

Backoff exponencial

Si recibís 429 dos veces seguidas, hacé backoff 2^n * 1000ms (1s, 2s, 4s, 8s). Industry pattern Stripe/Plaid.

Límites elevados (enterprise)

Si tu volumen requiere más capacidad (>500 retiros/día sostenidos o >100 PSE links/día), contactanos en hola@vectora.com.co. Configuramos límites custom per-cliente con visibility métrica.