Integrare la verifica SMS +82 nella tua pipeline di rilascio coreana

Quali endpoint attraversa un'attivazione +82?

Parti dall'API di verifica SMS, perché è lì che finiscono comunque la maggior parte dei piani di test per la Corea. Ogni chiamata va a https://otproute.com/api/v1 con una chiave Bearer che inizia con or_live_ della Developer console.

• GET /api/v1/countries restituisce kr per la Corea del Sud; GET /api/v1/services fornisce gli id dei servizi.
• GET /api/v1/prices?country=kr&service=<id> riporta il prezzo attuale e se la rotta è aperta.
• POST /api/v1/activations con {"service": "kakaotalk", "country": "kr"} riserva un numero +82 e restituisce un id di attivazione.
• GET /api/v1/activations/{id} mostra lo stato e, una volta ricevuto, il codice.
• POST /api/v1/activations/{id}/cancel rilascia un numero che non ti serve più.
• GET /api/v1/balance permette a una suite di fallire in anticipo quando il wallet è scarico.

Il limite dell'account è di 300 richieste al minuto, quindi fare polling ogni pochi secondi su job paralleli è comodo. La guida all'integrazione mostra un ciclo di richiesta completo.

Come si inseriscono i webhook firmati in un test run coreano?

Il polling va bene per un singolo sviluppatore; i job CI paralleli sono più puliti con la consegna push. Registra fino a cinque endpoint e iscriviti a activation.sms_received, activation.expired e activation.cancelled.

Ogni richiesta include X-OTPRoute-Signature: t=<unix>,v1=<hex>. Prendi il corpo grezzo esattamente come ricevuto, costruisci la stringa <t>.<raw body>, calcola HMAC-SHA256 con il secret dell'endpoint e confrontala con v1 usando un confronto a tempo costante. Rifiuta qualsiasi richiesta con timestamp vecchio per bloccare i replay e indicizza il tuo handler sull'id di attivazione, così una consegna ritentata non risolve due volte lo stesso test. L'articolo su HMAC copre casi limite come la riserializzazione del corpo.

Quale problema stanno di solito risolvendo i team di lancio in Corea?

La Corea del Sud è un mercato esigente per app mobili e giochi, e gli utenti coreani si aspettano una localizzazione curata. I team testano qui prima di un rilascio, quando aggiungono schermate in coreano, o quando una coda di supporto segnala che i testi di verifica non raggiungono gli utenti coreani. Senza una SIM locale, ricevere SMS OTP sudcoreani e riprodurre quelle segnalazioni è lento. Un numero +82 monouso da un servizio di OTP routing permette a un ingegnere di rieseguire il flusso esatto da qualsiasi ufficio, e il codice arriva negli stessi strumenti di ogni altro mercato.

Come si formattano e si archiviano i numeri di telefono coreani?

I cellulari coreani si scrivono a livello nazionale come 010 seguito da otto cifre. Lo 0 iniziale è un prefisso di rete, quindi la forma internazionale lo elimina: +82 10 e poi le restanti otto cifre. I moduli che accettano entrambi gli stili dovrebbero normalizzare in E.164 all'ingresso; salvare 010… e +8210… fianco a fianco crea utenti duplicati e ricerche rotte.

I messaggi dei mittenti coreani sono normalmente scritti in hangul, che viene inviato come SMS Unicode, mentre le app globali seguono l'impostazione di lingua dell'account. Estrai i codici cercando il gruppo di cifre, non aspettandoti un template in inglese. Tieni presente inoltre che molti servizi coreani nazionali legano la registrazione a una verifica d'identità con nome reale tramite l'operatore dell'abbonato. Quel controllo è pensato per abbonamenti personali, un numero monouso non lo soddisfa e non dovresti tentare di aggirarlo.

Quali app sono aperte oggi sulle rotte sudcoreane?

L'istantanea kr mostra più di 500 servizi. Tra le scelte comuni per un numero di verifica sudcoreano ci sono KakaoTalk, LINE, WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, TikTok, Discord, Netflix, Microsoft & Outlook, Amazon, Uber, ChatGPT (OpenAI) e Claude.

La copertura cambia durante la giornata, quindi conferma sempre con l'endpoint dei prezzi prima di un ordine. Chi non è sviluppatore può fare lo stesso dalla dashboard: crea un account, apri l'OTP Gateway, scegli il servizio e la Corea del Sud, controlla il prezzo mostrato, conferma e copia il numero +82 nell'app. Il codice compare a schermo non appena arriva.

E se un'attivazione +82 resta vuota?

La finestra di attivazione è di 20 minuti e ti viene addebitato qualcosa solo se arriva un codice. Quando non arriva nulla:

• Concedi alla finestra il suo tempo pieno prima di considerare fallito l'ordine.
• Annulla e riprova più tardi, oppure scegli un'altra rotta per quel servizio quando ne è indicata una.
• Controlla se l'app rifiuta le linee virtuali o richiede controlli d'identità tramite operatore; in quel caso ripetere l'ordine non cambierà l'esito.
• Non ritentare in un ciclo serrato, che tende a innescare limitazioni lato mittente.

Gli ordini senza risposta o annullati vengono rimborsati automaticamente. Rispetta i termini di ciascuna app e ricorda che l'Acceptable Use Policy di OTP Route si applica a ogni attivazione.

Esiste un numero coreano a lungo termine e come funziona la fatturazione?

Non esiste una linea +82 a lungo termine in self-service. I Dedicated Number sono offerti solo negli Stati Uniti e in Canada, da $1.95/mese, per gli account che devono continuare a ricevere messaggi. Per altre esigenze in Corea, scrivi a [email protected]; la disponibilità dipende dalla normativa locale e non è garantita.

L'OTP Gateway si paga da un wallet prepagato in USD, senza piano né canone mensile. Ricarichi con carta o USDT/USDC e ricevi una fattura PDF per ogni ricarica. Su richiesta, un account di sviluppo può passare alla sandbox, così la tua pipeline gira su numeri e codici simulati. Vedi i prezzi per le tariffe in tempo reale.

Domande frequenti

Posso testare la verifica telefonica coreana della mia app senza una SIM coreana?

Sì. Ordina un numero +82 tramite l'OTP Gateway, inseriscilo nella tua app e ritira il codice tramite l'API, un webhook o la dashboard.

Devo includere lo 0 iniziale quando inserisco un numero coreano in formato internazionale?

No. Elimina il prefisso di rete, così un cellulare 010 diventa +82 10 più otto cifre.

Quanto costa un numero +82 per i test?

Da $0.20 a codice, con il prezzo esatto che dipende dal servizio. La cifra in tempo reale arriva dall'endpoint dei prezzi e dalla dashboard.

Un numero monouso supera la verifica coreana con nome reale?

No. I controlli d'identità tramite operatore sono legati ad abbonamenti personali, quindi usa OTP Route solo per i flussi che accettano normali codici SMS.

Mi viene addebitato qualcosa se KakaoTalk o un'altra app non invia mai il codice?

No. Se entro 20 minuti non arriva nulla, o se annulli, il pagamento torna sul tuo wallet.

Posso tenere un numero sudcoreano per accessi ripetuti?

Non in self-service. Ogni numero monouso riceve un solo codice e le linee a lungo termine sono limitate a Stati Uniti e Canada.

Quale codice paese si aspetta l'API per la Corea del Sud?

L'id paese è kr, usato nella query dei prezzi e nel corpo dell'attivazione.

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.