Intégrer les codes de vérification kazakhs +7 à votre suite de tests

Quels points d'accès un cycle OTP pour le Kazakhstan sollicite-t-il ?

Un cycle complet représente cinq ou six requêtes sur https://otproute.com/api/v1, authentifiées par une clé Bearer commençant par or_live_. L'identifiant de pays du Kazakhstan est kz, et un compte peut détenir jusqu'à 10 clés : la CI, le staging et l'ordinateur d'un développeur peuvent ainsi avoir chacun la leur.

• GET /api/v1/balance au début du job, pour qu'un portefeuille vide fasse échouer l'exécution tôt.
• GET /api/v1/prices?country=kz&service=telegram pour lire le prix et la disponibilité actuels de cette combinaison.
• POST /api/v1/activations avec {"service": "telegram", "country": "kz"}, qui renvoie un identifiant d'activation et un numéro +7.
• GET /api/v1/activations/{id} si vous interrogez, ou rien du tout si vous misez sur les webhooks.
• POST /api/v1/activations/{id}/cancel quand un test se termine avant que le code soit nécessaire.

La limite est de 300 requêtes par minute et par compte, ce qui laisse de la marge pour des jobs parallèles qui interrogent toutes les quelques secondes. Partez du guide d'intégration de l'API s'il s'agit de votre première intégration.

Comment consommer les codes +7 par webhook plutôt que par interrogation ?

Enregistrez un endpoint dans la console Développeur (cinq par compte) et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled. Chaque POST porte X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Reconstruisez la signature par un HMAC-SHA256 de <t>.<raw body> avec le secret de l'endpoint et comparez en temps constant. Utilisez les octets bruts reçus, car un JSON resérialisé produit une empreinte différente, et rejetez les horodatages hors d'une courte tolérance pour empêcher les rejeux. Comme une livraison peut être retentée, faites un upsert sur l'identifiant d'activation pour que la seconde copie ne change rien. Un pas-à-pas figure dans capture d'OTP par webhook.

Quelles applications peuvent envoyer des codes à un numéro kazakh ?

La route kz liste plus de 1 700 services. Parmi les plus demandés dans le dernier instantané : Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, TikTok, Facebook, Viber, Discord, Microsoft & Outlook, LinkedIn, Uber, AliExpress et Amazon.

Ne figez pas cette liste dans le code. Les routes changent au fil de la journée : un script doit donc vérifier GET /api/v1/prices avant chaque commande et choisir un identifiant de service de repli quand une combinaison est indisponible.

Pourquoi l'indicatif +7 demande-t-il une attention particulière dans une base de numéros ?

Le Kazakhstan partage l'indicatif 7 avec la Russie. Les deux utilisent des numéros nationaux à dix chiffres, et les plages mobiles kazakhes commencent généralement par 7 après l'indicatif pays : un numéro comme +7 7xx xxx xx xx est donc kazakh, alors que beaucoup de mobiles russes commencent par 9. N'en déduisez jamais le pays à partir de l'indicatif seul ; déterminez-le d'après la plage du numéro avec une bibliothèque de numéros maintenue, ou gardez un champ pays explicite.

En national, on compose un 8 de ligne devant les dix chiffres. Retirez-le à la saisie et stockez la forme E.164, +7 suivi du numéro national. Le kazakh est la langue d'État et le russe est aussi largement employé officiellement : les SMS de vérification peuvent donc arriver en russe, en kazakh ou en anglais, généralement en cyrillique. Assurez-vous que votre parseur de SMS et vos logs gèrent l'UTF-8 et extraient les chiffres plutôt que le texte.

Les équipes testent ici quand elles se lancent en Asie centrale, contrôlent une localisation bilingue ou soutiennent des équipes d'exploitation régionales.

Existe-t-il une voie par le tableau de bord pour les équipes qui ne codent pas ?

