Verificare i flussi di registrazione cinesi (+86) con un'API di routing OTP

Perché il mercato cinese richiede un piano di test della verifica tutto suo?

La Cina ha uno degli ecosistemi mobili più grandi al mondo, e gran parte di esso vive dentro piattaforme nazionali anziché nelle app globali che un team occidentale testa per prime. Le SIM sono registrate con il nome reale dell'intestatario, quindi i servizi locali considerano il numero di telefono un forte segnale di identità e spesso sono più severi sui numeri che accettano.

Questo cambia il modo in cui un QA engineer dovrebbe pensare a una rotta per la Cina:

• Commercio transfrontaliero. Venditori e acquirenti su Alibaba e AliExpress confermano il numero di telefono quando si registrano o modificano i dati dell'account, quindi i team dei marketplace vogliono vedere questi messaggi end to end.
• Testi in cinese. I codici dei mittenti nazionali arrivano normalmente in cinese semplificato e spesso iniziano con il nome del mittente tra parentesi 【】. Un parser che cerca la parola inglese "code" non li troverà.
• Codifica. Il testo cinese viaggia come SMS Unicode, quindi salva i corpi dei messaggi in UTF-8 ed estrai le cifre con un pattern che ignori i caratteri circostanti.

Usare un numero +86 per i test su una rotta reale fa emergere tutti e tre i problemi prima dei clienti, ed è qui che il routing OTP verso un vero percorso di operatore cinese si rivela utile.

Come va memorizzato un numero mobile +86?

I numeri mobili della Cina continentale hanno 11 cifre e iniziano con 1. A differenza dei numeri fissi, che a livello nazionale si compongono con lo 0 di prefisso interurbano più il prefisso di zona, i cellulari non hanno alcun prefisso interurbano, quindi la forma E.164 è semplicemente +86 seguito dalle 11 cifre.

Alcune abitudini di normalizzazione fanno risparmiare tempo nel debug:

• Rimuovi spazi e trattini: gli utenti spesso digitano il numero in gruppi 3-4-4.
• Converti un 0086 o un 86 iniziale in +86 prima di salvare e non anteporre mai uno 0 a un cellulare.
• Valida la lunghezza dopo la normalizzazione: 11 cifre nazionali per un cellulare, non una di più.

Tieni un'unica colonna canonica in E.164 e formatta solo in fase di visualizzazione. Il numero restituito da un'attivazione ha già questa forma canonica, il che lo rende un'ottima fixture per i test unitari del tuo normalizzatore.

Quali app possono inviare codici a una rotta cinese oggi?

La rotta cinese copre attualmente più di 1.300 servizi. Tra i più richiesti nello snapshot live ci sono WeChat, Alibaba, AliExpress, Microsoft & Outlook, LinkedIn, Telegram, WhatsApp, Google (Gmail & YouTube), TikTok, Amazon, Discord, ChatGPT (OpenAI) e Claude.

La disponibilità cambia nel corso della giornata, perché i nostri partner operatori aggiungono e ritirano capacità, quindi considera questo elenco un punto di partenza. Chiama GET /api/v1/services e GET /api/v1/countries per avere il quadro aggiornato, invece di scrivere gli id dei servizi direttamente in una matrice di test.

Che aspetto ha il flusso API per l'id paese cn?

Crea una chiave Bearer (prefisso or_live_) nella Developer console, poi punta il tuo client a https://otproute.com/api/v1. Una tipica esecuzione dell'API OTP per la Cina funziona così, e gli stessi passaggi ti permettono di ricevere SMS OTP dalla Cina per qualsiasi servizio supportato:

1. Chiedi a GET /api/v1/prices?country=cn&service=wechat il prezzo live della coppia che intendi testare.
2. Invia POST /api/v1/activations con il corpo {"service": "wechat", "country": "cn"} e conserva l'id di attivazione restituito.
3. Inserisci il numero +86 nel modulo di registrazione del prodotto in prova.
4. Lascia che il tuo webhook riceva activation.sms_received; senza webhook, controlla GET /api/v1/activations/{id} ogni pochi secondi.
5. Se il test viene interrotto, chiama POST /api/v1/activations/{id}/cancel, che libera subito l'importo trattenuto.

Le consegne dei webhook includono X-OTPRoute-Signature nel formato t=<unix>,v1=<hex>. Ricalcola l'HMAC-SHA256 su <t>.<raw body> con il secret dell'endpoint, confronta in tempo costante e scarta i timestamp obsoleti. Ogni account ha fino a 10 chiavi, 5 endpoint webhook e 300 richieste al minuto; i riferimenti completi sono nella documentazione API.

