Togliere i codici di verifica Shopee dai telefoni personali

Perché un team dovrebbe aver bisogno di numeri Shopee che non appartengono a nessuno in particolare?

Immagina un team che costruisce un'integrazione con un marketplace: sincronizzazione degli ordini, uno strumento per i resi o un'app per il negozio. Il QA ha bisogno di un account acquirente in uno specifico mercato Shopee per percorrere il checkout e confermare che l'integrazione si comporti bene. Qualcuno usa il proprio telefono e ora un account di test è legato alla SIM di un solo dipendente in un solo paese.

Le agenzie che aprono negozi per i clienti incontrano lo stesso problema, così come i team di prodotto che preparano un lancio in un nuovo mercato del Sud-est asiatico. Un numero virtuale per Shopee tiene questi controlli fuori dai telefoni privati e ti lascia scegliere il paese a cui il test si riferisce davvero. La pagina sui marketplace descrive come i team di questo settore usano OTP Route.

Quando Shopee chiede un codice telefonico?

Shopee lega strettamente gli account a un numero di telefono e un codice SMS monouso compare di solito in questi momenti:

• Registrazione con un numero di telefono sull'app o sul sito per acquirenti.
• Accesso con codice, oppure accesso su un dispositivo che l'account non ha mai usato.
• Reimpostazione della password e recupero quando la password è andata persa.
• Modifiche sensibili, come cambiare numero di telefono, email o dati per i pagamenti.
• Account venditore, che passano per la verifica telefonica quando si apre un negozio.

I passaggi esatti cambiano da un sito nazionale di Shopee all'altro e nel tempo, quindi considera questo lo schema generale e non un regolamento fisso.

In quali paesi si può ricevere un codice Shopee e perché è importante?

La rotta Shopee è elencata in 197 paesi, tra cui Indonesia, Malesia, Filippine, Vietnam, Thailandia, Singapore, Taiwan, Brasile, Messico, Colombia, Cile, India, Stati Uniti, Regno Unito e Australia.

Shopee gestisce negozi separati per ogni mercato e ciascuno in genere si aspetta un numero di telefono del proprio paese. Quindi scegli il paese che corrisponde all'account che stai testando: il test di un negozio malese vuole un numero malese, non un numero qualsiasi che capita di costare poco. Far corrispondere il mercato mantiene anche il test realistico, perché lingua, valuta e passaggi di onboarding seguono il negozio.

Come funziona l'API del codice di verifica Shopee?

Usa l'URL di base https://otproute.com/api/v1 con una chiave Bearer con prefisso or_live_. Controlla il prezzo per il tuo mercato con GET /api/v1/prices?country=my&service=shopee, poi crea l'attivazione con POST /api/v1/activations e il corpo {"service": "shopee", "country": "my"}. Gli id dei paesi si ricavano da GET /api/v1/countries.

Per la consegna hai due opzioni:

• Webhook: iscriviti a activation.sms_received, oltre a activation.expired e activation.cancelled. Verifica l'intestazione X-OTPRoute-Signature calcolando l'HMAC-SHA256 di "<t>.<raw body>" con il segreto del tuo endpoint, scarta i timestamp obsoleti e rendi il gestore idempotente registrando una sola volta ogni id di attivazione.
• Polling: chiama GET /api/v1/activations/{id} a intervalli finché il codice non compare o l'attivazione termina.

L'articolo sulla cattura degli OTP via webhook mostra un ricevitore pronto per la produzione.

Passaggi dalla dashboard per venditori e personale operativo

Non tutti hanno bisogno dell'API. Nella dashboard:

1. Registrati con l'email e un codice di sei cifre, oppure con Google.
2. Ricarica il portafoglio con carta o con USDT/USDC.
3. Apri l'OTP Gateway, scegli Shopee e il paese e controlla il prezzo in tempo reale.
4. Ordina, poi digita il numero nel campo telefono di Shopee.
5. Leggi il codice quando compare accanto al numero.

Ogni attivazione ha una finestra di 20 minuti. Paghi solo se il codice arriva; altrimenti l'importo torna da solo nel portafoglio.

Perché un codice Shopee potrebbe non arrivare?

Alcune cose possono mettersi di traverso. Shopee può rifiutare i numeri virtuali in alcuni mercati o flussi, e il rimborso automatico esiste proprio per questa situazione. Le rotte possono inoltre essere occupate in certe ore, dato che la consegna dipende dal servizio e dalla rotta.

Cosa provare:

• Lascia scorrere l'intera finestra di 20 minuti prima di arrenderti.
• Riordina più tardi, oppure prova la rotta di un altro paese se il test lo consente.
• Distanzia i tentativi nei test automatici; rifare l'ordine in un ciclo serrato raramente aiuta.

Per un elenco più completo di soluzioni pensato per i flussi dei marketplace, leggi come ridurre le consegne OTP fallite.

Quando è più adatto un Numero Dedicato e quali sono le regole di base?

Un numero monouso va bene per una singola verifica. Un account acquirente di staging che deve accedere di nuovo la settimana prossima, o un accesso operativo condiviso che richiede il recupero, è servito meglio da un Numero Dedicato che conservi finché si rinnova. È disponibile subito negli Stati Uniti e in Canada da $1.95/mese, 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 account e prodotti legittimi. Rispetta i termini di Shopee, tieni un account per ogni persona o azienda reale e ricorda che si applica l'Acceptable Use Policy di OTP Route. Shopee è un marchio del suo titolare e OTP Route non è affiliata ad esso.

Domande frequenti

Qual è l'id del servizio Shopee nell'API?

È shopee. Abbinalo a un id paese, per esempio {"service": "shopee", "country": "id"} per l'Indonesia.

Posso ricevere un OTP di Shopee per un mercato in cui non mi trovo fisicamente?

Sì, se quel paese è sulla rotta. Ordina un numero del mercato di cui stai testando il negozio e leggi il codice da remoto.

Shopee accetta qualsiasi numero virtuale?

No. Shopee può rifiutare alcuni numeri virtuali, ed è per questo che un'attivazione che non riceve alcun codice viene rimborsata per intero.

Quale numero di telefono Shopee devo usare per un account di test di lunga durata?

Se l'account deve accedere di nuovo più avanti, un Numero Dedicato statunitense o canadese che conservi è la scelta migliore rispetto a un'attivazione monouso.

La verifica SMS di Shopee per i test è supportata nella CI?

Sì. Crea le attivazioni tramite l'API, ricevi i codici con un webhook firmato o con il polling e chiedi un account sandbox per fare le prove senza spendere fondi.

Quanto costa un codice Shopee?

Da $0.20 per codice; il prezzo esatto dipende dal paese ed è restituito in tempo reale da GET /api/v1/prices.

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.