Oui. Après vous être inscrit avec un code e-mail ou Google, approvisionnez le portefeuille, choisissez le Kazakhstan et le service, confirmez le prix affiché et passez la commande. Le numéro +7 puis, plus tard, le code apparaissent sur la carte d'activation. Les product managers et les testeurs de localisation s'en servent pour des contrôles ponctuels pendant que le pipeline gère le volume.

Peut-on conserver un numéro kazakh pour des connexions répétées ?

Aucune option en libre-service n'existe pour cela. Les numéros OTP Gateway servent un seul code, et les numéros dédiés de longue durée ne sont vendus que pour les États-Unis et le Canada, dès $1.95/mois, avec SMS entrants et sortants et appels depuis le navigateur. Si vous avez besoin d'une ligne kazakhe de longue durée, écrivez à [email protected] ; la possibilité d'en organiser une dépend de la réglementation locale et n'est pas assurée. Pour des comptes de staging qui doivent se reconnecter, une ligne américaine ou canadienne est souvent la réponse pratique quand le service l'accepte.

Que se passe-t-il quand un code n'arrive pas en 20 minutes ?

L'activation expire, le webhook déclenche activation.expired et la totalité du montant retourne sur le portefeuille sans action de votre part. Diagnostiquez ensuite avant de réessayer :

• Le numéro a-t-il été soumis avec +7 et non avec le 8 national ?
• Le service refuse-t-il les numéros virtuels ? Certains le font, c'est pourquoi OTP Route rembourse les activations inutilisées.
• Réessayez plus tard ou sur une autre route plutôt que de boucler instantanément ; un court délai d'attente garde vos logs lisibles.

La vitesse de livraison dépend du service et de la route : évitez donc les délais d'expiration trop serrés dans les tests.

Comment le compte est-il facturé ?

Un seul portefeuille prépayé en USD, paiement à l'usage, sans abonnement ni paliers de forfait. Rechargez par carte ou avec les stablecoins USDT ou USDC ; chaque recharge et chaque achat de numéro produit une facture PDF par e-mail. Les comptes de développement peuvent être basculés en sandbox sur demande, avec des numéros et des codes simulés pour des tests de bout en bout. Utilisez le service pour vos propres produits légitimes, respectez les conditions de chaque application et la Politique d'utilisation acceptable, et consultez les tarifs pour les prix en direct.

Questions fréquentes

Comment distinguer un numéro kazakh +7 d'un numéro russe ?

Regardez la plage du numéro, pas seulement l'indicatif pays. Les mobiles kazakhs commencent généralement par 7 après +7 ; une bibliothèque de numéros maintenue ou un champ pays explicite évite les erreurs.

Quel est l'identifiant de pays du Kazakhstan dans l'API OTP Route ?

Utilisez kz dans le corps de l'activation et dans le paramètre country du point d'accès des prix.

Puis-je tester le parcours d'inscription kazakh de mon application sans SIM locale ?

Oui. Commandez un numéro +7 pour le Kazakhstan dans l'OTP Gateway, saisissez-le dans votre propre parcours et récupérez le code par webhook, interrogation ou tableau de bord.

Serai-je débité si le code Telegram n'arrive jamais ?

Non. Sans SMS dans la fenêtre de 20 minutes, ou après une annulation, le montant retourne automatiquement sur votre portefeuille.

Les SMS de vérification kazakhs sont-ils en russe ou en kazakh ?

L'un ou l'autre est possible, et certains services utilisent l'anglais. Analysez le code numérique et assurez-vous que votre pile gère le texte cyrillique.

Y a-t-il des frais mensuels pour la route du Kazakhstan ?

Non. OTP Route fonctionne à l'usage depuis un portefeuille prépayé en USD alimenté par carte, USDT ou USDC.

Les noms de services sont des marques déposées de leurs propriétaires respectifs. OTP Route n'est affilié à aucun d'entre eux. Utilisez les numéros de manière licite et respectez les conditions de chaque service ainsi que notre Politique d'utilisation acceptable.