O rate limit protege o envio do pedido contra rajadas, loops e chamadas excessivas, como robôs testando cartões. O recurso é nativo do WooCommerce: usa a opção, a tabela, o cache e o contador do próprio WooCommerce.
No WooCommerce, a opção vale só para o checkout em blocos. O Checkout Rishi usa o checkout clássico, então aplica a mesma opção ao envio do pedido dele. Basta ligar uma vez, no WooCommerce.
Ativar pelo painel
- Acesse WooCommerce → Configurações → Avançado → Recursos.
- Marque Limite de taxa Checkout (em inglês, Rate limit Checkout).
- Clique em Salvar alterações.
Com a opção ligada, cada visitante pode tentar finalizar o pedido 3 vezes a cada 60 segundos. Na quarta tentativa dentro da janela, o checkout mostra "Muitas tentativas de finalizar o pedido. Aguarde X segundos antes de tentar novamente."
Administradores com permissão para editar posts não são limitados, seguindo o comportamento do WooCommerce.
O Checkout Rishi segue essa opção a partir da versão 3.4.1. Em versões anteriores, ative pelo filtro abaixo.
Ajustar por código
O filtro wc_smart_checkout_rate_limit_options recebe o valor da opção do WooCommerce em enabled e decide por último. Use-o para mudar a janela ou para ativar o limite sem a opção do painel:
add_filter( 'wc_smart_checkout_rate_limit_options', function( $options ) {
$options['enabled'] = true;
$options['limit'] = 5;
$options['seconds'] = 120;
return $options;
} );
| Opção | Tipo | Padrão | Descrição |
|---|---|---|---|
enabled |
bool | opção Limite de taxa Checkout do WooCommerce | Ativa a proteção no envio do pedido |
limit |
int | 3 |
Tentativas permitidas dentro da janela |
seconds |
int | 60 |
Duração da janela em segundos |
proxy_support |
bool | false |
Permite considerar headers de IP encaminhados |
Use inteiros maiores ou iguais a 1 em limit e seconds. O valor 0 é normalizado para 1.
Para desligar só no Checkout Rishi, mantendo a opção ligada no WooCommerce, retorne $options['enabled'] = false;.
Identificação do visitante
Usuários autenticados são agrupados pelo ID do usuário. Visitantes são agrupados por um hash do endereço IP.
Se a loja estiver atrás de um proxy, balanceador ou CDN confiável, ative o suporte correspondente:
add_filter( 'wc_smart_checkout_rate_limit_options', function( $options ) {
$options['proxy_support'] = true;
return $options;
} );
Ative proxy_support somente quando a infraestrutura sobrescrever os headers enviados pelo cliente. Caso contrário, um visitante pode falsificar o IP de origem.
Para substituir o agrupamento, use o filtro nativo do WooCommerce:
add_filter( 'woocommerce_store_api_rate_limit_id', function( $identifier ) {
return $identifier;
} );
Headers e observabilidade
As respostas podem incluir:
RateLimit-Limit: máximo permitido na janela;RateLimit-Remaining: tentativas restantes;RateLimit-Reset: timestamp da próxima janela;RateLimit-Retry-After: segundos até uma nova tentativa, quando bloqueado.
Quando o limite é excedido, o plugin dispara a action nativa woocommerce_store_api_rate_limit_exceeded, com o IP e a chave do contador.
Se a versão instalada do WooCommerce não disponibilizar o limitador usado pela Store API, o checkout continua funcionando, registra um warning no log do WooCommerce e dispara wc_smart_checkout_rate_limit_unavailable.
O que essa proteção não resolve
O limite reduz o volume por identidade, mas não impede card testing com rotação de IPs, contas ou sessões. Ele também conta envios do checkout antes de saber se houve uma autorização de cartão.
Para reduzir testes automatizados de cartões, combine o limite com as proteções do gateway, análise de recusas, CAPTCHA validado no servidor, 3DS e regras antifraude. Nunca envie ou armazene número, validade ou CVV para criar um fingerprint próprio; use somente identificadores seguros fornecidos pelo gateway.