Skip to content
Cascade Cascade
Қазақша Русский English

FAQ

How does Cascade OTP work?

Cascade accepts an API request, delivers a code to a real phone via the chosen channel, and verifies the user’s input.

Quick Answer

Cascade accepts an API request, delivers a code to a real phone via the chosen channel, and verifies the user’s input.

Summary

Step-by-step flow: phone → send → message on channel → code → verify → success.

Key Takeaways

  • Send and verify are two required steps.
  • You can omit the channel — the company default applies.
  • Tokens are charged for successful delivery.

Related Questions

Contents

  1. Flow in a minute

Flow in a minute

  1. The user enters a number in your form.
  2. Your server normalizes the phone (for KZ often 8… → 7…) and calls POST https://cascade.kz/api/otp/send with a Bearer token.
  3. Cascade delivers the code via WhatsApp, Telegram or SMS — depending on channel or the “Where to send from” setting in the cabinet.
  4. The user enters the code.
  5. The server calls POST /otp/verify with the same phone and purpose.
  6. On success you grant access to the account or operation.

Resending to the same number is limited to about once per 60 seconds — show a timer in the UI. Do not call the API from the browser: the key must live only on the backend. If the balance is insufficient, you get an insufficient-tokens message — see top-up and pricing. For short links in the same message, pass the link field. More scenarios — in use-cases, errors — in errors, product overview — in about.

FAQ

How does Cascade OTP work?
Cascade accepts an API request, delivers a code to a real phone via the chosen channel, and verifies the user’s input.
Documentation API Pricing FAQ