Codes de vérification salvadoriens (+503) pour les équipes QA et de lancement

Code à usage unique ou ligne longue durée : que faut-il pour un test salvadorien ?

Partez de la forme du test, car elle détermine le produit.

• Une seule étape de vérification (inscription, changement de téléphone, vérification renforcée) correspond à l'OTP Gateway. Vous commandez un numéro +503 pour un service, le code arrive une fois, et le numéro a terminé son travail.
• Un compte qui doit se reconnecter pendant des semaines a besoin d'une ligne qui vous appartient. Les Dedicated Numbers sont un produit États-Unis/Canada dès $1.95/mois, achetés instantanément depuis le tableau de bord, avec SMS entrants, SMS sortants et appels depuis le navigateur.

Pour le Salvador, il n'existe pas de Dedicated Number en libre-service. Si votre équipe a réellement besoin d'une ligne salvadorienne longue durée, écrivez à [email protected] ; sa mise en place dépend de la réglementation locale et n'est pas garantie. De nombreuses équipes résolvent le cas de la « reconnexion répétée » avec une ligne américaine, lorsque le service testé l'accepte. Pour un déploiement salvadorien, pesez les deux options avec les notes sur les numéros temporaires et dédiés.

Comment stocker et valider les numéros +503 ?

Le Salvador utilise un plan de numérotation fermé à 8 chiffres, sans préfixe de tronc. Le numéro qu'un habitant écrit dans un formulaire est le même que les 8 chiffres qui suivent le +503 à l'international : la normalisation consiste donc surtout à retirer la ponctuation, les habitants écrivant souvent les mobiles en deux blocs de quatre séparés par un trait d'union.

• Stockez la forme E.164, +503 suivi de huit chiffres, dans une seule colonne.
• Les numéros de mobile commencent généralement par 6 ou 7 ; les lignes fixes commencent généralement par 2. Un validateur qui n'accepte que ces chiffres initiaux détecte la plupart des fautes de frappe.
• Rejetez un 0 initial superflu. Les utilisateurs habitués à d'autres plans latino-américains en ajoutent parfois un, et certaines plateformes SMS abandonnent alors le message sans le dire.

Les modèles de SMS de votre application pour ce marché sont normalement en espagnol. Des caractères comme á, í ou ó sortent de l'alphabet GSM de base : un modèle qui les utilise peut basculer en encodage UCS-2 et raccourcir chaque segment. Placez le code près du début du message pour qu'il survive à un découpage.

Pourquoi les équipes testent-elles les parcours d'inscription au Salvador ?

Quelques schémas reviennent régulièrement :

• Lancements en Amérique centrale. Un produit déployé au Guatemala, au Honduras et au Salvador veut vérifier l'étape téléphonique de chaque pays avant la mise en ligne des publicités.
• Clients de la diaspora. De nombreux Salvadoriens vivent aux États-Unis et gardent un numéro +503 pour leur famille : les produits de transferts d'argent, de paiement et de messagerie voient donc des numéros salvadoriens même lorsque l'adresse de l'utilisateur est américaine. Voir l'onboarding fintech pour ce parcours.
• QA de localisation. Les textes en espagnol, le sélecteur de pays et les masques de saisie ont tous besoin d'un vrai code salvadorien pour confirmer que les écrans fonctionnent de bout en bout.
• Tarification en dollars américains. Le dollar américain est la monnaie officielle du Salvador, ce qui fait de ce marché un endroit commode pour tester ensemble le paiement et l'onboarding.

À quoi ressemble la séquence d'appels de l'API OTP Salvador ?

Toutes les requêtes vont vers https://otproute.com/api/v1 avec une clé Bearer préfixée or_live_, créée dans la console Développeur (jusqu'à 10 clés, 300 requêtes par minute). L'identifiant de pays du Salvador est sv.

1. Récupérez GET /api/v1/countries et GET /api/v1/services et mettez les identifiants en cache.
2. Lisez le prix en direct avec GET /api/v1/prices?country=sv&service=<id> ; il indique aussi si une route est disponible à l'instant.
3. Créez la commande avec POST /api/v1/activations et un corps tel que {"service": "telegram", "country": "sv"}. Enregistrez l'identifiant d'activation et le numéro.
4. Faites envoyer à ce numéro le SMS de vérification par la version salvadorienne de votre application.
5. Attendez l'événement activation.sms_received sur votre endpoint ; à défaut, interrogez GET /api/v1/activations/{id} toutes les quelques secondes.
6. Si le parcours est abandonné, appelez POST /api/v1/activations/{id}/cancel pour que les fonds reviennent aussitôt.

