Intégrer les codes de vérification argentins (+54) à votre application

Quels sont les quatre appels API derrière une activation +54 ?

Tout se passe sous https://otproute.com/api/v1 avec une authentification par clé Bearer commençant par or_live_. Les clés sont émises dans la console développeur ; un compte peut en détenir jusqu'à 10 et enregistrer 5 endpoints webhook, avec un plafond de 300 requêtes par minute.

1. Demandez le prix. Appelez GET /api/v1/prices?country=ar&service=<id> pour que votre code connaisse le coût réel avant d'engager les fonds du portefeuille. L'identifiant de pays de l'Argentine est ar.
2. Passez la commande. Envoyez POST /api/v1/activations avec le corps JSON {"service": "whatsapp", "country": "ar"}, en remplaçant par l'identifiant de service dont votre test a besoin. La réponse contient un identifiant d'activation et le numéro +54 à saisir dans l'application testée.
3. Attendez le code. Lisez GET /api/v1/activations/{id} à intervalle raisonnable, ou laissez le webhook activation.sms_received vous prévenir que le code est arrivé.
4. Libérez-la plus tôt si nécessaire. POST /api/v1/activations/{id}/cancel met fin à une activation dont vous n'avez plus besoin et rend l'argent au portefeuille.

Pour voir les identifiants avant de les coder en dur, GET /api/v1/services et GET /api/v1/countries listent ce que la plateforme propose actuellement. La documentation de référence complète se trouve dans la documentation.

Comment rendre fiable le récepteur de webhooks pour les codes argentins ?

Chaque livraison comprend un en-tête X-OTPRoute-Signature de la forme t=<unix>,v1=<hex>. Reconstruisez la chaîne "<t>.<raw body>", calculez le HMAC-SHA256 avec le secret de cet endpoint et comparez le résultat à v1 avec une fonction à temps constant. Rejetez toute requête dont l'horodatage est périmé, car une signature ancienne mais valide ressemble exactement à un rejeu.

En plus de activation.sms_received, abonnez-vous à activation.expired et activation.cancelled afin qu'un exécuteur de tests ne reste jamais bloqué à attendre un numéro déjà fermé. Considérez chaque événement comme indexé sur l'identifiant d'activation et écrivez votre gestionnaire de sorte qu'une seconde livraison du même événement ne change rien. L'article sur la signature et la vérification des webhooks OTP détaille davantage la logique de comparaison.

Quelles applications puis-je vérifier avec un numéro argentin ?

Le relevé en direct pour l'Argentine indique plus de 2 000 services. Voici ceux que les équipes produit et QA argentines utilisent le plus souvent :

• Messagerie : WhatsApp, Telegram, Signal, Discord
• Comptes et productivité : Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI)
• Réseaux sociaux et vidéo : Instagram, TikTok
• Commerce et mobilité : Amazon, Uber, Airbnb, Netflix

Cette liste évolue dans la journée, d'où l'intérêt d'une API qui renvoie la disponibilité en direct plutôt qu'un tableau figé. Interrogez GET /api/v1/services en pensant au pays ar avant le lancement d'une tâche CI planifiée, et échouez vite avec un message clair si votre service cible est momentanément absent.

Pourquoi les numéros mobiles argentins perturbent-ils les validateurs ?

L'Argentine possède l'un des plans de numérotation les plus singuliers de la région. À l'échelle nationale, on écrit un 0 d'interurbain avant l'indicatif régional et, pour les mobiles, un 15 avant les chiffres de l'abonné : un portable de Buenos Aires peut ainsi apparaître sous la forme 011 15 suivi de huit chiffres. Au format international E.164, ces deux éléments disparaissent et un 9 s'insère juste après l'indicatif pays : +54 9 11, puis le numéro d'abonné à huit chiffres.

Cette différence compte pour quiconque stocke des numéros. Normalisez tout en E.164 avant d'enregistrer, supprimez le 0 et le 15 à la saisie, et ajoutez le 9 pour les mobiles. Un validateur qui ne contrôle que la longueur acceptera volontiers une valeur +54 11 de type fixe, incapable de recevoir des SMS. Utilisez le numéro exactement tel que l'API le renvoie plutôt que de le reformater vous-même.

