Қазақстандағы OTP

Қазақстандық OTP ағынына не қажет

Негізгі интеграция барлық елде ұқсас: бэкенд нөмірді жібереді, пайдаланушы кодты алады, сервер енгізілген мәнді тексереді. Қазақстанда телефон форматына, интерфейс тіліне және нақты қолжетімді арналарға ерекше назар аудару керек.

Минималды жұмыс ағынына серверлік API кілті, нөмірді қалыпқа келтіру, send және verify сұраулары, алты цифрлық өріс, лимиттер, бақыланатын resend және жеткізу мәртебесін бақылау кіреді.

Cascade уақытша нөмірлер бермейді. Ол сіздің сайтыңыздың немесе қолданбаңыздың клиент нөміріне OTP жібереді.

Қазақстандық нөмір форматы

Пайдаланушы нөмірді +7, бос орын, жақша немесе дефиспен енгізуі мүмкін. Интерфейс таныс көріністі қабылдай алады, бірақ бэкенд API шақырмас бұрын мәнді бір форматқа келтіріп, тексеруі керек.

Қалыпқа келтірілген мысал:

77001234567

Тек тыныс белгілерін алып тастау жеткіліксіз. Ұзындығы мен рұқсат етілген халықаралық форматын тексеріңіз. verify сәтті болмайынша нөмірді расталған деп белгілемеңіз.

Қолжетімді арналар мен баға

Cascade жүйесінде WhatsApp пен Telegram ашық түрде қолжетімді. Кез келгені арқылы сәтті жеткізу 3 кредит тұрады. SMS техникалық түрде қарастырылған, бірақ ашық SMS провайдері қазір жұмыс істемейді.

Сондықтан интерфейсте автоматты SMS fallback уәде етпеңіз. Компания үшін нақты қосылған арналарды ғана көрсетіңіз. Ағымдағы шарттарды тарифтерден, техникалық мәліметті API анықтамасынан қараңыз.

Толық сценарийді локализациялау

Қазақстандық өнімге көбіне қазақ және орыс тіліндегі растау экрандары керек. Тек тақырыпты емес, бүкіл ағынды аударыңыз:

• кодтың қайда жіберілгені;
• қанша уақыт жарамды екені;
• қайта жіберудің қашан ашылатыны;
• қате кезінде не істеу керегі;
• қолдауға қалай хабарласу керегі.

Хабарлама қысқа болуы керек: өнім атауын, кодтың мақсатын және оны ешкімге бермеу ескертуін көрсетіңіз.

Пилотты өлшеу

Жаңа Cascade аккаунтына 1000 бастапқы кредит беріледі, сондықтан негізгі пилотты үлкен пакет сатып алмай өткізуге болады. Тек жіберу санын емес, мыналарды өлшеңіз:

• сәтті жеткізу үлесі;
• жеткізу уақыты;
• сәтті тексеру үлесі;
• қайта жіберу үлесі;
• нөмір форматы қателері;
• «код келмеді» өтініштері.

Бұл көрсеткіштер пайдаланушы жолын жай хабарлама санынан жақсырақ сипаттайды.

Ұсынылатын іске қосу жоспары

1. Тест ортада POST /api/otp/send және POST /api/otp/verify қосыңыз.
2. WhatsApp пен Telegram-ды келісім берілген ішкі нөмірлерде тексеріңіз.
3. Таймер, кідірісті resend және қауіпсіз қате мәтіндерін қосыңыз.
4. Қазақ және орыс интерфейстерін тексеріңіз.
5. Нөмір, аккаунт және IP бойынша лимит қойыңыз.
6. Трафикті арттырмас бұрын пилот метрикаларын талдаңыз.

Толық серверлік реттілік OTP API қосу нұсқаулығында берілген.

Продакшен чеклисті

• Bearer токені тек серверде сақталады.
• send және verify бір қалыпқа келтірілген нөмірді қолданады.
• Екі сұрауда да purpose сәйкес келеді.
• Код 5 минуттан кейін өшеді және қайта қолданылмайды.
• Интерфейс қолжетімсіз арнаны уәде етпейді.
• Resend пен тексеру әрекеттері шектелген.
• Жауап аккаунттың бар-жоғын ашпайды.
• Қолдау тобында жеткізілмеген кодқа арналған түсінікті сценарий бар.

Бұл негіз қауіпсіздікті, конверсияны және іздеу түсініктілігін жақсартады, өйткені әрбір ашық факт өнім құжаттамасымен расталады.