Cascade OTP in JavaScript

Cascade provides a REST API. Below is a practical minimum in JavaScript with the fetch client.

Useful links: API, send, verify, examples, FAQ, pricing, documentation.

Installation

An official Cascade npm package may not exist — use standard fetch / axios on the backend (Node.js).

# optional
npm install axios

Initialization

const BASE = process.env.OTP_API_BASE_URL || 'https://cascade.kz/api';
const TOKEN = process.env.OTP_API_TOKEN;

async function cascade(path, body) {
  const res = await fetch(`${BASE}${path}`, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${TOKEN}`,
      'Content-Type': 'application/json',
      Accept: 'application/json',
    },
    body: JSON.stringify(body),
  });
  return res.json();
}

Send OTP

const send = await cascade('/otp/send', {
  phone: '77001234567',
  purpose: 'verification',
});
if (!send.success) throw new Error(send.message);

Verify

const verify = await cascade('/otp/verify', {
  phone: '77001234567',
  code: '482910',
  purpose: 'verification',
});
if (!verify.success) throw new Error(verify.message);

Errors

Check HTTP and success. Typical cases: 401, 422, 429. Do not call the API from the browser. See errors, FAQ, documentation.