La route du développeur vers les codes de vérification suisses (+41)

Quelles requêtes renvoient un code suisse via l'API ?

L'API OTP Suisse est la même petite surface que pour tous les pays, avec ch comme identifiant de pays. Authentifiez-vous avec une clé Bearer (préfixe or_live_) créée dans la console Développeur ; un compte peut détenir jusqu'à 10 clés.

1. Résolvez les identifiants avec GET /api/v1/services et GET /api/v1/countries, et mettez-les en cache entre deux exécutions.
2. Consultez GET /api/v1/prices?country=ch&service=<id>. La réponse contient le prix actuel et indique si une route est ouverte à cet instant.
3. Envoyez POST /api/v1/activations avec {"service": "whatsapp", "country": "ch"} ou le service couvert par votre test. Conservez l'identifiant d'activation renvoyé.
4. Saisissez le numéro +41 dans le champ téléphone de votre propre produit.
5. Lisez le résultat via GET /api/v1/activations/{id} ou par webhook ; abandonnez proprement avec POST /api/v1/activations/{id}/cancel.

GET /api/v1/balance a sa place dans l'étape d'initialisation de votre suite de tests. La limite est de 300 requêtes par minute et par compte, ce qui couvre largement plusieurs jobs simultanés qui interrogent l'API à intervalle détendu. Référence des endpoints : documentation.

Polling ou webhooks pour les activations +41 ?

Le polling garde un petit script simple. Les webhooks l'emportent dès que les tests tournent en parallèle, car rien n'a besoin de tourner en boucle pendant qu'un SMS à destination de Zurich est en transit.

OTP Route permet d'enregistrer jusqu'à cinq endpoints ; abonnez chacun à activation.sms_received, activation.expired et activation.cancelled. Vérifiez chaque livraison avant de lui faire confiance : prenez les parties t et v1 de X-OTPRoute-Signature, calculez le HMAC-SHA256 de "<t>.<raw body>" avec le secret de l'endpoint, comparez en temps constant et refusez les horodatages en dehors d'une courte tolérance. Basez votre traitement sur l'identifiant d'activation pour qu'une livraison rejouée ne soit qu'une opération sans effet.

Pour approfondir la vérification des signatures, lisez sécuriser les webhooks OTP avec HMAC.

À quoi doit ressembler un numéro suisse dans votre base de données ?

En usage national, les numéros suisses commencent par le préfixe de ligne 0, par exemple un mobile écrit 079 123 45 67. À l'international, ce zéro disparaît : la forme E.164 est +41 79 123 45 67, avec neuf chiffres après l'indicatif du pays. Les plages mobiles se situent dans le bloc 07x. Stockez la chaîne canonique +41… et ne mettez en forme qu'à l'affichage, sinon la déduplication et les recherches se cassent quand une forme dit 079 et une autre +4179.

La langue est l'autre particularité suisse. Avec l'allemand, le français, l'italien et le romanche comme langues nationales, un SMS de vérification peut arriver dans l'une des trois premières selon la gestion de la langue côté expéditeur, et beaucoup d'applications se rabattent simplement sur l'anglais. Si votre produit se localise par région, un vrai code +41 est un moyen peu coûteux de vérifier que le bon modèle de message se déclenche.

Les équipes testent ici avant de lancer un produit fintech ou e-commerce sur le marché suisse, quand le personnel gère des comptes professionnels depuis Genève ou Bâle, ou pour valider des parcours transfrontaliers qui touchent aussi le Liechtenstein, lequel utilise son propre indicatif +423.

Services à vérifier avec un numéro de vérification suisse

L'instantané actuel pour ch liste Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, WhatsApp, Telegram, Signal, Uber, Airbnb, Amazon, eBay, Netflix, Discord, ChatGPT (OpenAI) et Claude, entre autres. Au total, la Suisse compte plus de 1 700 services sur l'OTP Gateway.

