Recevoir des OTP Zalo sur des numéros OTP Route via l'API

À quoi ressemble le flux de l'API de code de vérification Zalo ?

L'identifiant du service est zalo. Les appels vont vers https://otproute.com/api/v1 avec une clé Bearer préfixée or_live_, émise dans la console Développeur.

1. Récupérez les identifiants de pays avec GET /api/v1/countries ; le Vietnam, par exemple, a pour identifiant vn.
2. Vérifiez le prix et la disponibilité en direct avec GET /api/v1/prices?country=vn&service=zalo.
3. Créez l'activation : POST /api/v1/activations avec {"service": "zalo", "country": "vn"}. Conservez l'identifiant d'activation et le numéro renvoyé.
4. Saisissez le numéro sur l'écran téléphone de Zalo, pour le compte de test que vous contrôlez.
5. Récupérez le code par webhook ou par interrogation, ou mettez fin à la commande avec POST /api/v1/activations/{id}/cancel.

Un contrôle du solde avec GET /api/v1/balance au démarrage de la suite évite les mauvaises surprises en cours d'exécution. Consultez la documentation de l'API pour la forme complète des requêtes.

Construire un récepteur de webhook pour les codes Zalo

Enregistrez un point d'accès dans la console Développeur et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled. Chaque requête porte un en-tête X-OTPRoute-Signature de la forme t=<unix>,v1=<hex> ; calculez le HMAC-SHA256 de <t>.<raw body> avec le secret du point d'accès, comparez en temps constant et rejetez les horodatages anciens.

Rendez le traitement idempotent en indexant les résultats stockés sur l'identifiant d'activation. Si le même événement est livré deux fois, la seconde écriture doit être sans effet. Les équipes sans point d'accès public peuvent interroger GET /api/v1/activations/{id} à la place ; la limite de 300 requêtes par minute laisse de la marge pour un intervalle d'interrogation court sur plusieurs tests en parallèle.

Quand Zalo demande-t-il un numéro de téléphone ?

Zalo est une application vietnamienne de messagerie et de réseau social, et le numéro de téléphone y sert d'identifiant principal du compte. Un code est généralement demandé à la création d'un compte, à la connexion sur un nouvel appareil et lors de la récupération d'accès. Les étapes exactes sont décidées par Zalo et peuvent changer ; un plan de test doit donc couvrir chaque écran plutôt que de supposer une séquence fixe.

Pour les équipes QA, cela compte : une intégration de messagerie, une mini-application ou un canal de support client construit autour de Zalo a souvent besoin d'un compte de test neuf et vérifié avant tout autre scénario.

Dans quels pays peut-on recevoir un OTP Zalo avec OTP Route ?

Les routes Zalo sont listées dans 198 pays. On y trouve le Vietnam, les États-Unis, le Japon, la Corée du Sud, Taïwan, l'Australie, le Canada, le Cambodge, le Laos, la Thaïlande, la Malaisie, Singapour, l'Allemagne, la France et le Royaume-Uni.

Choisissez le pays qui correspond au compte que vous testez. Un lancement au Vietnam exige des numéros en +84 pour reproduire ce que voient les utilisateurs locaux, tandis qu'une équipe qui sert les communautés vietnamiennes à l'étranger voudra peut-être des numéros des pays où vivent ces clients. Le pays influe aussi sur le prix et la disponibilité, ce qui justifie de consulter d'abord le point d'accès des prix.

Étapes du tableau de bord pour un test de vérification SMS Zalo

Tout le monde sur un projet n'écrit pas du code. Dans le tableau de bord, choisissez Zalo comme service, sélectionnez le pays, confirmez le prix affiché et passez commande. Copiez le numéro dans Zalo ; le code apparaît à côté de la commande dès que le SMS arrive. Une annulation depuis le même écran rend la totalité du montant. L'inscription au tableau de bord demande une adresse e-mail et un code e-mail à 6 chiffres, ou la connexion Google, et l'authentification à deux facteurs TOTP peut protéger la connexion de l'équipe.

Pourquoi un code Zalo peut-il ne pas arriver ?

La livraison dépend du service et de la route ; il n'y a donc pas de délai fixe. Zalo peut aussi refuser certains numéros virtuels, ce qui explique le remboursement. Si rien n'apparaît :

• Laissez la commande ouverte jusqu'à la fin de la fenêtre de 20 minutes, ou annulez-la ; dans les deux cas, le portefeuille récupère l'argent.
• Réessayez plus tard, ou passez à un autre pays adapté au test.
• Ne recommandez pas en boucle serrée ; ajoutez un délai croissant entre les tentatives dans les tâches automatisées.
• Vérifiez que le compte de test lui-même n'est pas bloqué ni limité en fréquence côté Zalo.

Un compte de test Zalo doit-il utiliser un Dedicated Number ?

Un numéro de l'OTP Gateway ne traite qu'un code. Si un compte de préproduction ou de support doit se reconnecter le mois prochain, un Dedicated Number convient mieux : une ligne américaine ou canadienne à partir de $1.95/mois que vous gardez tant qu'elle se renouvelle, avec réception des SMS entrants dans le tableau de bord et sur le webhook number.sms_received. Pour en savoir plus, voir numéros virtuels.

Utilisez l'une ou l'autre option de façon responsable. Respectez les conditions de Zalo, gardez un compte par personne réelle ou par entreprise, et n'utilisez OTP Route que pour tester et exploiter vos propres comptes et produits légitimes. Zalo est une marque de son propriétaire, et OTP Route n'y est pas affilié.

Questions fréquentes

Quel identifiant de service l'API d'OTP Route utilise-t-elle pour Zalo ?

C'est zalo, envoyé dans le corps de POST /api/v1/activations avec un identifiant de pays.

Puis-je recevoir un OTP Zalo sur un numéro hors du Vietnam ?

Oui. Les routes Zalo sont listées dans 198 pays, et la disponibilité de chacune est renvoyée en direct par le point d'accès des prix.

Suis-je facturé si Zalo rejette le numéro virtuel ?

Non. Si aucun code n'arrive sur le numéro en 20 minutes, ou si vous annulez, la totalité du montant est remboursée sur le portefeuille.

Un numéro virtuel pour Zalo convient-il à un compte dont j'ai besoin à long terme ?

Un numéro à usage unique, non. Pour des connexions récurrentes, un Dedicated Number américain ou canadien que vous gardez tant qu'il se renouvelle est le choix le plus sûr.

Comment payer la vérification SMS Zalo pour les tests ?

Rechargez un portefeuille prépayé en USD par carte ou en USDT/USDC ; il n'y a pas d'abonnement mensuel, et chaque recharge donne lieu à une facture PDF.

Puis-je essayer l'intégration Zalo sans dépenser d'argent ?

Oui. Une fois qu'un compte de développement est passé en sandbox par le support, les commandes Zalo renvoient des numéros et des codes simulés, ce qui permet de valider le code du webhook et de l'interrogation avant toute dépense réelle.

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.