Recevoir des codes SMS OTP néo-zélandais par API ou depuis le tableau de bord

Numéro +64 temporaire ou ligne longue durée : lequel choisir ?

Bien choisir le produit dès le départ évite de tout reprendre ensuite.

Choisissez l'OTP Gateway lorsqu'un test ou une étape d'inscription n'a besoin que d'un seul code : un nouveau compte de QA, un test de fumée de votre écran d'inscription pour la Nouvelle-Zélande, la vérification qu'un parcours de client néo-zélandais fonctionne de bout en bout. Vous obtenez un numéro, un code, puis la session se ferme.

Choisissez un Dedicated Number lorsque le même compte doit se reconnecter des semaines plus tard, ou qu'une équipe partage un numéro de récupération. Ces lignes longue durée ne sont proposées qu'aux États-Unis et au Canada, dès $1.95/month, avec les SMS entrants transmis sous forme d'événements number.sms_received.

Pour la Nouvelle-Zélande elle-même, il n'existe pas de numéro longue durée en libre-service. Écrivez à [email protected] si votre cas l'exige ; la réponse dépend de la réglementation locale et peut être négative. Les appels, les SMS sortants et les conditions de renouvellement de ces lignes nord-américaines sont détaillés sur la page numéros virtuels.

Pourquoi les équipes produit testent-elles les inscriptions en Nouvelle-Zélande ?

La Nouvelle-Zélande est un marché de lancement progressif très courant pour les applications en anglais : un public plus restreint, une langue familière et un fuseau horaire en avance en font un bon endroit pour observer de vrais parcours d'inscription avant un déploiement plus large. L'étape de vérification +64 est donc souvent le premier parcours de production que découvre un nouveau marché, et elle mérite ses propres cas de test.

Quelques points méritent d'être couverts :

• Langue. L'anglais, le te reo māori et la langue des signes néo-zélandaise sont officiels. La plupart des services envoient les codes en anglais, mais si vos propres modèles utilisent des mots māori avec macrons (ā, ō, ū), ces caractères sortent du jeu GSM-7 et font passer le SMS en UCS-2, ce qui raccourcit chaque segment.
• Changements de date. La Nouvelle-Zélande est l'un des premiers endroits à entrer dans un nouveau jour calendaire ; la logique d'expiration et de limitation de débit basée sur les dates peut donc se comporter différemment pour les utilisateurs locaux.
• Adéquation au marché. Un compte de QA vérifié avec un numéro local exerce la même logique pays que celle que rencontreront vos utilisateurs néo-zélandais.

Pour un modèle de validation avant mise en production fondé sur ce type de contrôles, consultez nos notes sur les tests QA.

Comment stocker et normaliser les numéros mobiles +64 ?

La Nouvelle-Zélande utilise le préfixe de ligne 0. Un mobile écrit au format national 021 123 4567 devient +64211234567 en E.164 : on retire le 0 initial, puis on ajoute +64. Les plages mobiles commencent par 2 une fois le zéro retiré, et leur longueur varie ; ne codez donc jamais en dur un nombre de chiffres unique.

Règles pratiques pour votre schéma :

• Stockez une seule chaîne E.164 canonique ; ne formatez qu'au moment de l'affichage.
• Acceptez les saisies avec espaces, tirets ou zéro initial, puis normalisez avec une bibliothèque d'analyse de numéros maintenue.
• Ajoutez des jeux de test pour les écritures nationale et internationale, ainsi que pour un numéro collé avec +64 et le 0 conservé.

Quelles applications envoient des codes aux numéros néo-zélandais sur OTP Route ?

La route +64 couvre plus de 800 services. D'après l'état actuel, les plus utilisés comprennent Google (Gmail & YouTube), WhatsApp, Telegram, Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord, Snapchat, LinkedIn, Uber et Netflix.

Comme la disponibilité est en temps réel, interrogez GET /api/v1/countries et GET /api/v1/services au début de chaque exécution plutôt que de conserver une liste en cache pendant des semaines. Si un service est peu présent sur +64, la route voisine Australie est le repli habituel pour une comparaison en anglais.

À quoi ressemble la séquence de l'API OTP pour la Nouvelle-Zélande ?

