Portare i codici di verifica capoverdiani (+238) nel tuo stack di test

Quali endpoint tocca un'attivazione +238?

Un'integrazione con l'API OTP di Capo Verde richiede solo un breve elenco di chiamate sotto https://otproute.com/api/v1. Ogni richiesta porta una chiave Bearer che inizia con or_live_, generata nella console sviluppatori. L'id paese di Capo Verde è cv; l'id del servizio è il valore api_service dell'app che stai testando.

1. GET /api/v1/services e GET /api/v1/countries recuperano i cataloghi; mettili in cache per la giornata.
2. GET /api/v1/prices?country=cv&service=<id> legge il prezzo corrente e dice se una rotta è aperta in questo momento. L'inventario cambia durante la giornata, quindi interrogalo prima di ogni ordine invece di fissare valori nel codice.
3. POST /api/v1/activations con {"service": "whatsapp", "country": "cv"} restituisce un id di attivazione più il numero +238 da inserire nel tuo modulo di registrazione.
4. GET /api/v1/activations/{id} permette di fare polling per il codice se non usi i webhook.
5. POST /api/v1/activations/{id}/cancel rilascia il numero quando un test viene interrotto, così l'importo trattenuto torna nel wallet.

Una chiamata a GET /api/v1/balance prima dell'esecuzione permette alla suite di fermarsi subito invece di fallire a metà. Il limite è di 300 richieste al minuto per account e il riferimento API elenca ogni campo.

Come accetto il webhook firmato per un codice di Capo Verde?

Il polling va bene per un singolo script; quando più job girano in parallelo, un webhook è più ordinato. Registra un endpoint nella console sviluppatori (un account ne può avere cinque) e iscriviti a activation.sms_received, activation.expired e activation.cancelled.

Ogni POST arriva con un header X-OTPRoute-Signature nella forma t=<unix>,v1=<hex>. Ricostruisci la stringa <t>.<raw body>, firmala con HMAC-SHA256 usando il secret di quell'endpoint e confronta il risultato con v1 tramite un controllo in tempo costante. Scarta tutto ciò che ha un timestamp più vecchio di pochi minuti, così una richiesta intercettata non può essere riproposta. Poi basa l'elaborazione sull'id di attivazione: se lo stesso evento arriva due volte, la seconda copia non deve cambiare nulla. Il nostro articolo su come proteggere i webhook OTP con HMAC copre i casi limite.

Quali app possono inviare codici a un numero capoverdiano oggi?

Il catalogo live per cv copre più di 800 servizi. Tra i più diffusi attualmente aperti ci sono WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Viber, Telegram e Netflix. Considera quell'elenco un'istantanea: le rotte si aprono e si chiudono in base alla capacità dei partner, ed è proprio questo il senso dell'instradamento OTP tramite un'API che segnala la disponibilità in tempo reale invece di una pagina che la promette.

Se nessuno nel team scrive codice, la dashboard fa lo stesso lavoro. Scegli il servizio, scegli Capo Verde, conferma il prezzo a schermo e copia il numero. Il codice compare sulla scheda dell'attivazione quando arriva.

Che aspetto ha un numero +238 quando lo si memorizza?

Capo Verde usa un piano di numerazione chiuso: numeri nazionali di sette cifre e nessun prefisso di linea, quindi non c'è uno zero iniziale da eliminare. In E.164 un numero è semplicemente +238 seguito da quelle sette cifre. La normalizzazione è quindi banale, ma la lunghezza ridotta inganna i validatori che presumono numeri più lunghi, ed è un motivo frequente per cui un modulo rifiuta un numero capoverdiano perfettamente valido. Salva la stringa E.164, formattala come preferisce la tua interfaccia e aggiungi un caso +238 ai test unitari del campo telefono.

Il portoghese è la lingua ufficiale, mentre il creolo capoverdiano è quello che la maggior parte delle persone parla ogni giorno, quindi controlla come appare su un telefono del posto un modello OTP in portoghese. I team di solito prendono un numero +238 per i test a causa della diaspora: le comunità capoverdiane negli Stati Uniti, in Portogallo e altrove in Europa mantengono account legati a numeri del paese d'origine, e i prodotti di rimesse, viaggi e messaggistica vogliono che quelle registrazioni funzionino.

