Codes de vérification +351 par programmation pour vos lancements au Portugal

Quels endpoints une vérification +351 sollicite-t-elle ?

L'URL de base est https://otproute.com/api/v1, et chaque requête porte une clé Bearer commençant par or_live_. L'identifiant de pays du Portugal est pt.

1. GET /api/v1/countries et GET /api/v1/services vous donnent les identifiants ; mettez-les en cache pour la durée d'une exécution de test.
2. GET /api/v1/prices?country=pt&service=<id> renvoie le prix actuel et indique si la route est ouverte.
3. POST /api/v1/activations avec {"service": "telegram", "country": "pt"} réserve le numéro et renvoie un identifiant d'activation.
4. GET /api/v1/activations/{id} indique l'état et le code, si vous préférez le polling.
5. POST /api/v1/activations/{id}/cancel libère un numéro dont votre test n'a plus besoin.
6. GET /api/v1/balance permet à un pipeline de s'arrêter tôt quand le portefeuille est bas.

Les limites du compte sont de 10 clés d'API, 5 endpoints de webhook et 300 requêtes par minute. Les schémas complets figurent dans la référence de l'API.

Comment les webhooks signés livrent-ils les codes portugais à notre service ?

Enregistrez un endpoint HTTPS dans la console développeur et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled. Chaque POST contient l'en-tête X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Pour le vérifier, reconstituez la chaîne <t>.<raw body>, calculez le HMAC-SHA256 avec le secret de l'endpoint, puis comparez le résultat à v1 avec une comparaison en temps constant. Refusez les requêtes dont l'horodatage est trop ancien, afin qu'une requête interceptée ne puisse pas être rejouée. Conservez l'identifiant d'activation de chaque événement et ignorez les doublons : votre gestionnaire reste ainsi sûr en cas de nouvelle tentative de livraison. Le schéma est détaillé pas à pas dans la capture d'OTP par webhook.

Quels services sont ouverts sur les routes portugaises ?

Le Portugal affiche plus de 2 000 services dans l'instantané actuel. Parmi les plus utilisés : WhatsApp, Telegram, Airbnb, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Netflix, Discord et Signal.

Cet ensemble évolue au fil de la journée, au gré de la capacité de nos partenaires opérateurs. C'est pourquoi c'est l'endpoint des prix, et non un fichier de configuration statique, qui doit décider si un test s'exécute.

Pourquoi les équipes produit testent-elles avec des numéros portugais ?

Le Portugal figure souvent tôt dans un plan de déploiement européen. Lisbonne et Porto accueillent de nombreuses équipes produit et d'ingénierie, et beaucoup d'entreprises font du Portugal leur base européenne. Il y a aussi une raison de localisation : le portugais européen (pt-PT) diffère du portugais brésilien par l'orthographe, le vocabulaire et les formes d'adresse, si bien qu'un parcours traduit pour le Brésil peut sembler étrange à quelqu'un au Portugal. Réaliser une vraie vérification +351 permet aux relecteurs de voir ensemble le texte pt-PT, le SMS reçu et les écrans qui l'entourent.

Au regard du RGPD, garder les numéros de téléphone des collaborateurs hors des comptes de test et des comptes partagés relève aussi de la minimisation des données. Un numéro à usage unique par vérification, c'est moins d'identifiants personnels dans vos systèmes de QA. Le guide des pipelines CI montre comment intégrer cela à chaque build.

Comment les numéros +351 sont-ils formatés et stockés ?

Le Portugal n'a pas de préfixe de ligne : les numéros comptent neuf chiffres et se composent de la même façon en local et en format international après +351. Les numéros mobiles commencent par 9, tandis que les lignes fixes géographiques commencent par 2. Stockez-les en E.164, rejetez tout ce qui ne compte pas neuf chiffres après l'indicatif du pays, et supprimez les espaces que les utilisateurs ajoutent en saisissant des groupes de trois chiffres.

Les codes entrants arrivent généralement en portugais ou en anglais, selon l'expéditeur et la langue définie pour le compte. Votre extracteur de code doit chercher les chiffres, pas une formule fixe.

Un collègue peut-il le faire sans code, et que faire si aucun SMS n'arrive ?

Dans le tableau de bord, ouvrez l'OTP Gateway, choisissez le Portugal et un service, vérifiez le prix en direct, puis passez la commande. Collez le numéro dans votre application et attendez le code sur la page d'activation.

La fenêtre dure 20 minutes, et vous ne payez que si le code arrive ; sinon, la totalité du montant retourne automatiquement dans le portefeuille. Si un code manque :

• Laissez la fenêtre aller à son terme plutôt que d'annuler au bout de quelques secondes.
• Vérifiez que le service accepte les numéros virtuels dans ce parcours.
• Réessayez plus tard, ou testez le même écran avec une autre route de service.
• Espacez les tentatives au lieu de recommander en boucle serrée.

Existe-t-il une ligne portugaise dédiée, et comment fonctionne la facturation ?

OTP Route ne vend pas de numéros dédiés en libre-service au Portugal. Les numéros virtuels dédiés n'existent que pour les États-Unis et le Canada, à partir de $1.95/mois ; pour une ligne +351 de longue durée, écrivez à [email protected], en sachant que la disponibilité dépend de la réglementation locale et n'est pas assurée. Consultez les différences entre numéros temporaires et dédiés.

Le paiement se fait à l'usage depuis un portefeuille prépayé en USD, sans abonnement mensuel ni formule, alimenté par carte ou en USDT/USDC, et chaque recharge s'accompagne d'une facture PDF. Les comptes de développement peuvent passer en sandbox sur demande pour tester avec des numéros et des codes simulés. Respectez les conditions de chaque service ; la politique d'utilisation acceptable d'OTP Route s'applique.

Questions fréquentes

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

C'est pt, utilisé à la fois dans la requête de prix et dans le corps de la demande d'activation.

Les numéros de téléphone portugais utilisent-ils un préfixe de ligne comme un 0 initial ?

Non. Les numéros portugais comptent neuf chiffres sans préfixe de ligne ; la forme E.164 est donc +351 suivi de ces neuf chiffres.

Puis-je tester un parcours d'inscription pt-PT sans carte SIM portugaise ?

Oui. Un numéro +351 de test issu de l'OTP Gateway reçoit le code, que vous lisez dans le tableau de bord ou via l'API.

Combien coûte un numéro de vérification pour le Portugal ?

À partir de $0.20 par code ; le prix exact dépend du service et s'affiche avant la commande.

Vais-je payer une activation +351 qui ne reçoit rien ?

Non. Les activations expirées ou annulées sont intégralement remboursées sur votre portefeuille.

Puis-je louer un numéro portugais pour des connexions récurrentes ?

Pas en libre-service. Les lignes de longue durée sont un produit réservé aux États-Unis et au Canada ; écrivez au support si vous avez besoin d'une ligne +351.

Faut-il utiliser le polling ou les webhooks pour les codes portugais ?

Les webhooks passent mieux à l'échelle pour les tâches parallèles, tandis que le polling de GET /api/v1/activations/{id} convient aux runners qui ne peuvent pas accepter de trafic entrant.

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.