Guías · Conceptos

Verificación ALTCHA

Cuándo una tienda pide el desafío ALTCHA y cómo resolverlo.

Una ráfaga de intentos arma la tienda durante 30 minutos, y mientras tanto el checkout exige una prueba de trabajo. Hoy alcanza con más de 5 intentos por minuto en la tienda, de modo que una promoción exitosa también la arma. Toda landing tiene que implementar este flujo:

  1. POST /checkout responde 403 ALTCHA_REQUIRED. Nada se escribió.
  2. GET /altcha/challenge entrega un desafío válido por 10 minutos.
  3. El navegador lo resuelve y reenvía el mismo cuerpo y la misma Idempotency-Key, sumando altchaChallenge y altchaSolution.
JavaScript
import { solveChallenge } from "altcha-lib";
import { deriveKey } from "altcha-lib/algorithms/web/pbkdf2";

const challenge = await (await fetch(`${BASE}/altcha/challenge`, { headers })).json();
const altchaSolution = await solveChallenge({ challenge, deriveKey });
// reenviar: { ...body, altchaChallenge: challenge, altchaSolution }

Cada solución sirve una sola vez. ALTCHA_INVALID, ALTCHA_EXPIRED y ALTCHA_REPLAY se resuelven igual, con un desafío nuevo; conviene reintentar una sola vez. Un 404 del desafío significa que ALTCHA no está configurado en la plataforma y no se exige en ninguna tienda.