Chaque appel +64 va vers https://otproute.com/api/v1 avec une clé Bearer or_live_ émise dans la console développeur. La séquence :

1. Lisez le prix en direct avec GET /api/v1/prices?country=nz&service=uber.
2. Créez l'activation avec POST /api/v1/activations et le corps {"service": "uber", "country": "nz"}.
3. Récupérez le code en interrogeant GET /api/v1/activations/{id}, ou laissez activation.sms_received arriver sur votre webhook. activation.expired et activation.cancelled vous indiquent quand nettoyer.
4. Annulez les commandes inutilisées avec POST /api/v1/activations/{id}/cancel, et surveillez vos fonds avec GET /api/v1/balance.

Pour les webhooks, vérifiez X-OTPRoute-Signature en calculant le HMAC-SHA256 de <t>.<raw body> avec le secret du point de terminaison, rejetez les horodatages anciens et rendez le gestionnaire idempotent sur l'identifiant d'activation, afin qu'une livraison rejouée ne cause aucun dommage. Le guide d'intégration propose un pas-à-pas plus complet ; la limite est de 300 requêtes par minute et par compte.

Une personne non développeuse peut-elle commander un numéro de vérification néo-zélandais ?

Absolument. Dans le tableau de bord, choisissez la Nouvelle-Zélande, sélectionnez le service, vérifiez le prix affiché, puis confirmez. Le numéro +64 apparaît dans la commande ; saisissez-le dans l'application, demandez le SMS, et le code s'affiche sur la même fiche dès son arrivée. Tout se passe dans la fenêtre de 20 minutes : gardez donc l'application cible ouverte avant de commander.

Que faire si le code +64 n'arrive jamais ?

Laissez d'abord la fenêtre aller à son terme, soit 20 minutes, car certains expéditeurs retardent ou regroupent leurs SMS. Si rien n'arrive, le service refuse peut-être les numéros virtuels, ou la route est saturée ; réessayez plus tard ou testez avec une autre route de service au lieu d'enchaîner les commandes. Les commandes sans réponse, ainsi que celles que vous annulez, sont remboursées automatiquement sur le portefeuille. La facturation fonctionne à l'usage depuis un portefeuille USD prépayé : recharge par carte ou en USDT/USDC, facture PDF pour chacune, aucun abonnement mensuel, et mode sandbox sur demande pour les essais. OTP Route est destiné à vos propres comptes et produits légitimes, dans le respect des conditions de chaque service et de notre politique d'utilisation acceptable.

Questions fréquentes

Puis-je tester le parcours d'inscription néo-zélandais de mon application sans carte SIM locale ?

Oui. Commandez un numéro +64 sur l'OTP Gateway, utilisez-le dans votre formulaire d'inscription et lisez le code dans le tableau de bord ou via l'API.

Faut-il conserver le 0 en enregistrant un mobile néo-zélandais ?

Non. Le 0 de ligne est supprimé en E.164 : 021 123 4567 s'enregistre donc sous la forme +64211234567.

Quel est l'identifiant de pays de la Nouvelle-Zélande dans l'API ?

C'est nz, utilisé dans les consultations de prix et dans le corps de la requête d'activation.

Combien coûte un code de vérification néo-zélandais ?

Les prix démarrent à $0.20 par code et dépendent du service ; le tableau de bord et GET /api/v1/prices affichent le montant exact avant la commande.

Puis-je louer un numéro néo-zélandais pour quelques mois ?

Il n'existe pas de ligne +64 longue durée en libre-service. Les Dedicated Numbers sont un produit réservé aux États-Unis et au Canada, et vous pouvez écrire à [email protected] pour vous renseigner sur les autres pays.

Vaut-il mieux interroger l'API ou utiliser un webhook pour récupérer les codes +64 ?

L'interrogation est plus simple pour un script isolé ; un webhook signé passe mieux à l'échelle quand de nombreux tests s'exécutent en parallèle. Les deux renvoient le même code.

Toutes les applications accepteront-elles un numéro néo-zélandais OTP Route ?

Pas nécessairement. Certains services rejettent les numéros virtuels, ce qui explique qu'une commande sans SMS soit remboursée automatiquement.

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.