Una checklist per ricevere i codici SMS di Bolt sui numeri OTP Route

Dove chiede Bolt il numero di telefono?

Bolt, l'azienda di mobilità fondata a Tallinn dietro i servizi di ride-hailing, consegna di cibo e spesa e noleggio di monopattini, costruisce i suoi account attorno a un numero di cellulare. L'app per passeggeri conferma quel numero con un codice SMS monouso alla registrazione, e lo stesso tipo di codice ricompare di solito quando qualcuno accede da un nuovo dispositivo o recupera l'accesso. I prodotti per autisti, corrieri e aziende seguono uno schema simile.

Per un'azienda questo significa che il numero di telefono Bolt è di fatto la chiave dell'account. I team che gestiscono un account viaggi aziendale, verificano come si comporta la propria integrazione con un partner in una nuova città o tengono la SIM personale di un dipendente fuori da un accesso di lavoro condiviso hanno tutti bisogno di un modo controllato per ricevere quel codice.

Checklist preliminare prima di ordinare un numero Bolt

Ripassa questi punti prima di spendere qualsiasi cosa:

• Scopo legittimo: l'account appartiene alla tua organizzazione o è un account di test per il tuo prodotto, e i termini di Bolt lo consentono.
• Mercato scelto: il paese del numero corrisponde a dove opererà l'account. Un account passeggero registrato con il numero di un paese e usato altrove può comportarsi in modo diverso.
• Chiave API pronta: una chiave Bearer con prefisso or_live_, creata nella console per sviluppatori (fino a 10 per account).
• Endpoint webhook testato: iscritto a activation.sms_received, con il controllo della firma attivo.
• Portafoglio ricaricato: verifica con GET /api/v1/balance, oppure chiedi la modalità sandbox per provare il flusso con numeri simulati.
• Piano B concordato: decidi in anticipo cosa fa il test se non torna alcun codice.

Quali paesi hanno rotte per Bolt?

Le rotte Bolt sono attualmente elencate per 198 paesi. Tra gli esempi ci sono Estonia, Lettonia, Lituania, Polonia, Repubblica Ceca, Portogallo, Germania, Croazia, Malta, Georgia, Sudafrica, Nigeria, Kenya, Ghana, Tanzania e Uganda.

Scegli il paese con attenzione. Le funzioni di Bolt, le opzioni di pagamento e i controlli di registrazione variano da mercato a mercato, quindi un test a Varsavia dice poco su un flusso a Nairobi. La disponibilità per paese cambia durante la giornata; GET /api/v1/prices e la dashboard mostrano ciò che è attivo.

Passo dopo passo: l'API per i codici di verifica di Bolt

1. Conferma l'id di servizio con GET /api/v1/services; per Bolt è bolt.
2. Scegli l'id del paese da GET /api/v1/countries, ad esempio ee per l'Estonia.
3. Leggi il prezzo in tempo reale: GET /api/v1/prices?country=ee&service=bolt.
4. Ordina: POST /api/v1/activations con {"service": "bolt", "country": "ee"}. Conserva l'id di attivazione e il numero restituito.
5. Inserisci il numero nell'app Bolt sul tuo dispositivo di test e richiedi l'SMS.
6. Gestisci l'evento activation.sms_received. Verifica X-OTPRoute-Signature: t=<unix>,v1=<hex> calcolando l'HMAC-SHA256 su <t>.<raw body> con il segreto dell'endpoint, rifiuta i timestamp vecchi e usa l'id di attivazione come chiave delle scritture, così una consegna ripetuta non cambia nulla.
7. Se i webhook non sono un'opzione, fai polling su GET /api/v1/activations/{id} ogni pochi secondi, ben entro il limite di 300 richieste al minuto.
8. Chiama POST /api/v1/activations/{id}/cancel se il test viene abbandonato.

I dettagli degli endpoint sono nella documentazione API, e come proteggere i webhook OTP spiega il controllo della firma.