Chi non scrive codice può ordinare un numero cinese?

Sì. Product manager e personale di supporto possono fare tutto dalla dashboard:

1. Apri l'OTP Gateway, scegli la Cina, poi seleziona il servizio.
2. Controlla il prezzo mostrato prima di ordinare.
3. Copia il numero +86 nell'app che stai verificando.
4. Guarda la scheda dell'attivazione: il testo del messaggio compare lì non appena viene ricevuto.

Valgono la stessa finestra di 20 minuti e la stessa regola di rimborso, quindi un controllo manuale di una schermata di onboarding localizzata non costa nulla se l'app non invia niente.

Cosa provare quando un codice cinese non arriva?

Il silenzio di solito significa che il servizio ha rifiutato di inviare a quel numero o che la rotta è occupata, non che la tua integrazione sia rotta. Procedi con calma:

• Lascia scorrere l'intera finestra: alcuni mittenti riprovano secondo un proprio calendario.
• Verifica che il servizio accetti numeri virtuali: le piattaforme con regole di registrazione a nome reale spesso non li accettano, e il rimborso automatico esiste proprio per questo caso.
• Riprova dopo una pausa, oppure esegui lo stesso scenario tramite un'altra rotta di servizio.
• Evita di riordinare in un ciclo serrato: consuma i limiti di frequenza e raramente cambia l'esito.

La nostra guida su come ridurre i mancati recapiti OTP approfondisce la progettazione dei retry.

Posso tenere un numero +86 a lungo termine e come viene fatturato?

Per la Cina non esiste una linea a lungo termine in self-service. I numeri dedicati sono un prodotto per Stati Uniti e Canada, da $1.95/month, con SMS in entrata, SMS in uscita e chiamate dal browser. Se il tuo team ha bisogno di una linea cinese duratura, scrivi a [email protected] per chiedere: la disponibilità dipende dalle norme locali e non è garantita.

Il denaro sta in un unico portafoglio prepagato in USD, senza canoni mensili e senza piani da scegliere. I test sulla Cina attingono da quel saldo, che ricarichi con carta o con USDT/USDC, ricevendo via email una fattura PDF dopo ogni ricarica. I dettagli sono nella pagina dei prezzi, mentre la panoramica dei numeri virtuali spiega le linee per Stati Uniti e Canada. Per il lavoro di integrazione, chiedi la modalità sandbox: restituisce numeri e codici simulati, così una pipeline può essere provata senza toccare i fondi del portafoglio.

Domande frequenti

Posso testare una registrazione a WeChat o Alibaba senza una SIM cinese?

Puoi ordinare un numero +86 per quel servizio tramite OTP Route e leggere il codice nella dashboard o via API. Alcune piattaforme rifiutano i numeri virtuali: in quel caso l'attivazione viene rimborsata automaticamente.

Qual è l'id paese della Cina nell'API di OTP Route?

Usa cn ovunque sia richiesto un id paese, ad esempio in GET /api/v1/prices?country=cn&service=<id>.

I messaggi di verifica cinesi arrivano in inglese?

I mittenti nazionali scrivono di solito in cinese semplificato, mentre le app globali spesso inviano in inglese o nella lingua associata all'account. Costruisci l'estrazione del codice sulle cifre, non sulle parole chiave.

Quanto resta aperta un'attivazione +86?

Venti minuti. Se prima della chiusura non arriva alcun SMS, o annulli tu per primo, l'intero importo torna nel tuo portafoglio.

Un numero di verifica cinese va bene per accessi ripetuti?

No. Ogni attivazione riceve un solo codice e poi termina, quindi è adatta a test di registrazione e onboarding, non ad account che devono autenticarsi di nuovo il mese prossimo.

Quali regole valgono per l'uso dei numeri +86?

Rispetta i termini di ciascuna piattaforma e la Acceptable Use Policy di OTP Route. Il prodotto serve a testare i tuoi flussi di verifica e a gestire account aziendali legittimi, mai a registrazioni di massa.

Una pipeline CI può usare numeri cinesi senza pagare?

Su richiesta, un account di sviluppo può passare alla modalità sandbox, che restituisce numeri e codici simulati così i tuoi test dell'API di verifica SMS girano end to end gratuitamente.

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.