Guida per sviluppatori ai codici di verifica moldavi (+373)

Che aspetto ha un'attivazione +373 dalla richiesta al codice?

Un'attivazione è un oggetto di breve durata con un id, un numero di telefono e uno stato. Il tuo client si autentica a https://otproute.com/api/v1 con una chiave Bearer che inizia con or_live_, generata nella Developer console (fino a 10 chiavi per account, 300 richieste al minuto).

Il ciclo di vita per la Moldavia è questo. Il tuo job legge GET /api/v1/prices?country=md&service=<id> per confermare che la route sia aperta e vedere il prezzo di oggi. Poi invia POST /api/v1/activations con {"service": "<id>", "country": "md"} e riceve l'activation id insieme a un numero +373. Il test inserisce quel numero nell'app di destinazione e fa partire l'SMS. Da quel momento l'attivazione è attiva per 20 minuti; termina quando si riceve un codice, quando chiami POST /api/v1/activations/{id}/cancel o quando il tempo scade.

Gli id dei servizi e l'intero catalogo dei paesi arrivano da GET /api/v1/services e GET /api/v1/countries. Recuperali all'avvio invece di scriverli nel codice, perché l'elenco live è la fonte di verità. La guida all'integrazione dell'API OTP mostra un client completo.

Il mio client API OTP per la Moldavia deve fare polling o ascoltare i webhook?

Entrambi funzionano con la stessa API di verifica SMS, e molti team usano entrambi: i webhook per la velocità, il polling come rete di sicurezza.

Webhook. Aggiungi un endpoint nella Developer console (un account può registrarne cinque) e gestisci activation.sms_received, activation.expired e activation.cancelled. Convalida l'header X-OTPRoute-Signature, nel formato t=<unix>,v1=<hex>, calcolando l'HMAC-SHA256 su <t>.<raw body> con il secret dell'endpoint e rifiutando i timestamp scaduti. Imposta l'elaborazione con chiave sull'activation id, così una consegna duplicata è innocua.

Polling. Chiama GET /api/v1/activations/{id} ogni pochi secondi con un backoff e fermati quando lo stato è definitivo. Va bene per i runner CI dietro un firewall che non possono accettare richieste in ingresso. Il nostro articolo sui test SMS OTP nelle pipeline CI tratta timeout e ripetizioni per entrambi i modelli.

Cosa rende diversi da gestire i numeri di telefono moldavi?

I numeri nazionali moldavi hanno otto cifre dopo il prefisso +373, e la composizione nazionale aggiunge davanti un prefisso di tronco 0. Gli utenti scrivono quindi lo stesso cellulare in più forme: con lo 0 iniziale, con +373 o con 00373. Normalizza eliminando spazi e trattini, rimuovendo lo 0 nazionale quando aggiungi il prefisso del paese e salvando la forma E.164. Un validatore che pretende lo zero iniziale rifiuterà un input internazionale scritto correttamente, ed è una delle prime cose che un numero +373 per i test tende a far emergere.

Il rumeno è la lingua ufficiale e il russo è molto parlato, quindi i messaggi di verifica dei servizi locali possono arrivare in una delle due lingue, o in inglese dalle app globali. I messaggi in cirillico vengono inviati con una codifica più ampia e si dividono in modo diverso dal testo latino, aspetto da coprire in qualsiasi parser che estragga il codice.

I team testano in Moldavia quando localizzano un'app in rumeno o in russo, servono clienti in tutta la regione, oppure hanno personale di supporto e sviluppo a Chișinău i cui passaggi di verifica vanno controllati.

Quali app instradano oggi i codici verso la Moldavia?

OTP Route elenca più di 1.700 servizi per la Moldavia. Lo snapshot attuale dei più diffusi comprende Telegram, Viber, WhatsApp, Signal, Facebook, Instagram, TikTok, Google (Gmail & YouTube), LinkedIn, Snapchat, Amazon, eBay, Netflix e Claude.

Considera questo quadro come in movimento. La disponibilità cambia durante la giornata, quindi richiedi l'elenco live prima di ogni esecuzione e tieni pronta una route di ripiego per i servizi instabili. L'articolo sul country routing spiega come funziona l'OTP routing verso un paese di ripiego senza modificare la logica del test.

Perché un codice moldavo potrebbe non arrivare?

Un servizio può rifiutare del tutto i numeri virtuali, limitare i tentativi ripetuti o consegnare lentamente su una determinata route. Niente di tutto questo ti costa qualcosa, perché un codice che non arriva entro la finestra di 20 minuti comporta un rimborso automatico e completo sul wallet.

Passi pratici quando succede:

• Aspetta che la finestra si esaurisca invece di annullare al primo silenzio.
• Conferma che il servizio accetti i numeri virtuali.
• Riprova più tardi, oppure passa a un altro paese supportato dal servizio.
• Distanzia gli ordini ripetuti; lanciare nuove attivazioni in un ciclo serrato è controproducente.
• Registra gli activation id insieme ai log dell'app, così potrai confrontare le esecuzioni fallite con quelle riuscite.

Come ordina un numero moldavo chi non scrive codice?

Crea un account da registrazione con email e un codice email di 6 cifre, o con l'accesso Google. Nell'OTP Gateway seleziona il servizio, scegli la Moldavia, leggi il prezzo live e conferma. Incolla il numero +373 nell'app che stai verificando; il codice compare nella dashboard non appena viene ricevuto. Puoi annullare dalla stessa schermata e l'importo torna subito sul wallet.

E per le linee durature, l'accesso sandbox e il pagamento?

OTP Route non vende un numero moldavo a lungo termine self-serve. I Dedicated Numbers sono offerti solo negli Stati Uniti e in Canada, da $1.95/month. Per una linea +373 duratura scrivi a [email protected]; se sia possibile organizzarla dipende dalle norme locali.

Il pagamento è a consumo da un unico wallet in USD, senza abbonamento e senza livelli. Aggiungi fondi con carta o con USDT/USDC e ricevi una fattura PDF via email per ogni ricarica. Gli sviluppatori che vogliono prima provare un'integrazione possono chiedere di spostare il proprio account in sandbox, dove numeri e codici sono simulati e il wallet resta intatto.

Domande frequenti

Posso ricevere un SMS OTP della Moldavia senza abitarci?

Sì. L'OTP Gateway assegna un numero +373 utilizzabile da qualsiasi luogo, e il codice viene mostrato nella dashboard o inviato al tuo client API.

Quale country id deve inviare il mio codice per la Moldavia?

Invia md come valore di country. Gli id dei servizi arrivano da GET /api/v1/services.

Devo salvare i numeri moldavi con lo 0 iniziale?

No. Salvali in E.164 come +373 più le otto cifre nazionali, eliminando il prefisso di tronco nazionale.

Cosa succede se annullo un'attivazione moldava?

Chiamare POST /api/v1/activations/{id}/cancel prima che arrivi un codice chiude l'attivazione e restituisce l'intero importo al tuo wallet.

Esiste un numero di verifica moldavo che posso tenere per mesi?

Non in self-serve. I Dedicated Numbers a lungo termine sono un prodotto per Stati Uniti e Canada; scrivi al supporto per informarti sulla Moldavia.

Posso usare OTP Route per creare molti account su una stessa app?

No. Serve a testare e a gestire i tuoi prodotti e account legittimi, nel rispetto dei termini di ciascun servizio e dell'Acceptable Use Policy di OTP Route.

La mia test suite può girare sulla Moldavia senza spendere denaro?

Sì, se richiedi la modalità sandbox per un account di sviluppo. Restituisce numeri e codici simulati per 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.