Codes de vérification du Paraguay (+595), l'API d'abord

Comment demander un numéro +595 en code ?

Commencez dans la console développeur et créez une clé Bearer ; les clés commencent par or_live_ et vous pouvez en détenir jusqu'à 10, ce qui facilite des clés distinctes pour le staging et la CI. Tous les appels vont vers https://otproute.com/api/v1.

1. Mettez en cache le catalogue depuis GET /api/v1/services et GET /api/v1/countries. Le Paraguay apparaît sous py.
2. Avant chaque commande, lisez GET /api/v1/prices?country=py&service=<id>. Le prix et la disponibilité sont des valeurs en direct, pas des constantes.
3. Commandez avec POST /api/v1/activations et {"service": "whatsapp", "country": "py"}. Conservez l'identifiant d'activation de la réponse.
4. Saisissez le numéro dans le parcours que vous testez.
5. Attendez le webhook ou consultez GET /api/v1/activations/{id} ; appelez POST /api/v1/activations/{id}/cancel si le test s'arrête plus tôt.

GET /api/v1/balance est utile comme étape préalable dans un pipeline, pour qu'un job échoue bruyamment sur un portefeuille vide au lieu d'expirer. Le guide d'intégration détaille les mêmes appels avec plus de contexte.

Que doit faire le gestionnaire de webhook avec un code paraguayen ?

Votre endpoint reçoit activation.sms_received à l'arrivée du message, activation.expired quand la fenêtre se ferme à vide, et activation.cancelled après une annulation. Chacun est rattaché à l'identifiant d'activation.

• Vérifiez d'abord. Séparez X-OTPRoute-Signature en t et v1, calculez le HMAC-SHA256 de l'horodatage, d'un point et du corps brut de la requête avec le secret de l'endpoint, et comparez en temps constant.
• Rejetez les requêtes périmées. Un horodatage très éloigné de votre horloge signale un rejeu ou un serveur fortement décalé.
• Soyez idempotent. Stockez l'identifiant d'activation et ignorez les répétitions, pour qu'une livraison réessayée ne traite jamais un code deux fois.

Jusqu'à 5 endpoints webhook sont autorisés par compte. Si vous préférez le polling, gardez un intervalle modéré ; la limite est de 300 requêtes par minute pour l'ensemble du compte. Le guide des webhooks HMAC propose une liste de contrôle plus complète.

Quels services sont ouverts sur les routes paraguayennes ?

Le Paraguay propose actuellement plus de 1 600 services. Parmi les plus demandés : WhatsApp, Instagram, Telegram, Uber, Facebook, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, X (Twitter), Discord, LinkedIn, Netflix et ChatGPT (OpenAI). WhatsApp est la messagerie du quotidien pour beaucoup de gens dans la région : c'est donc souvent le premier service que les équipes vérifient quand elles testent un support par messagerie.

Comment s'écrivent et se normalisent les numéros mobiles +595 ?

Le Paraguay utilise le préfixe national 0 pour la composition en national : un numéro mobile vu localement commence donc par 09. En E.164, ce 0 disparaît : la forme canonique est +595 suivi de neuf chiffres, les mobiles commençant par 9. Normalisez à la saisie, ne stockez que la forme E.164 et mettez en forme pour l'affichage en périphérie. Des règles de validation qui attendent une longueur fixe issue d'un autre pays sont une cause courante d'échec d'inscription pour les utilisateurs paraguayens : incluez donc un numéro +595 dans vos cas de test de validation.

L'espagnol et le guarani sont tous deux langues officielles. Les messages de vérification des services internationaux arrivent plutôt en espagnol ou en anglais selon le modèle et les réglages du compte. Analysez le code avec un motif composé uniquement de chiffres et gardez les corps de message en UTF-8 pour que les caractères accentués et le ñ survivent à la journalisation.

Pourquoi des équipes vérifient-elles des comptes au Paraguay ?

Le Paraguay fait partie du Mercosur et se trouve entre l'Argentine, le Brésil et la Bolivie ; les entreprises déjà actives dans la région l'ajoutent donc souvent à un déploiement sud-américain. Parmi les raisons habituelles d'y tester : la QA de localisation en espagnol pour un public paraguayen, la confirmation qu'un parcours d'inscription régional accepte les numéros +595, les équipes d'exploitation qui vérifient des profils professionnels pour des clients locaux, et le support aux Paraguayens à l'étranger qui s'inscrivent avec leur numéro du pays. La page vérification d'applications mobiles décrit comment ces contrôles s'intègrent aux tests de livraison.

Existe-t-il un moyen sans code d'obtenir un numéro de vérification paraguayen ?

Oui. Dans le tableau de bord, ouvrez l'OTP Gateway, choisissez le Paraguay et un service, vérifiez le prix puis confirmez. Copiez le numéro dans l'application, puis laissez l'activation ouverte jusqu'à ce que le code apparaisse à côté. Les commandes via le navigateur et via l'API puisent dans le même portefeuille et le même historique.

Que faire quand un code +595 n'apparaît pas ?

Laissez à l'activation la fenêtre complète de 20 minutes avant de tirer des conclusions. Si elle se ferme à vide, le montant est rendu automatiquement. Passez ensuite en revue les causes habituelles : le service refuse peut-être les numéros virtuels, la route est peut-être saturée à cette heure, ou une autre route de service peut aboutir plus tard. Ne lancez pas de commandes répétées en boucle serrée ; ajoutez un délai croissant entre les tentatives et consignez les identifiants d'activation pour repérer des schémas par service.

Puis-je garder un numéro paraguayen à long terme, et comment fonctionne la facturation ?

Les lignes de longue durée ne sont pas vendues en libre-service pour le Paraguay. Les Dedicated Virtual Numbers n'existent qu'aux États-Unis et au Canada, dès $1.95/mois ; un compte qui doit pouvoir se reconnecter est donc souvent rattaché à l'un de ces numéros. Pour vous renseigner sur une ligne paraguayenne de longue durée, écrivez à [email protected] ; la réponse dépend de la réglementation locale.

La facturation repose sur un portefeuille USD prépayé : rechargez par carte ou en USDT/USDC, recevez une facture PDF par e-mail et ne payez que les codes qui arrivent. Les comptes de développement peuvent passer en sandbox sur demande pour des numéros et des codes simulés. OTP Route sert à tester et à exploiter vos propres produits légitimes ; respectez les conditions de chaque service et la politique d'utilisation acceptable.

Questions fréquentes

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

C'est py. Utilisez-le dans la requête de prix et dans le corps de POST /api/v1/activations.

Dois-je enregistrer les numéros paraguayens avec le préfixe 09 ?

Non. Supprimez le 0 national et enregistrez +595 suivi du numéro national de neuf chiffres.

Combien coûte un numéro +595 pour les tests ?

Une activation paraguayenne coûte dès $0.20 par code selon le service, et le portefeuille n'est débité que pour un code qui arrive réellement.

Puis-je tester un parcours d'inscription en espagnol pour le Paraguay sans SIM locale ?

Oui. Commandez un numéro de vérification paraguayen sur l'OTP Gateway et lisez le code dans le tableau de bord ou via l'API.

Les codes arriveront-ils en guarani ?

Rarement, voire jamais. Les services internationaux envoient généralement un texte en espagnol ou en anglais : analysez donc uniquement les chiffres.

Que devient mon argent si l'activation expire ?

Quand aucun SMS n'arrive dans la fenêtre de 20 minutes, la totalité du montant retourne automatiquement dans votre portefeuille.

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.