Comme la disponibilité évolue tout au long de la journée, considérez cette liste comme un point de départ et interrogez les données en direct à l'exécution. Un banc de test qui vérifie d'abord les prix et marque un test comme ignoré quand la route est fermée produit des rapports bien plus propres qu'un banc qui réessaie à l'aveugle.

Dépanner une activation suisse qui reste vide

Quand un numéro +41 ne reçoit rien, passez en revue ces points avant de toucher à votre code :

• Laissez toute la fenêtre de 20 minutes courir ; certaines plateformes mettent leurs messages sortants en file d'attente.
• Vérifiez si le service refuse les numéros virtuels. Plusieurs le font, et c'est précisément le cas pour lequel le remboursement automatique existe.
• Réessayez après une pause, ou utilisez une autre route de service, plutôt que de recommander en boucle serrée.
• Annulez les activations abandonnées pour que l'argent revienne tout de suite.

L'article sur le routage OTP par pays explique pourquoi une même application peut se comporter différemment d'une route pays à l'autre.

Existe-t-il un numéro suisse longue durée ?

Pas en libre-service. Pour la Suisse, OTP Route propose uniquement des numéros à usage unique via l'OTP Gateway.

Les numéros virtuels dédiés, que vous conservez tant qu'ils sont renouvelés, sont limités aux États-Unis et au Canada et démarrent à $1.95/month. Si vous avez précisément besoin d'une ligne suisse persistante, écrivez à [email protected] en décrivant votre cas d'usage ; la réponse dépend de la réglementation locale et ne peut pas être promise à l'avance.

Portefeuille, factures et sandbox pour le routage OTP suisse

Vous payez à l'usage depuis un seul portefeuille USD prépayé. Il n'y a ni abonnement mensuel ni formule à choisir. Alimentez-le par carte ou en USDT/USDC, et une facture PDF est envoyée par e-mail pour chaque recharge, ce qui facilite la comptabilité des entités suisses qui rapprochent leurs comptes en francs.

Pour le travail d'intégration, demandez le mode sandbox sur un compte de développement. Il renvoie des numéros et des codes simulés afin de tester tout le parcours de l'API de vérification par SMS sans dépenser les fonds du portefeuille. N'utilisez les activations réelles que pour vos propres produits et comptes, dans le respect des conditions de chaque service et de la politique d'utilisation acceptable d'OTP Route. La page de la solution de tests QA montre comment les équipes l'intègrent à leurs contrôles de version.

Questions fréquentes

Quel identifiant de pays l'API utilise-t-elle pour la Suisse ?

La Suisse est ch. Les requêtes suisses portent cette valeur de deux lettres partout où un pays est attendu, y compris dans le corps de l'activation.

Puis-je tester un parcours de connexion suisse sans posséder de SIM suisse ?

Oui. Un numéro +41 pour les tests, obtenu depuis l'OTP Gateway, reçoit le code, que vous lisez ensuite dans le tableau de bord ou via l'API.

Dois-je conserver le 0 en enregistrant un mobile suisse ?

Non. Le 0 est un préfixe de ligne national ; stockez la forme E.164 qui commence par +41 suivi de neuf chiffres.

Dans quelle langue sera un SMS de vérification suisse ?

Cela dépend de l'expéditeur : l'allemand, le français, l'italien ou l'anglais sont tous courants. Extrayez le code avec un motif de chiffres plutôt qu'avec une formulation fixe.

Combien coûte un SMS OTP pour la Suisse ?

À partir de $0.20 par code, le prix exact par service étant renvoyé par GET /api/v1/prices avant que vous ne commandiez.

Que devient mon argent si aucun code n'arrive ?

Il retourne automatiquement sur votre portefeuille à la fermeture de la fenêtre ou quand vous annulez l'activation.

Le Liechtenstein est-il couvert par la route suisse ?

Non, le Liechtenstein a son propre indicatif +423 et sa propre page dans la liste des pays ; commandez-le donc séparément.

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.