Chaque webhook porte X-OTPRoute-Signature: t=<unix>,v1=<hex>, un HMAC-SHA256 de l'horodatage, d'un point et du corps brut avec le secret de votre endpoint. Vérifiez-le et écartez les horodatages périmés ; la sécurisation des webhooks OTP en détaille le principe. Les non-développeurs peuvent faire la même chose depuis le tableau de bord : choisissez le Salvador, choisissez un service, confirmez le prix en direct et regardez le code apparaître sur la carte d'activation.

Quels services peuvent être vérifiés sur un numéro salvadorien ?

Le relevé en direct montre plus de 900 services disposant de routes pour le Salvador. Parmi les plus populaires : WhatsApp, Facebook, Instagram, TikTok, Uber, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Telegram, Signal, LinkedIn et ChatGPT (OpenAI). La disponibilité évolue au fil de la journée : c'est donc le endpoint des prix, et non une liste figée, qui doit piloter votre exécuteur de tests.

Certains services refusent les numéros qu'ils classent comme virtuels. Cela échappe à notre contrôle, et c'est la raison d'être de la règle de remboursement.

Et si le code salvadorien n'arrive jamais ?

Un code +503 lent n'est pas encore un code raté : laissez donc la commande ouverte pendant les 20 minutes complètes. Si rien n'arrive, la commande expire, activation.expired se déclenche et la totalité du montant retourne automatiquement sur votre portefeuille. Ensuite :

• vérifiez que le service accepte les numéros virtuels pour ce type d'étape ;
• réessayez plus tard, ou choisissez une autre route de service, plutôt que de recommander en boucle serrée ;
• vérifiez que votre propre application a bien envoyé le SMS au numéro exact renvoyé, en forme E.164.

D'autres pistes de dépannage adaptées à l'Amérique centrale figurent dans la réduction des échecs de livraison OTP.

Comment la facturation est-elle gérée pour les commandes du Salvador ?

OTP Route utilise un seul portefeuille USD prépayé, à l'usage, sans abonnement mensuel ni formule à choisir. Le rechargement se fait par carte ou en stablecoins USDT/USDC, et une facture PDF arrive dans votre boîte mail après chaque recharge ou achat de numéro. Pour l'intégration, un compte de développement peut être basculé en sandbox sur demande, avec des numéros et des codes simulés pour exécuter toute la boucle sans dépenser les fonds du portefeuille. Les tarifs actuels sont sur la page des tarifs.

Questions fréquentes

Puis-je tester l'inscription de mon application au Salvador sans carte SIM locale ?

Oui. Commandez un numéro +503 auprès de l'OTP Gateway pour le service testé, déclenchez le SMS et lisez le code dans le tableau de bord ou via l'API.

Les numéros salvadoriens ont-ils un préfixe de tronc comme le 0 ?

Non. Les numéros du Salvador comptent huit chiffres sans préfixe de tronc : la forme internationale est donc simplement +503 suivi de ces huit chiffres.

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

Utilisez sv dans les requêtes de prix et dans le corps de l'activation, par exemple GET /api/v1/prices?country=sv&service=<id>.

Suis-je débité si le numéro +503 ne reçoit jamais de code ?

Non. Si aucun SMS n'arrive dans la fenêtre de 20 minutes, ou si vous annulez avant, la totalité du montant est automatiquement recréditée sur votre portefeuille.

Puis-je garder un numéro salvadorien pour des connexions répétées ?

Pas en libre-service. Les Dedicated Numbers longue durée sont proposés aux États-Unis et au Canada ; pour le Salvador, vous pouvez écrire à [email protected] pour poser la question, sans promesse de disponibilité.

OTP Route est-il fait pour créer de nombreux comptes ?

Non. Il sert à tester et à exploiter vos propres produits et comptes légitimes, dans le respect des conditions de chaque service et de la politique d'utilisation acceptable d'OTP Route.

Puis-je exécuter le parcours salvadorien en CI sans dépenser d'argent ?

Oui. Un compte de développement peut être basculé en sandbox sur demande ; il renvoie des numéros et des codes simulés pour que votre pipeline exerce tout le chemin de l'API.

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.