Testare i codici di registrazione macedoni (+389) prima del lancio

La checklist di lancio dice «verifica le registrazioni +389»: da dove parte il QA?

Una situazione familiare: il prodotto si espande nei Balcani occidentali, il flusso di registrazione gestisce già una dozzina di mercati e qualcuno deve dimostrare che accetta i numeri macedoni e che l'SMS inviato dalla tua app arrivi davvero. Chiedere in prestito il telefono di un collega non scala, e una SIM locale è scomoda da tenere dentro un runner CI.

L'OTP Gateway elimina questa dipendenza. Richiedi un numero di verifica della Macedonia del Nord tramite API o dashboard, lo inserisci nel tuo flusso e raccogli il codice che arriva. Ogni numero serve per una sola verifica, quindi una suite di regressione può richiedere un numero +389 nuovo per i test a ogni esecuzione. La panoramica sul QA testing mostra come i team lo integrano in un processo di rilascio.

Come si scrivono i numeri +389 e cosa deve accettare il tuo validatore?

Il prefisso internazionale della Macedonia del Nord è +389 e il prefisso nazionale (trunk) è 0. I cellulari si scrivono localmente come 07X XXX XXX; in formato internazionale lo 0 scompare e si ottiene +389 7X XXX XXX, con un numero nazionale di otto cifre. Salva la forma E.164 (+3897…) e considera il formato locale solo come formato di input.

Casi di test da tenere nella suite:

• L'utente seleziona +389 e digita comunque lo 0: il modulo dovrebbe eliminarlo invece di rifiutare l'input.
• I numeri incollati con spazi, barre o trattini devono normalizzarsi in un unico valore salvato.
• I controlli sugli intervalli spettano a una libreria di numeri di telefono mantenuta, non a prefissi scritti a mano, perché gli intervalli degli operatori cambiano nel tempo.

Perché i template SMS in cirillico meritano un test a parte?

Il macedone è la lingua ufficiale in tutto il paese e si scrive in cirillico; anche l'albanese ha status ufficiale ed è molto diffuso. Se la tua app invia il messaggio di verifica in macedone, i caratteri cirillici impongono la codifica UCS-2, che riduce un singolo segmento SMS da 160 a 70 caratteri. Un template che in inglese ci sta comodamente può spezzarsi in più segmenti, o essere troncato se il tuo mittente limita la lunghezza.

Ricevere il messaggio reale su un numero +389 ti mostra cosa vedrebbe un utente: se il codice compare abbastanza presto da essere leggibile nell'anteprima della notifica, se scatta un fallback in alfabeto latino e se i suggerimenti di autocompletamento funzionano ancora. Il tuo parser dovrebbe cercare le cifre e non una frase fissa, perché i servizi di terze parti scelgono da sé formulazione e lingua.

Quali chiamate recuperano un numero della Macedonia del Nord via programmazione?

La documentazione per sviluppatori copre ogni campo; lo schema di questa API di verifica SMS è breve. Autenticati con una chiave Bearer che inizia con or_live_ su https://otproute.com/api/v1, poi:

1. Carica l'elenco dei paesi con GET /api/v1/countries; l'id della Macedonia del Nord è mk.
2. Chiedi a GET /api/v1/prices?country=mk&service=<id> il prezzo e la disponibilità in tempo reale.
3. Crea l'attivazione con POST /api/v1/activations e un corpo come {"service": "viber", "country": "mk"}.
4. Fai polling su GET /api/v1/activations/{id}, oppure attendi activation.sms_received su un webhook.
5. Annulla con POST /api/v1/activations/{id}/cancel quando un test termina in anticipo.

Le chiamate webhook portano X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ricostruisci l'HMAC-SHA256 su "<t>.<raw body>" con il segreto dell'endpoint, confronta in tempo costante, respingi i timestamp vecchi e basa l'elaborazione sull'id di attivazione, così un nuovo recapito è innocuo. Ogni account dispone di fino a 10 chiavi, 5 endpoint webhook e 300 richieste al minuto.