Cosa succede al wallet se nessun SMS arriva entro 20 minuti?

Ogni attivazione resta aperta per 20 minuti. Se un codice arriva in quella finestra, l'addebito resta; se la finestra si chiude vuota, o annulli prima, l'intero importo torna nel wallet senza bisogno di un ticket di assistenza. Quando non arriva nulla:

• Lascia che la finestra faccia il suo corso invece di lanciare un nuovo ordine ogni pochi secondi; un ciclo di retry serrato blocca solo fondi.
• Riprova più tardi, oppure prova lo stesso flusso su un'altra rotta di servizio.
• Verifica che l'app accetti numeri virtuali; alcune li rifiutano per policy, e il rimborso esiste proprio per questo caso.
• Controlla che il tuo modulo abbia inviato il numero +238 completo e non uno troncato.

La guida su come ridurre i fallimenti nella consegna degli OTP approfondisce la diagnosi.

Posso tenere un numero di Capo Verde per accessi ripetuti?

Non in modalità self-service. I Numeri Dedicati di OTP Route, cioè linee a lungo termine con SMS in entrata e in uscita, chiamate dal browser e inoltro via webhook, sono un prodotto solo per Stati Uniti e Canada, da $1.95/month. Non esiste una linea +238 a lungo termine in self-service. Se il tuo team ne ha davvero bisogno, scrivi a [email protected]; la fattibilità dipende dalle norme locali e non è assicurata. Per un account di staging che deve accedere più volte, un numero virtuale statunitense o canadese è spesso la risposta pratica.

Come si fattura l'uso e come si testa prima del lancio?

La fatturazione passa da un unico wallet prepagato in USD, senza canone mensile e senza livelli di piano. Ricarica con carta o con stablecoin USDT/USDC; ogni ricarica include una fattura PDF via email, che semplifica la riconciliazione contabile. Prima che le chiavi di produzione tocchino il wallet, chiedi di passare il tuo account di sviluppo alla sandbox: restituisce numeri e codici simulati, così il percorso di ordine, webhook e annullamento del tuo client per l'API di verifica SMS può girare in CI senza spendere nulla. Vedi i prezzi e la panoramica sul QA testing. Rispetta sempre i termini di ogni servizio e l'Acceptable Use Policy di OTP Route.

Domande frequenti

Posso testare il flusso di registrazione della mia app per Capo Verde senza una SIM locale?

Sì. Ordina un numero +238 dall'OTP Gateway, inseriscilo nel modulo di registrazione e leggi il codice dalla dashboard, dall'API o da un webhook. Nessuno del team deve trovarsi sulle isole.

Qual è l'id di Capo Verde nell'API di OTP Route?

È cv. Passalo come country in POST /api/v1/activations e nella query dei prezzi.

Devo aggiungere uno 0 prima di un numero capoverdiano?

No. Capo Verde non ha prefisso di linea, quindi la forma internazionale è semplicemente +238 più il numero nazionale di sette cifre.

Quanto costa un numero di verifica di Capo Verde?

I prezzi dell'OTP Gateway partono da $0.20 per codice e variano in base al servizio; l'API e la dashboard mostrano il prezzo esatto prima dell'ordine. Paghi solo se un codice arriva.

Ogni app invierà codici a un numero virtuale capoverdiano?

No. Alcuni servizi rifiutano i numeri virtuali e le rotte cambiano durante la giornata. Se nessun codice arriva entro 20 minuti, l'importo torna nel wallet.

Esiste una sandbox per testare l'integrazione +238?

Sì, su richiesta. Un account di sviluppo può essere passato alla modalità sandbox, che restituisce numeri e codici simulati così l'integrazione gira end to end senza spesa dal wallet.

I nomi dei servizi sono marchi dei rispettivi proprietari. OTP Route non è affiliata a essi. Usa i numeri in modo lecito e rispetta i termini di ciascun servizio e la nostra Politica di Utilizzo Accettabile.