Checklist preliminare per ricevere codici di verifica +375 dalla Bielorussia

Cosa deve essere pronto prima di richiedere un numero +375?

Prima di usare un numero +375 per i test, spunta questi punti:

• Un account e un wallet con fondi. Creane uno dalla pagina di registrazione con un'email e un codice email a 6 cifre, oppure con l'accesso Google, poi aggiungi un piccolo saldo. Attiva l'autenticazione a due fattori TOTP per l'account che custodisce le chiavi API.
• Una chiave Bearer con il prefisso or_live_, creata nella Developer console. Dai alla CI e allo sviluppo locale chiavi separate; un account può averne fino a 10.
• I due id che invierai. La Bielorussia è by nell'API, e l'id del servizio è il valore api_service restituito da GET /api/v1/services.
• Un endpoint ricevente se pensi di usare i webhook, con il suo secret di firma conservato fuori dal repository.
• Un account di test nel tuo prodotto a cui sia consentito cambiare o aggiungere un numero di telefono.
• Una libreria per i numeri di telefono configurata per la regione BY, così il numero che incolli nel modulo di registrazione viene interpretato come lo digiterebbe un vero utente bielorusso.

Come si scrivono i numeri bielorussi e come deve salvarli la tua app?

La Bielorussia usa il prefisso internazionale +375 seguito da un numero nazionale di nove cifre. Le linee mobili iniziano con codici operatore come 25, 29, 33 o 44, quindi un valore salvato appare come +37529XXXXXXX.

La parte insidiosa è l'abitudine locale. Chi si trova nel paese scrive spesso un cellulare con un 80 iniziale, come in 8 029 XXX-XX-XX, che deriva dal prefisso per le chiamate interurbane. Quell'80 va eliminato prima di aggiungere il prefisso del paese; un modulo che lo mantiene produce una stringa E.164 non valida che alcuni servizi di verifica rifiutano in silenzio. Buoni test di normalizzazione per un numero di verifica bielorusso:

• accetta +375 29 ..., 375 29 ... e 8 029 ... e salvali tutti e tre in modo identico;
• mostra il numero con un raggruppamento adatto all'uso locale, ma invia al tuo livello SMS o di verifica solo l'E.164;
• rifiuta un numero che ha ancora 80 dopo il 375.

Il bielorusso e il russo sono entrambi lingue ufficiali, e il russo è quello che la maggior parte delle persone usa ogni giorno. Molti servizi inviano il testo del codice in russo o in inglese a seconda delle impostazioni locali dell'account, quindi verifica che la tua app renda correttamente il cirillico in ogni schermata che riporta il messaggio.

Per quali servizi può ricevere codici un numero di verifica bielorusso?

L'instradamento OTP per la Bielorussia su OTP Route copre attualmente più di 1.400 servizi con l'id by. Tra le rotte popolari nell'istantanea attuale ci sono Telegram, Viber, WhatsApp, Signal, Google (Gmail & YouTube), Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Amazon e AliExpress.

La disponibilità di una singola rotta cambia durante la giornata, quindi considera un elenco come questo un punto di partenza, non una promessa. Prima di un'esecuzione, chiedi a GET /api/v1/prices?country=by&service=<id> il prezzo attuale e se la rotta può accettare un ordine in questo momento. Consulta l'articolo sul routing OTP per paese quando scegli tra più paesi.

Passo dopo passo: il flusso dell'API OTP per la Bielorussia da uno script di test

Ogni richiesta va a https://otproute.com/api/v1 con la tua chiave Bearer. L'API di verifica SMS è abbastanza piccola da poter essere racchiusa in un solo helper:

