Wiring Kazakh +7 verification codes into your test suite

Which endpoints does a Kazakhstan OTP run touch?

A full cycle is five or six requests against https://otproute.com/api/v1, signed with a Bearer key that begins with or_live_. Kazakhstan's country id is kz, and an account can hold up to 10 keys, so CI, staging and a developer laptop can each have their own.

• GET /api/v1/balance at the top of the job, so an empty wallet fails the run early.
• GET /api/v1/prices?country=kz&service=telegram to read the current price and availability for that pairing.
• POST /api/v1/activations with {"service": "telegram", "country": "kz"}, which returns an activation id and a +7 number.
• GET /api/v1/activations/{id} if you poll, or nothing at all if you rely on webhooks.
• POST /api/v1/activations/{id}/cancel when a test exits before the code is needed.

The limit is 300 requests per minute per account, which leaves room for parallel jobs that poll every few seconds. Start from the API integration guide if this is your first build.

How do I consume +7 codes by webhook instead of polling?

Register an endpoint in the Developer console (five per account) and subscribe to activation.sms_received, activation.expired and activation.cancelled. Each POST carries X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Rebuild the signature as HMAC-SHA256 over <t>.<raw body> with the endpoint secret and compare in constant time. Use the raw bytes as received, because re-serialised JSON produces a different digest, and reject timestamps outside a short tolerance to stop replays. Since a delivery may be retried, upsert on the activation id so the second copy changes nothing. A step-by-step walkthrough lives in webhook-based OTP capture.

Which apps can send codes to a Kazakh number?

The kz route lists more than 1,700 services. Popular ones in the latest snapshot include Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, TikTok, Facebook, Viber, Discord, Microsoft & Outlook, LinkedIn, Uber, AliExpress and Amazon.

Do not freeze that list into code. Routes change through the day, so a script should check GET /api/v1/prices before every order and choose a fallback service id when a pairing is unavailable.

Why does +7 need special care in a phone-number database?

Kazakhstan shares country code 7 with Russia. Both use ten-digit national numbers, and Kazakh mobile ranges usually begin with 7 after the country code, so a number such as +7 7xx xxx xx xx is Kazakh while many Russian mobiles start with 9. Never infer the country from the dial code alone; resolve it from the number range with a maintained phone library, or keep an explicit country field.

Domestically, people dial a trunk 8 in front of the ten digits. Strip it on input and store the E.164 form, +7 followed by the national number. Kazakh is the state language and Russian is also widely used officially, so verification texts may arrive in Russian, Kazakh or English, typically in Cyrillic. Make sure your SMS parser and logs handle UTF-8 and extract the digits rather than the wording.

Teams test here when launching in Central Asia, checking bilingual localisation, or supporting regional operations staff.

Is there a dashboard route for teams who don't code?

Yes. After you sign up with an email code or Google, fund the wallet, choose Kazakhstan and the service, confirm the displayed price and order. The +7 number and, later, the code appear on the activation card. Product managers and localisation testers use this for spot checks while the pipeline handles volume.

Can a Kazakh number be kept for repeat logins?

No self-serve option exists for that. OTP Gateway numbers serve a single code, and long-term Dedicated Numbers are only sold for the United States and Canada, from $1.95/month with inbound and outbound SMS plus browser calling. If you need a long-running Kazakh line, email [email protected]; whether one can be arranged depends on local rules and is not assured. For staging accounts that must sign in again, a US or Canadian line is often the practical answer when the service accepts it.

What happens when a code doesn't arrive in 20 minutes?

The activation expires, the webhook fires activation.expired, and the full amount returns to the wallet with no action from you. Then diagnose before retrying:

• Was the number submitted with +7, not the domestic 8?
• Does the service refuse virtual numbers? Some do, which is why OTP Route refunds unused activations.
• Retry later or on another route rather than looping instantly; a short back-off keeps your logs readable.

Delivery speed depends on the service and the route, so avoid tight timeouts in tests.

How is the account billed?

One prepaid USD wallet, pay as you go, with no subscription and no plan tiers. Top up by card or with USDT or USDC stablecoins; every top-up and number purchase produces a PDF invoice by email. Development accounts can be moved to sandbox on request, which returns simulated numbers and codes for end-to-end tests. Use the service for your own legitimate products, respect each app's terms and the Acceptable Use Policy, and see pricing for the live rates.

Frequently asked questions

Which digits distinguish Kazakhstan’s +7 numbers from Russia’s?

Look at the number range, not just the country code. Kazakh mobiles usually start with 7 after +7; a maintained phone-number library or an explicit country field avoids mistakes.

What is the Kazakhstan country id in the OTP Route API?

Use kz in the activation body and in the country parameter of the prices endpoint.

Can I test my app's Kazakh sign-up flow without a local SIM?

Yes. Order a +7 number for Kazakhstan from the OTP Gateway, enter it in your own flow, and collect the code by webhook, polling or the dashboard.

Will I be charged if the Telegram code never arrives?

No. Without an SMS inside the 20-minute window, or after a cancel, the amount goes back to your wallet automatically.

Do Kazakh verification texts come in Russian or Kazakh?

Either is possible, and some services use English. Parse the numeric code and make sure your stack handles Cyrillic text.

Is there a monthly fee for the Kazakhstan route?

No. OTP Route is pay as you go from a prepaid USD wallet funded by card, USDT or USDC.

Service names are trademarks of their respective owners. OTP Route is not affiliated with them. Use numbers lawfully, follow each service's terms and our Acceptable Use Policy.