Intégrer les codes de vérification capverdiens (+238) à votre pile de test

Quels endpoints une activation +238 sollicite-t-elle ?

Une intégration d'API OTP pour le Cabo Verde ne demande qu'une courte liste d'appels sous https://otproute.com/api/v1. Chaque requête porte une clé Bearer commençant par or_live_, générée dans la console Développeur. L'identifiant de pays du Cabo Verde est cv ; l'identifiant de service est la valeur api_service de l'application que vous testez.

1. GET /api/v1/services et GET /api/v1/countries récupèrent les catalogues ; mettez-les en cache pour la journée.
2. GET /api/v1/prices?country=cv&service=<id> lit le prix actuel et indique si une route est ouverte à cet instant. L'inventaire bouge au fil de la journée : interrogez-le avant chaque commande plutôt que de coder quoi que ce soit en dur.
3. POST /api/v1/activations avec {"service": "whatsapp", "country": "cv"} renvoie un identifiant d'activation et le numéro +238 à saisir dans votre formulaire d'inscription.
4. GET /api/v1/activations/{id} permet d'interroger l'arrivée du code si vous n'utilisez pas de webhooks.
5. POST /api/v1/activations/{id}/cancel libère le numéro quand un test s'interrompt, afin que la retenue retourne au portefeuille.

Un appel préalable à GET /api/v1/balance permet à une suite de s'arrêter tôt plutôt que d'échouer en cours de route. Le plafond est de 300 requêtes par minute et par compte, et la référence de l'API liste chaque champ.

Comment accepter le webhook signé pour un code du Cabo Verde ?

L'interrogation convient à un script isolé ; dès que plusieurs tâches tournent en parallèle, un webhook est plus propre. Enregistrez un endpoint dans la console Développeur (un compte peut en détenir cinq) et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled.

Chaque POST arrive avec un en-tête X-OTPRoute-Signature de la forme t=<unix>,v1=<hex>. Reconstituez la chaîne <t>.<raw body>, signez-la en HMAC-SHA256 avec le secret de cet endpoint, et comparez le résultat à v1 par une vérification en temps constant. Écartez tout ce dont l'horodatage date de plus de quelques minutes afin qu'une requête capturée ne puisse pas être rejouée. Ensuite, basez votre traitement sur l'identifiant d'activation : si le même événement arrive deux fois, la seconde copie ne doit rien changer. Notre article sur la sécurisation des webhooks OTP avec HMAC couvre les cas limites.

Quelles applications peuvent envoyer des codes à un numéro capverdien aujourd'hui ?

Le catalogue en direct pour cv couvre plus de 800 services. Parmi les plus populaires ouverts en ce moment : WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Viber, Telegram et Netflix. Lisez cette liste comme un instantané : les routes s'ouvrent et se ferment selon la capacité des partenaires, et c'est tout l'intérêt d'un routage OTP via une API qui signale la disponibilité en temps réel plutôt qu'une page qui la promet.

Si personne dans l'équipe n'écrit de code, le tableau de bord remplit le même rôle. Choisissez le service, choisissez le Cabo Verde, confirmez le prix à l'écran et copiez le numéro. Le code apparaît sur la fiche d'activation dès son arrivée.

À quoi ressemble un numéro +238 une fois stocké ?

Le Cabo Verde utilise un plan de numérotation fermé : des numéros nationaux à sept chiffres et aucun préfixe de ligne, donc pas de zéro initial à retirer. En E.164, un numéro est simplement +238 suivi de ces sept chiffres. La normalisation est donc triviale, mais la faible longueur fait trébucher les validateurs qui supposent que tout numéro d'abonné est plus long, une raison courante pour laquelle un formulaire rejette une saisie capverdienne parfaitement valide. Stockez la chaîne E.164, formatez-la comme votre interface le préfère, et ajoutez un cas +238 à vos tests unitaires du champ téléphone.

