Guías · Operar

Límites de frecuencia

Los límites provisorios por clave, por tienda y por operación.

Todo request pasa por estos límites. Son provisorios: se revisan con el tráfico real de la primera landing. Ante una caída del sistema de límites, el request sigue; la única excepción es asociar el comprobante, que en ese caso se rechaza y se puede reintentar.

LímiteValor provisorioPor
Antes de verificar la clave600 por minutoIP
Clave publicable, por cliente120 por minutoIP y clave
Total de la clave1.200 por minutoClave

Un sk_ no tiene el límite por cliente, porque todos sus compradores comparten la IP del servidor. Un origen rechazado no consume el total de la clave.

Las lecturas de productos (lista y detalle) suman la protección del catálogo de la tienda: 60 por minuto por IP y tienda, y 1.200 por minuto en total por tienda. Con pk_ aplican los dos; con sk_, solo el total de la tienda, porque todos sus compradores comparten una IP. Al superarlos no se rechaza de entrada: se sirve la última respuesta conocida (ver el paso 1). Además, cada operación tiene el suyo:

OperaciónLímite provisorioPorCon sk_
Cotización60 por minutoIP y claveNo aplica
Cotización con cupón20 por minutoIP y tiendaNo aplica
Checkout10 por minutoIP y tiendaAplica
Checkout, total20 por minuto y 100 por horaTiendaAplica
Inicio de pago (Stripe incluido)20 por minutoIP y claveNo aplica
Desafío ALTCHA30 por minutoIPNo aplica
Subida de comprobante10 por minutoIP y tiendaNo aplica
Asociar comprobante10 cada 10 minutosIPNo aplica
Consultas a Pagopar desde GET /orders/by-payment-hash/{hash} (Pagopar está retirado)120 por minuto; superado, responde el estado guardadoTiendaAplica

Los límites del checkout son propios de esta API: una ráfaga contra el checkout del storefront no los gasta, ni al revés. La señal que arma la tienda para ALTCHA sí es compartida.

Un 429 de checkout también arma la tienda para ALTCHA.