Comment recevoir des codes OTP SMS du Kosovo par API ou tableau de bord

Pourquoi une équipe produit aurait-elle besoin d'un numéro +383 ?

Le Kosovo est un petit marché dont l'empreinte à l'étranger est considérable : une importante diaspora vit en Allemagne, en Suisse et ailleurs en Europe occidentale, et beaucoup de ses membres gardent un numéro kosovar pour leur famille et leur banque. Les applications qui servent ce public, du voyage au transfert d'argent, doivent voir ce que vit un utilisateur +383 à l'inscription.

La localisation est l'autre moteur. L'albanais et le serbe sont tous deux langues officielles : un parcours traduit dans l'une ou l'autre mérite un vrai test de bout en bout plutôt qu'une revue de captures d'écran. Un numéro de vérification du Kosovo issu de l'OTP Gateway permet à la QA de faire ce contrôle depuis n'importe quel bureau.

Les équipes d'exploitation régionales basées à Pristina ou couvrant l'ensemble des Balkans occidentaux ont une troisième raison : les profils professionnels enregistrés avec un contact local demandent parfois un nouveau code, et le faire passer par un outil partagé et auditable vaut mieux que de se passer le téléphone d'un employé.

Quelles applications sont sur la route du Kosovo en ce moment ?

L'instantané du jour affiche plus de 400 services pour le Kosovo. Parmi les plus proposés actuellement : WhatsApp, Viber, Telegram, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Snapchat, Netflix, Airbnb, Uber et Flipkart.

La liste est plus courte que sur les grands marchés européens et change plus souvent : considérez toute liste écrite comme une indication. La réponse faisant foi est celle que renvoient GET /api/v1/countries et le tableau de bord au moment où vous commandez.

L'API OTP Kosovo en pratique

L'identifiant de pays est xk. Une intégration typique résout les identifiants de service avec GET /api/v1/services, vérifie le coût avec GET /api/v1/prices?country=xk&service=<id>, puis ouvre une activation avec POST /api/v1/activations et un corps tel que {"service": "telegram", "country": "xk"}. La réponse contient le numéro et un identifiant d'activation que vous conservez pour la suite.

Ensuite, le code vous parvient sous forme de webhook activation.sms_received, signé dans l'en-tête X-OTPRoute-Signature par un HMAC-SHA256 de "<t>.<raw body>". Rejetez les horodatages anciens et appuyez votre gestionnaire sur l'identifiant d'activation pour qu'une livraison retentée ne soit traitée qu'une fois. L'interrogation de GET /api/v1/activations/{id} fonctionne aussi quand un job CI n'a pas d'URL publique. Voir le guide d'intégration pour des exemples complets.

Qu'a changé l'arrivée de l'indicatif +383, et comment stocker les numéros ?

Le Kosovo n'a reçu son propre indicatif, +383, qu'à la fin des années 2010. Auparavant, ses réseaux mobiles utilisaient des indicatifs empruntés, notamment ceux de Monaco et de la Slovénie, et certains anciens dossiers clients contiennent encore des numéros dans ces formats. Si vous importez des données historiques, signalez ces entrées plutôt que de les réécrire automatiquement.

Les numéros nationaux commencent par le préfixe de ligne 0 ; un mobile affiché localement 044 123 456 est +383 44 123 456 en E.164. Enregistrez la forme internationale, retirez le zéro à la saisie et ne formatez qu'à l'affichage. Le texte albanais utilise des lettres comme ë, qui sortent de l'alphabet GSM de base : un message localisé peut donc être envoyé en UCS-2, avec des segments plus courts.

Que faire quand un code du Kosovo est en retard ou manquant ?

Laissez à l'activation ses 20 minutes complètes. Quand la fenêtre se ferme sans SMS, ou si vous annulez, le débit est annulé automatiquement sur le portefeuille et activation.expired ou activation.cancelled se déclenche. Les suites raisonnables :

• réessayer après une pause ou choisir une route voisine, comme l'Albanie, si votre test le permet ;
• vérifier que le service visé accepte bien les numéros virtuels ;
• ajouter un backoff aux nouvelles tentatives automatisées au lieu de commander en boucle.

Lignes de longue durée, portefeuille et sandbox pour les projets au Kosovo

OTP Route n'a pas de numéro de longue durée en libre-service pour le Kosovo. Sa gamme de numéros dédiés, dès $1.95/mois, ne couvre que deux pays : les États-Unis et le Canada. Pour une ligne +383 durable, écrivez à [email protected] ; la possibilité d'en organiser une dépend de la réglementation locale.

Les dépenses sont prélevées sur un seul portefeuille prépayé en USD, à l'usage, rechargé par carte ou en USDT/USDC, avec une facture PDF envoyée par e-mail pour chaque recharge. Les développeurs peuvent demander le mode sandbox sur un compte de développement pour recevoir des numéros et des codes simulés pendant la mise en place des webhooks. Détails sur les tarifs.

Questions fréquentes

Puis-je tester l'inscription en albanais de mon application avec un vrai numéro du Kosovo ?

Oui. Commandez un numéro +383 pour vos tests dans l'OTP Gateway, lancez l'inscription en albanais, et le code apparaît dans le tableau de bord et dans votre webhook.

Quel identifiant le Kosovo utilise-t-il dans l'API de vérification SMS ?

Le Kosovo est xk dans tous les points d'accès qui prennent un pays, y compris GET /api/v1/prices et POST /api/v1/activations.

Combien coûte un numéro de vérification du Kosovo ?

Dès $0.20 par code ; le tarif précis dépend du service et s'affiche avant la commande, ou est renvoyé par le point d'accès des prix.

Pourquoi vois-je moins de services pour le Kosovo que pour l'Allemagne ?

La couverture suit ce que nos partenaires opérateurs peuvent acheminer vers chaque pays, et les petits marchés ont des listes plus courtes. Consultez la liste en direct avant de planifier une exécution de test.

Que devient mon argent si les OTP du Kosovo n'arrivent jamais ?

Il retourne intégralement sur le portefeuille quand la fenêtre de 20 minutes se termine sans SMS, ou immédiatement si vous annulez.

Les anciens numéros +377 ou +386 appartiennent-ils encore à des utilisateurs du Kosovo ?

Certains anciens dossiers peuvent en contenir, mais les nouveaux numéros utilisent +383. Traitez les anciens formats comme des données à examiner, pas à convertir aveuglément.

Puis-je garder un numéro +383 pour des connexions répétées ?

Pas en libre-service. Chaque numéro de la passerelle couvre un seul code, et les lignes de longue durée sont un produit États-Unis/Canada ; écrivez à [email protected] pour vous renseigner sur le Kosovo.

Y a-t-il des règles sur l'usage des numéros OTP Route ?

Oui. N'utilisez OTP Route que pour vos propres produits et comptes professionnels légitimes, suivez les conditions de chaque service et respectez la Politique d'utilisation acceptable. Inscrivez-vous pour démarrer.

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.