Le portugais est la langue officielle, tandis que le créole capverdien est ce que la plupart des gens parlent au quotidien ; vérifiez donc comment un modèle d'OTP en portugais s'affiche sur un téléphone là-bas. Les équipes prennent généralement un numéro +238 pour tester à cause de la diaspora : les communautés capverdiennes des États-Unis, du Portugal et d'ailleurs en Europe gardent des comptes liés à des numéros du pays, et les produits de transfert d'argent, de voyage et de messagerie veulent que ces inscriptions fonctionnent.

Qu'advient-il du portefeuille si aucun SMS n'arrive en 20 minutes ?

Chaque activation reste ouverte 20 minutes. Si un code arrive dans ce délai, le débit est maintenu ; si la fenêtre se ferme à vide, ou si vous annulez avant, la totalité du montant retourne sur votre portefeuille sans ticket de support. Quand rien ne vient :

• Laissez la fenêtre aller à son terme au lieu de lancer une nouvelle commande toutes les quelques secondes ; une boucle de relance serrée ne fait qu'immobiliser des fonds.
• Réessayez plus tard, ou faites passer le même parcours par une autre route de service.
• Vérifiez que l'application accepte les numéros virtuels ; certaines les refusent par politique, et le remboursement existe précisément pour ce cas.
• Assurez-vous que votre formulaire a bien soumis le numéro +238 complet et non une version tronquée.

Le guide sur la réduction des échecs de livraison OTP approfondit le diagnostic.

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

Pas en libre-service. Les Dedicated Numbers d'OTP Route, des lignes de longue durée avec SMS entrants et sortants, appels depuis le navigateur et transfert par webhook, sont un produit réservé aux États-Unis et au Canada, à partir de $1.95/mois. Il n'existe pas de ligne +238 de longue durée en libre-service. Si votre équipe en a réellement besoin, écrivez à [email protected] ; la faisabilité dépend de la réglementation locale et n'est pas assurée. Pour un compte de préproduction qui doit se reconnecter encore et encore, un numéro virtuel américain ou canadien est souvent la réponse pratique.

Comment l'utilisation est-elle facturée et testée avant la mise en production ?

La facturation repose sur un portefeuille prépayé unique en USD, sans frais mensuels ni palier de formule. Rechargez par carte ou en stablecoins USDT/USDC ; chaque recharge est accompagnée d'une facture PDF envoyée par e-mail, ce qui simplifie le rapprochement comptable. Avant que des clés de production ne touchent le portefeuille, demandez le passage de votre compte de développement en sandbox : il renvoie des numéros et des codes simulés, de sorte que la commande, le webhook et l'annulation de votre client d'API de vérification SMS peuvent tourner en CI sans rien dépenser. Voir les tarifs et la vue d'ensemble des tests QA. Respectez en permanence les conditions de chaque service et la politique d'utilisation acceptable d'OTP Route.

Questions fréquentes

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

Oui. Commandez un numéro +238 sur l'OTP Gateway, saisissez-le dans votre formulaire d'inscription et lisez le code depuis le tableau de bord, l'API ou un webhook. Personne dans l'équipe n'a besoin d'être sur les îles.

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

C'est cv. Passez-le comme country dans POST /api/v1/activations et dans la requête de prix.

Dois-je ajouter un 0 avant un numéro capverdien ?

Non. Le Cabo Verde n'a pas de préfixe de ligne : la forme internationale est simplement +238 suivi du numéro national à sept chiffres.

Combien coûte un numéro de vérification du Cabo Verde ?

Les tarifs de l'OTP Gateway démarrent à $0.20 par code et varient selon le service ; l'API et le tableau de bord affichent le prix exact avant la commande. Vous n'êtes facturé que si un code arrive.

Toutes les applications enverront-elles des codes à un numéro virtuel capverdien ?

Non. Certains services refusent les numéros virtuels, et les routes changent au cours de la journée. Si aucun code n'arrive dans les 20 minutes, le montant est recrédité sur le portefeuille.

Existe-t-il un sandbox pour tester l'intégration +238 ?

Oui, sur demande. Un compte de développement peut passer en mode sandbox, qui renvoie des numéros et des codes simulés afin que l'intégration tourne de bout en bout sans dépense du 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.