Les codes envoyés aux numéros argentins arrivent généralement en espagnol, souvent avec une formule comme « Tu código es » autour des chiffres. Extrayez le code numérique avec un motif plutôt qu'en vous appuyant sur le libellé, car les modèles changent. Les équipes testent ici lorsqu'elles se lancent en Amérique latine, vérifient un texte en espagnol rioplatense (les formes locales en vos diffèrent de l'espagnol des manuels), gèrent des opérations régionales ou servent des Argentins vivant à l'étranger qui s'inscrivent encore avec une SIM +54.

Quelqu'un sans code peut-il commander un numéro +54 ?

Oui. Le support, la croissance et les agences peuvent tout faire depuis le navigateur :

1. Créez un compte sur signup avec une adresse e-mail et un code à 6 chiffres, ou avec la connexion Google.
2. Alimentez le portefeuille.
3. Ouvrez l'OTP Gateway, choisissez l'Argentine, puis le service que vous testez.
4. Vérifiez le prix affiché, confirmez et copiez le numéro +54 dans l'écran de vérification de l'application.
5. Suivez l'activation ; le code y apparaît dès sa réception.

Le tableau de bord et l'API s'appuient sur le même portefeuille et les mêmes activations : un développeur peut donc reprendre, grâce à son identifiant d'activation, un numéro commandé par un collègue.

Le code argentin n'est jamais arrivé. Et maintenant ?

Chaque activation reste ouverte 20 minutes. Si rien n'arrive, ou si vous annulez avant, le montant total retourne automatiquement au portefeuille : une route silencieuse vous coûte donc du temps, pas de l'argent. La vitesse de livraison dépend du service et de la route ; laissez à la fenêtre une vraie chance avant de conclure à l'échec.

Passez ensuite en revue cette courte liste :

• Redemandez le code une fois depuis l'application, puis laissez courir la fenêtre.
• Réessayez plus tard dans la journée, ou commandez via une autre route pour le même service.
• Vérifiez que le service accepte bien les numéros virtuels ; certains les rejettent, ce qui explique le remboursement automatique.
• Évitez de recommander en boucle serrée depuis la CI. Ajoutez un délai croissant entre tentatives et un plafond de nouvelles tentatives.

Notre article sur la réduction des échecs de livraison OTP présente d'autres schémas pour les routes argentines. Gardez chaque test dans le cadre des conditions du service concerné ; la politique d'utilisation acceptable d'OTP Route s'applique aussi.

Peut-on conserver une ligne argentine, et comment payer ?

Il n'existe aujourd'hui aucun numéro longue durée en libre-service pour l'Argentine. Si votre équipe a besoin d'une ligne +54 persistante, écrivez à [email protected] en décrivant le cas d'usage ; la faisabilité dépend de la réglementation locale et n'est pas garantie. Les Numéros virtuels dédiés, que vous conservez tant qu'ils sont renouvelés et qui transfèrent les SMS entrants vers votre webhook, sont un produit réservé aux États-Unis et au Canada, à partir de $1.95/mois.

La facturation passe par un seul portefeuille prépayé en USD, sans abonnement mensuel et sans formule à choisir. Rechargez par carte ou en USDT/USDC ; chaque recharge génère une facture PDF envoyée par e-mail. Les détails figurent sur la page des tarifs. Avant de dépenser de vrais fonds, demandez que votre compte de développement passe en sandbox, qui renvoie des numéros et des codes simulés afin de répéter tout le parcours Argentine de bout en bout.

Questions fréquentes

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

C'est ar. Passez-le dans le champ country de POST /api/v1/activations et dans la chaîne de requête de GET /api/v1/prices.

Dois-je ajouter le 9 quand je saisis le numéro +54 dans une application ?

Utilisez le numéro exactement comme OTP Route le renvoie. Dans votre propre base, stockez les mobiles argentins au format E.164, qui inclut le 9 après +54 et supprime le 0 et le 15 nationaux.

Combien coûte la réception d'un SMS OTP d'Argentine ?

À partir de $0.20 par code, selon le service. Le montant exact est renvoyé par GET /api/v1/prices et affiché avant que vous ne confirmiez une commande.

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

Oui. Commandez une activation Argentine pour votre propre application ou pour le service tiers de votre test, saisissez le numéro +54 et lisez le code dans le tableau de bord ou depuis votre webhook.

Le même numéro +54 fonctionnera-t-il pour une connexion le mois prochain ?

Non. Un numéro de passerelle couvre un seul code en 20 minutes. Pour des comptes qui doivent continuer à recevoir des codes, un Numéro dédié aux États-Unis ou au Canada est l'option adaptée.

Dans quelle langue sera le SMS de vérification argentin ?

Généralement en espagnol, mais cela dépend de l'expéditeur et des paramètres de langue du compte. Extrayez les chiffres plutôt que de vous fier aux mots environnants.

L'interrogation est-elle acceptable à la place des webhooks ?

Oui. Interrogez GET /api/v1/activations/{id} à intervalle modéré et restez bien en dessous de la limite de 300 requêtes par minute et par compte.

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.