Passo dopo passo: il percorso dalla dashboard

Per una singola verifica SMS di Bolt per i test o per la configurazione una tantum di un account, basta il browser. Accedi, apri l'OTP Gateway, seleziona Bolt e il mercato, controlla il prezzo e conferma. Copia il numero nell'app, richiedi il codice e guardalo comparire sulla scheda dell'ordine prima che scada il timer di 20 minuti.

Risoluzione dei problemi: il codice Bolt non è mai arrivato

Una finestra vuota non costa nulla; quando passano 20 minuti senza un SMS, o se annulli, l'intero importo torna nel tuo portafoglio. Cause comuni e rimedi:

• Bolt ha rifiutato il numero: come molte piattaforme, non accetta un numero virtuale per la registrazione a Bolt in ogni mercato. Prova un'altra rotta paese se il tuo test lo consente, oppure un tentativo successivo.
• Consegna lenta: i tempi dipendono dal servizio e dalla rotta, quindi lascia terminare la finestra prima di annullare.
• Richieste ripetute: toccare più volte il reinvio o riordinare in un ciclo può far scattare la limitazione di Bolt stesso. Distanzia i tentativi.
• Mercato sbagliato: un numero di un paese che Bolt non serve nel tuo scenario di test potrebbe non essere mai accettato.

La guida sull'instradamento per paese degli OTP tratta la scelta delle alternative.

Quando è più adatto un numero dedicato?

Un numero monouso è adatto a una singola verifica. Se un account Bolt deve accedere di nuovo dopo settimane, ad esempio un profilo passeggero di staging che il tuo team QA riutilizza, o un accesso operativo che viene riverificato su nuovi dispositivi, il numero deve restare con te. I numeri dedicati lo permettono, ma solo negli Stati Uniti e in Canada, da $1.95/month, con SMS in entrata nella dashboard e inoltrati al tuo webhook come number.sms_received. Verifica che il mercato Bolt dell'account funzioni con un numero statunitense o canadese prima di farci affidamento. Vedi i numeri virtuali per i dettagli.

Usare i numeri Bolt in modo responsabile

Rispetta i termini di servizio di Bolt in ogni mercato. Mantieni un account per persona reale o azienda e usa OTP Route solo per testare i tuoi prodotti o per gestire account legittimi di proprietà della tua organizzazione; creare profili passeggero usa e getta o sfruttare le promozioni non è un uso accettabile. L'Acceptable Use Policy di OTP Route si applica a ogni ordine, e Bolt è un marchio del suo proprietario, senza alcuna affiliazione implicita.

Domande frequenti

Posso ricevere un OTP di Bolt senza una SIM locale?

Sì. Ordina un numero per il servizio bolt nel paese giusto, inseriscilo nell'app e leggi il codice nella dashboard o tramite API.

Qual è l'id di servizio di Bolt nell'API?

È bolt. Combinalo con un id paese come pl o ke quando chiami POST /api/v1/activations.

Quanto costa un numero di verifica per Bolt?

Da $0.20 per codice. L'importo esatto dipende dal paese e viene restituito in tempo reale da GET /api/v1/prices.

Bolt accetta tutti i numeri virtuali?

No. Bolt può rifiutare i numeri virtuali in alcuni mercati o flussi, ed è per questo che un codice non consegnato viene rimborsato automaticamente.

Quale paese devo scegliere per un test su Bolt?

Usa il paese in cui l'account verrà effettivamente usato, così regole di registrazione, lingua e opzioni di pagamento corrispondono a ciò che vedono gli utenti reali.

Posso conservare lo stesso numero per i futuri accessi a Bolt?

Non con un'attivazione monouso. Per accessi ripetuti, un numero dedicato negli Stati Uniti o in Canada è l'opzione self-service.

Posso testare il flusso prima di pagare?

Sì. Chiedi la modalità sandbox su un account di sviluppo per ricevere numeri e codici simulati senza spendere fondi del portafoglio.

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.