Códigos de error

{
  "error": "CODIGO_MAYUSCULAS_SNAKE_CASE",
  "message": "Descripción human-readable en español",
  "details": { /* opcional, contextual */ }
}

async function mouvRequestWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const res = await fetch(url, options);

    // Éxito
    if (res.ok) return res.json();

    const body = await res.json();

    // Errores que NO se reintenan
    if (res.status === 400 || res.status === 401 || res.status === 403 || res.status === 422) {
      throw new Error(body.error);
    }

    // Rate limit: respect Retry-After
    if (res.status === 429) {
      const wait = parseInt(res.headers.get('Retry-After') || '1') * 1000;
      await new Promise(r => setTimeout(r, wait));
      continue;
    }

    // 5xx: backoff exponencial
    if (res.status >= 500) {
      const wait = Math.pow(2, i) * 1000; // 1s, 2s, 4s
      await new Promise(r => setTimeout(r, wait));
      continue;
    }
  }
  throw new Error('MAX_RETRIES_EXCEEDED');
}

curl -X POST https://consola.mouvlatam.com/api/transfers/send \
  -H "Authorization: Bearer mvk_..." \
  -d '{ "amount": 100000, ..., "reference": "factura-001-2026" }'

{
  "error": "AMOUNT_BELOW_MINIMUM",
  "message": "El monto está por debajo del mínimo permitido.",
  "minUsdt": "1000.000000"
}