Come i team ricevono i codici SMS di DiDi per test e operations

La situazione: un account di mobilità che dipende da un solo numero di telefono

DiDi è una piattaforma di ride-hailing e mobilità e, come la maggior parte delle app di questa categoria, tratta il numero di cellulare come il cuore di un account. Un codice SMS viene di norma richiesto alla registrazione, quando qualcuno accede da un nuovo dispositivo e durante il recupero dell'account; l'onboarding di autisti e corrieri si basa sullo stesso controllo.

Questo crea attrito per il lavoro aziendale legittimo. Un'azienda che gestisce un account passeggero corporate non vuole che sia legato al telefono personale di un dipendente. Un'agenzia che gestisce i viaggi dei clienti ha bisogno di un passaggio di verifica che possa completare qualcuno diverso da chi si è registrato per primo. Un team QA che sviluppa un prodotto collegato a un account DiDi vuole provare il flusso senza passare un telefono personale di mano in mano in ufficio. Un numero virtuale per DiDi, usato una volta per ogni verifica, tiene questi passaggi fuori dalla SIM privata di chiunque.

Quali paesi possono fornire un numero di telefono per DiDi?

La rotta didi copre attualmente 198 paesi. I team partono più spesso dai mercati dove la domanda di ride-hailing è alta, come Messico, Brasile, Cile, Colombia, Perù, Argentina, Costa Rica, Panama, Repubblica Dominicana, Ecuador, Australia, Nuova Zelanda, Giappone e Hong Kong.

Scegli il paese con attenzione. Un account passeggero che verrà usato a Santiago va verificato con un numero cileno, e un test di regressione sulla schermata di registrazione messicana richiede un numero messicano. Non far coincidere il paese del numero e il mercato dell'account è un motivo frequente per cui un test passa sulla carta ma fallisce con l'app reale. L'elenco completo si trova nella sezione paesi.

Come funziona il flusso dell'API per i codici di verifica DiDi?

Il flusso DiDi usa lo stesso URL base di ogni altra rotta, https://otproute.com/api/v1, con una chiave or_live_ nell'header Authorization.

1. Interroga GET /api/v1/prices?country=<id>&service=didi per vedere se la rotta è aperta e quanto costa in questo momento.
2. Effettua l'ordine con POST /api/v1/activations e un corpo come {"service": "didi", "country": "mx"}.
3. Inserisci il numero restituito nella schermata DiDi che stai testando e richiedi l'SMS.
4. Leggi il codice dal webhook, oppure fai polling su GET /api/v1/activations/{id} finché non compare.
5. Se il test di prenotazione della corsa viene abbandonato a metà, rilascia il numero tramite POST /api/v1/activations/{id}/cancel.

Un account può avere fino a 10 chiavi e 5 endpoint webhook, entro 300 richieste al minuto.

Come scrivere un gestore webhook per DiDi?

Iscriviti a activation.sms_received, e anche a activation.expired e activation.cancelled, così il tuo test sa quando smettere di aspettare. Ogni consegna porta X-OTPRoute-Signature: t=<unix>,v1=<hex>; ricalcola l'HMAC-SHA256 su "<t>.<raw body>" con il segreto dell'endpoint, confronta a tempo costante e scarta tutto ciò che ha un timestamp vecchio.

Gli eventi hanno come chiave l'id di attivazione, quindi memorizza quell'id quando ordini e tratta una seconda consegna per lo stesso id come un'operazione nulla. Questa idempotenza è importante perché un webhook ritentato non dovrebbe mai inviare due volte un codice DiDi. Se i webhook in entrata sono scomodi nel tuo ambiente, funziona anche il polling dell'endpoint di attivazione. L'articolo sull'acquisizione degli OTP tramite webhook confronta i due approcci.

Ricevere un OTP di DiDi dalla dashboard

Il personale operativo può saltare del tutto l'API. Accedi, ricarica il portafoglio, apri l'OTP Gateway, cerca DiDi, scegli il paese che corrisponde all'account e controlla il prezzo mostrato prima di confermare. Il numero compare su una scheda di attivazione e il codice vi appare quando DiDi lo invia. L'attivazione resta aperta per 20 minuti.

Perché un codice DiDi potrebbe non arrivare?

Diverse cause ordinarie spiegano un'attivazione vuota:

• DiDi, come molte piattaforme, può rifiutare i numeri virtuali su alcune rotte o in certi momenti.
• La rotta del paese scelto può essere occupata; la disponibilità cambia durante la giornata.
• L'app può limitare le richieste ripetute dallo stesso dispositivo o dalla stessa sessione durante i test.

Il rimedio è la pazienza, non l'aggressività. Lascia terminare la finestra, riprova più tardi o con un altro paese comunque adatto al test ed evita di riordinare in un ciclo serrato. Un tentativo mancato non si paga mai: quando la finestra si chiude o annulli, l'intero importo torna automaticamente nel portafoglio.

Quando un account DiDi dovrebbe usare un numero dedicato, e quali regole si applicano?

Un'attivazione monouso è adatta a una singola verifica. Se lo stesso account DiDi deve accedere di nuovo il mese prossimo, ad esempio un account passeggero di staging o un accesso aziendale condiviso, un numero dedicato mantiene la linea sotto il tuo controllo. Sono offerti solo negli Stati Uniti e in Canada, da $1.95/month, con SMS in entrata nella dashboard e sul tuo webhook. Vedi i numeri virtuali per i dettagli.

Usa OTP Route solo per testare e gestire i tuoi prodotti e account legittimi. Rispetta i termini di DiDi, mantieni un account per persona reale o azienda e tieni presente che si applica l'Acceptable Use Policy di OTP Route. OTP Route non ha alcuna affiliazione con DiDi, il cui nome è un marchio del suo proprietario.

Domande frequenti

Qual è l'id di servizio per la verifica SMS di DiDi nei test?

Usa didi nel campo service, insieme all'id paese del mercato che stai testando.

Posso ricevere un OTP di DiDi per un account messicano senza una SIM messicana?

Sì, se la rotta del Messico è aperta: ordina un numero con paese mx e servizio didi, poi leggi il codice tramite API o nella dashboard.

Pago se DiDi non invia mai il codice?

No. Un'attivazione senza SMS entro 20 minuti, o che annulli, viene rimborsata per intero nel portafoglio.

DiDi accetta tutti i numeri virtuali?

Non necessariamente. Alcune rotte possono essere rifiutate, quindi riprova più tardi o usa un altro paese adatto.

Posso testare l'integrazione DiDi senza spendere fondi del portafoglio?

Sì. Su richiesta un account di sviluppo può essere passato alla sandbox, che restituisce numeri e codici simulati per test end-to-end.

Come pago le attivazioni DiDi?

Ricarica un portafoglio prepagato in USD con carta o USDT/USDC; non c'è canone mensile e ogni ricarica include una fattura PDF. Le tariffe aggiornate sono nella pagina dei prezzi.

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.