Quali servizi sono aperti ora sulla rotta +389?

La Macedonia del Nord conta attualmente più di 900 servizi sull'OTP Gateway. L'istantanea in tempo reale comprende Viber, WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), TikTok, Microsoft & Outlook, Signal, LinkedIn, Uber e ChatGPT (OpenAI).

Non tutti i servizi sono aperti a ogni ora; è normale per l'offerta di SMS ed è il motivo per cui prezzi e disponibilità sono forniti dall'API. I colleghi che lavorano senza codice possono eseguire gli stessi passaggi nella dashboard: crea un account, ricarica, scegli Macedonia del Nord e il servizio, e il codice compare nella pagina dell'attivazione appena arriva.

Il codice non è arrivato: e adesso?

Ogni attivazione dura 20 minuti e paghi solo se l'SMS arriva. Se la annulli o lasci chiudere la finestra a vuoto, l'intero importo torna automaticamente nel wallet.

Prima di ordinare di nuovo:

• Aspetta la fine della finestra; un mittente lento è molto più comune di un messaggio perso.
• Verifica che il servizio accetti i numeri virtuali; alcuni li rifiutano per policy, ed è esattamente ciò che copre il rimborso.
• Riprova più tardi o tramite un'altra rotta di servizio.
• Inserisci una pausa tra i tentativi, così un test instabile non lancia ordine dopo ordine sulla rotta +389.

La guida al routing per paese spiega come pianificare i fallback tra i mercati. Limita l'uso ai tuoi prodotti e account, rispetta i termini di ciascun servizio e ricorda che si applica l'Acceptable Use Policy di OTP Route.

E per una linea macedone permanente, la fatturazione e la sandbox?

OTP Route non offre un numero a lungo termine in self-service nella Macedonia del Nord. I Dedicated Numbers sono un prodotto per Stati Uniti e Canada, venduti subito da $1.95/mese; per una linea +389 duratura scrivi a [email protected] e il team ti dirà se le norme locali lo consentono, senza promessa di disponibilità.

Il pagamento è a consumo da un wallet USD prepagato, ricaricabile con carta o USDT/USDC, senza canone mensile e con una fattura PDF per ogni ricarica. Gli account di sviluppo possono essere passati alla sandbox su richiesta, così le integrazioni girano su numeri e codici simulati.

Domande frequenti

Posso verificare l'SMS di registrazione macedone della mia app senza SIM?

Sì. Richiedi un numero OTP Gateway con country mk, usalo sulla tua schermata di registrazione e leggi il messaggio nella dashboard o da un webhook.

Quanto costa un codice di verifica +389?

Da $0.20 per codice; l'importo esatto dipende dal servizio ed è mostrato nella dashboard o restituito da GET /api/v1/prices. Se la finestra di 20 minuti si chiude senza SMS, ricevi indietro l'intero importo.

I messaggi di verifica verso i numeri della Macedonia del Nord saranno in cirillico?

Dipende dal mittente. La tua app controlla il proprio template, mentre i servizi di terze parti scelgono la lingua in base alle impostazioni dell'account o del dispositivo, quindi analizza le cifre.

Il mio database deve conservare lo 0 iniziale dei cellulari macedoni?

Conserva piuttosto il formato E.164: +389 seguito dal numero nazionale di otto cifre, senza 0 di trunk e senza spazi.

Posso tenere un numero della Macedonia del Nord per accessi ripetuti?

Non in self-service. I Dedicated Numbers a lungo termine esistono solo per Stati Uniti e Canada; per +389 scrivi al supporto e la risposta dipende dalle norme locali.

Posso eseguire la CI sulla Macedonia del Nord senza spendere credito?

Chiedi la sandbox per un account di sviluppo. Simula numeri e codici, così l'intera integrazione gira end to end senza addebiti sul wallet.

Perché un servizio potrebbe rifiutare il mio numero +389?

Alcune piattaforme rifiutano i numeri virtuali. L'attivazione scade o può essere annullata, e l'addebito torna automaticamente nel 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.