Automatizzare la verifica SMS +260 per i test di registrazione in Zambia

Quali endpoint chiama un'integrazione con l'API OTP per lo Zambia?

L'integrazione è una breve catena di chiamate HTTPS a https://otproute.com/api/v1, ciascuna con Authorization: Bearer e una chiave con prefisso or_live_. L'id paese dello Zambia è zm.

• GET /api/v1/countries e GET /api/v1/services: dati di riferimento, si possono tenere in cache per un giorno.
• GET /api/v1/prices?country=zm&service=<id>: prezzo in tempo reale e se quella route può accettare un ordine in questo momento.
• POST /api/v1/activations con {"service": "whatsapp", "country": "zm"}: restituisce l'id di attivazione e un numero +260.
• GET /api/v1/activations/{id}: stato e, una volta ricevuto, il codice.
• POST /api/v1/activations/{id}/cancel: restituisci il numero in anticipo.
• GET /api/v1/balance: eseguilo per primo, così una suite di test si ferma subito con un wallet vuoto.

Genera le chiavi nella console Developer, fino a 10 per account; una per ambiente è uno schema ordinato. Il limite dell'account è di 300 richieste al minuto. Gli schemi completi sono nella documentazione dell'API.

Come va scritto il webhook che riceve i codici +260?

Il polling funziona, ma quando più attivazioni girano insieme un webhook è più pulito. Aggiungi fino a 5 endpoint nella console Developer e iscriviti a activation.sms_received, activation.expired e activation.cancelled.

Ogni richiesta porta X-OTPRoute-Signature: t=<unix>,v1=<hex>. Costruisci la stringa <t>.<raw body>, calcola l'HMAC-SHA256 con il secret dell'endpoint e confrontalo con v1 a tempo costante. Usa i byte grezzi così come ricevuti, rifiuta i timestamp più vecchi di pochi minuti e salva i risultati con chiave l'id dell'attivazione, così una consegna ripetuta non cambia nulla. Rispondi in fretta con un 2xx e svolgi il lavoro lento dopo. La nostra guida su come proteggere i webhook OTP con HMAC ha più dettagli, e test degli OTP SMS nelle pipeline CI mostra dove si inserisce in una build.

Da quali servizi può ricevere codici un numero di verifica dello Zambia?

L'istantanea in tempo reale colloca lo Zambia a più di 1.100 servizi. Tra questi: WhatsApp, Facebook, Google (Gmail & YouTube), Telegram, Instagram, TikTok, X (Twitter), LinkedIn, Uber, imo, Microsoft & Outlook, Amazon e Netflix. Poiché le route cambiano ora per ora, lascia che sia l'endpoint dei prezzi a dire al tuo codice cosa è aperto prima di ordinare.

Formato dei numeri zambiani e lingue in cui arrivano i codici

I numeri zambiani si compongono a livello nazionale con un prefisso 0, poi nove cifre. In forma internazionale lo zero scompare, dando +260 seguito da nove cifre. Normalizza tutto in quella forma E.164 prima di salvare e assicurati che il tuo campo di input accetti sia lo stile locale che gli utenti digitano davvero sia quello internazionale.

L'inglese è la lingua ufficiale e lingue come bemba, nyanja, tonga e lozi sono molto parlate. L'SMS di verifica arriva normalmente in inglese, il che semplifica l'analisi, ma cerca comunque le cifre così che un cambio di formulazione da parte del mittente non rompa i tuoi test.

I team testano sullo Zambia quando si espandono nell'Africa australe, costruiscono l'onboarding per prodotti di mobile money o di credito, o supportano clienti da un centro operativo regionale. La pagina sull'onboarding fintech tratta questo scenario.

Si può fare la stessa cosa dalla dashboard?

Sì, ed è comodo per i controlli occasionali. Accedi, apri l'OTP Gateway, scegli il servizio e lo Zambia, guarda il prezzo mostrato e ordina. Inserisci il numero +260 nell'app; il codice compare nella dashboard quando arriva. Annulla un'attivazione che non ti serve più e il suo importo torna sul wallet.

Cosa fare se il codice non arriva, e quando è meglio una linea dedicata?

Le attivazioni durano 20 minuti e paghi solo quando il codice arriva. Se la finestra scade o annulli, l'intero importo torna automaticamente. Alcuni servizi rifiutano i numeri virtuali, ed è il motivo del rimborso. Quando un codice +260 è lento: attendi la fine della finestra, riprova più tardi o con un'altra route di servizio, controlla che il servizio accetti numeri virtuali ed evita di rifare l'ordine in un ciclo serrato.

Per un account che dovrà accedere di nuovo o recuperare l'accesso più avanti, un numero monouso è lo strumento sbagliato. I Dedicated Virtual Numbers svolgono quel ruolo, ma solo negli Stati Uniti e in Canada, da $1.95/mese. OTP Route non ha una linea zambiana a lungo termine in self-service; se hai una reale necessità scrivi a [email protected], tenendo presente che decidono le norme locali e nulla è garantito.

Usa i numeri solo per i tuoi prodotti e account legittimi, rispetta i termini di ciascun servizio e ricorda che si applica l'Acceptable Use Policy di OTP Route.

Come si fattura e si testa in sicurezza un'integrazione con lo Zambia?

Un unico wallet USD prepagato finanzia tutto; non c'è canone mensile né piano. Ricarichi con carta o USDT/USDC e ogni volta ricevi una fattura PDF via email. Durante lo sviluppo, richiedi la modalità sandbox per il tuo account di sviluppo: numeri e codici simulati ti permettono di provare l'intero percorso del routing OTP senza spendere dal wallet. Le tariffe aggiornate sono nella pagina dei prezzi.

Domande frequenti

Quale id paese usa OTP Route per lo Zambia?

zm, come in POST /api/v1/activations con {"service": "telegram", "country": "zm"}.

Posso ricevere codici SMS OTP dello Zambia senza una SIM zambiana?

Sì. L'OTP Gateway fornisce un numero +260 per i test e il codice ti arriva nella dashboard, tramite webhook o con il polling.

Come salvo correttamente i numeri +260?

Elimina il prefisso nazionale 0 e salva +260 più nove cifre in E.164. Formatta per la visualizzazione separatamente.

Il denaro viene rimborsato se WhatsApp o un altro servizio rifiuta il numero?

Sì. Quando entro 20 minuti non arriva alcun codice, o se annulli, l'importo viene riaccreditato automaticamente sul tuo wallet.

Posso tenere un numero zambiano per accessi futuri?

Non in self-service. I numeri a lungo termine sono un prodotto per Stati Uniti e Canada; scrivi a [email protected] per chiedere dello Zambia, senza alcuna promessa.

Posso provare l'integrazione prima di pagare codici reali?

Sì. Richiedi la modalità sandbox su un account di sviluppo per ottenere numeri e codici simulati per i test end-to-end.

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.