1. Chiama GET /api/v1/balance e interrompi subito il job se il wallet è troppo scarico per la suite.
2. Chiama GET /api/v1/prices?country=by&service=telegram (sostituisci l'id del tuo servizio) e registra nel log il prezzo che stai per pagare.
3. Crea l'ordine con POST /api/v1/activations e un corpo come {"service": "telegram", "country": "by"}. Salva l'id di attivazione e il numero +375 dalla risposta.
4. Invia quel numero al passaggio telefono della tua app e fai partire il codice.
5. Recupera il codice da un evento activation.sms_received, oppure interroga GET /api/v1/activations/{id}. Il limite è di 300 richieste al minuto.
6. Se il test si interrompe, chiama POST /api/v1/activations/{id}/cancel così il blocco torna subito nel wallet.

Per i webhook, leggi l'header X-OTPRoute-Signature (t=<unix>,v1=<hex>), calcola l'HMAC-SHA256 di <t>.<raw body> con il secret dell'endpoint, confronta a tempo costante e scarta le consegne con timestamp vecchio. Identifica il tuo handler tramite l'id dell'attivazione, così una consegna ripetuta è innocua. La documentazione API e la guida su come proteggere i webhook OTP con HMAC ne spiegano i dettagli.

Passo dopo passo: lo stesso compito dalla dashboard

Il personale di supporto che ha bisogno di un codice di tanto in tanto può saltare l'API:

1. Apri l'OTP Gateway nella dashboard e scegli la Bielorussia.
2. Scegli il servizio; il prezzo di quella rotta compare prima della conferma.
3. Copia il numero +375 e inseriscilo nell'app che stai testando.
4. Osserva la scheda dell'ordine. Il codice compare lì non appena arriva.

Se entro 20 minuti non arriva nulla, l'ordine si chiude e l'intero importo viene riaccreditato. Paghi solo quando un codice viene consegnato.

Risoluzione dei problemi: il codice +375 non è arrivato

Cause più comuni e mossa successiva per ciascuna:

• Il servizio ha rifiutato il numero. Alcune piattaforme rifiutano i numeri virtuali. La regola del rimborso esiste proprio per questo caso; prova un'altra rotta di servizio o un altro paese, se il test lo consente.
• Il numero è stato inserito nella forma nazionale. Ricontrolla che il tuo modulo abbia inviato +375 più nove cifre, senza l'80.
• La rotta è occupata. Lascia che la finestra faccia il suo corso invece di annullare dopo un minuto, poi riprova più tardi.
• Il tuo script rifà l'ordine a ciclo continuo. Aggiungi un backoff tra i tentativi; ordini ripetuti in rapida successione sullo stesso servizio raramente aiutano e possono sembrare un abuso alla piattaforma di destinazione.

Altri schemi di fallimento per gli ordini +375 sono trattati in ridurre le consegne OTP fallite.

Esiste una linea bielorussa a lungo termine e come funziona la fatturazione?

No. OTP Route non ha un numero a lungo termine in self-service per la Bielorussia. Se il tuo team ne ha bisogno per un caso d'uso operativo o di supporto, scrivi a [email protected] descrivendolo; la possibilità di offrire qualcosa dipende dalle norme locali e non si promette nulla. I Dedicated Virtual Numbers sono un prodotto per USA e Canada, da $1.95/month, con SMS in entrata, SMS in uscita e chiamate dal browser.

Gli ordini per la Bielorussia attingono allo stesso wallet prepagato in USD di ogni altra rotta, senza addebiti mensili e senza livelli da scegliere. Lo ricarichi con carta o con stablecoin USDT/USDC; per ogni ricarica una fattura PDF arriva nella tua casella. Gli sviluppatori possono chiedere un account sandbox che restituisce numeri e codici simulati, il modo più economico per validare un'integrazione prima degli ordini reali. Usa ogni numero solo per il tuo prodotto o per i tuoi account legittimi, rispetta i termini di ciascun servizio e tieni presente che si applica l'Acceptable Use Policy di OTP Route. Le cifre attuali sono nella pagina dei prezzi.

Domande frequenti

Posso testare il flusso di registrazione della mia app per la Bielorussia senza una SIM locale?

Sì. Ordina un numero +375 per il tuo servizio dall'OTP Gateway, inseriscilo nel modulo di registrazione e leggi il codice nella dashboard o tramite l'API.

Qual è l'id del paese Bielorussia nell'API di OTP Route?

È by. Usalo in GET /api/v1/prices e nel corpo di POST /api/v1/activations.

Devo salvare i numeri bielorussi con il prefisso 80?

No. Salvali in E.164 come +375 seguito da nove cifre ed elimina l'80 nazionale, altrimenti molti servizi considereranno il numero non valido.

Che fine fanno i miei soldi se il numero +375 non riceve mai un codice?

Quando la finestra di 20 minuti termina senza un SMS, o annulli, l'intero addebito torna automaticamente nel tuo wallet.

In che lingua sarà l'SMS di verifica?

La decide il servizio mittente. Per i numeri bielorussi è di solito il russo o l'inglese, in base alla lingua dell'account o del dispositivo.

Posso tenere un numero +375 per accessi futuri?

Non in self-service. I Dedicated Numbers a lungo termine esistono solo per USA e Canada; per la Bielorussia puoi scrivere a [email protected] per chiedere, senza alcuna promessa di disponibilità.

C'è un modo per testare l'integrazione senza spendere fondi del wallet?

Sì. Su richiesta un account di sviluppo può essere passato alla sandbox, che 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.