Raccogliere in modo programmatico i codici OTP indonesiani +62

Quali endpoint chiama un'integrazione con l'API OTP dell'Indonesia?

Tutto gira su https://otproute.com/api/v1 con una chiave Bearer con prefisso or_live_. Creane una nella console sviluppatori; un account può avere fino a 10 chiavi, il che rende facile separare un runner CI da una macchina di staging.

1. Recupera GET /api/v1/services e GET /api/v1/countries e metti in cache entrambi gli elenchi. L'Indonesia compare con l'id id.
2. Chiedi a GET /api/v1/prices?country=id&service=<id> il prezzo e la disponibilità attuali del servizio che stai per testare. L'inventario si muove durante la giornata, quindi interrogalo a ogni esecuzione invece di fissarlo nel codice.
3. Crea l'ordine con POST /api/v1/activations e un corpo come {"service": "tokopedia", "country": "id"}. Ottieni un id di attivazione più un numero +62.
4. Digita o inserisci quel numero nel campo telefono della tua app o del tuo account di test.
5. Leggi il risultato tramite webhook, oppure fai polling su GET /api/v1/activations/{id}. Interrompi in modo pulito con POST /api/v1/activations/{id}/cancel quando un test fallisce prima del passaggio SMS.

Un rapido GET /api/v1/balance prima dell'avvio della suite permette a un'esecuzione di fallire subito invece che a metà. Un polling a intervalli ragionevoli rientra facilmente nel limite di 300 richieste al minuto. Gli schemi completi sono nella documentazione API.

Come elaboro i codici +62 con un webhook firmato?

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

Ogni richiesta include un header X-OTPRoute-Signature nella forma t=<unix>,v1=<hex>. Ricostruisci la stringa firmata come <t>.<raw body>, calcola l'HMAC-SHA256 con il secret dell'endpoint e confrontalo con v1 in tempo costante. Calcola l'hash sui byte grezzi prima di qualsiasi parsing JSON e scarta le richieste con un timestamp troppo vecchio, in modo che un payload catturato non possa essere riprodotto.

Considera gli eventi legati all'id dell'attivazione e rendi il gestore idempotente: una consegna ripetuta deve semplicemente trovare il codice già memorizzato. Il nostro approfondimento sulla sicurezza dei webhook con HMAC illustra i controlli.

Quali servizi possono ricevere SMS OTP indonesiani su OTP Route?

L'istantanea in tempo reale per l'Indonesia copre più di 3.000 servizi. Tra le rotte popolari ci sono WhatsApp, Tokopedia, Shopee, Lazada, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LINE, Discord, Microsoft & Outlook e ChatGPT (OpenAI).

Per i colleghi che non toccano mai l'API, la dashboard svolge lo stesso compito: accedi, scegli il servizio, scegli l'Indonesia, controlla il prezzo mostrato e ordina. Il numero +62 compare a schermo e il codice viene mostrato accanto quando arriva l'SMS. Annulla dalla stessa vista se il test viene sospeso.

Come va salvato e normalizzato un numero +62?

L'Indonesia usa lo 0 come prefisso interurbano, quindi i cellulari si scrivono in ambito nazionale come 08 seguito dalle altre cifre. In E.164 lo 0 sparisce: un numero scritto localmente 0812... diventa +62812.... Salva la forma E.164, normalizza qualsiasi cosa digiti l'utente eliminando spazi, trattini e lo 0 iniziale, e lascia a una libreria per numeri di telefono mantenuta il giudizio sulla validità, perché i numeri di abbonato indonesiani non hanno tutti la stessa lunghezza.

I template SMS inviati ai numeri indonesiani sono spesso in bahasa indonesiano, anche se alcuni servizi inviano in inglese. Estrai il codice con un modello di cifre invece di cercare parole come "kode" o "code", e il tuo parser non si preoccuperà della lingua del template.

Perché i team di prodotto testano i flussi di registrazione in Indonesia?

L'Indonesia è uno dei paesi più popolosi al mondo e il suo uso di internet è fortemente mobile-first, perciò la verifica del numero di telefono è in prima linea in molti flussi di onboarding. I team che si espandono nel Sud-Est asiatico vogliono vedere le proprie schermate indonesiane di registrazione e accesso comportarsi correttamente con un vero numero +62, verificare che i testi in bahasa indonesiano vengano visualizzati senza troncamenti e confermare che le proprie regole antifrode non blocchino utenti locali legittimi.

Anche i team operations regionali e dei marketplace usano la rotta per verificare gli account aziendali che gestiscono per negozi indonesiani. La pagina sui test QA spiega come inserire tutto questo in un piano di regressione.

E se il codice indonesiano non arriva mai?

Il tempo di consegna dipende dal servizio e dalla rotta, quindi concedi all'attivazione il margine necessario prima di decidere che è fallita. Quando nessun SMS arriva:

• Lascia scadere la finestra di 20 minuti, oppure annulla; in entrambi i casi l'intero importo torna automaticamente sul tuo wallet.
• Riordina un po' più tardi, oppure prova un'altra rotta di servizio se il tuo test lo consente.
• Conferma che il servizio di destinazione accetti i numeri virtuali per questa azione. Alcuni no, ed è esattamente per questo che esiste la regola di rimborso.
• Evita di riordinare in un ciclo serrato. Fai un backoff tra i tentativi, così un job CI non brucia i nuovi tentativi in pochi secondi.

Altre idee diagnostiche sono in ridurre i fallimenti nella consegna degli OTP.

Esiste un numero +62 dedicato e come viene fatturato?

No. Non è offerta una linea indonesiana a lungo termine self-service. I numeri dedicati sono un prodotto per Stati Uniti e Canada, a partire da $1.95/month. Se il tuo team ha davvero bisogno di una linea +62 duratura, scrivi a [email protected]; la possibilità di organizzarla dipende dalle norme locali e non è promessa.

La fatturazione dell'OTP Gateway usa un unico wallet prepagato in USD, senza canone mensile e senza un piano da scegliere. Ricarica il wallet con carta o con le stablecoin USDT/USDC; ogni ricarica genera una fattura PDF inviata via email per la tua contabilità. Gli account di sviluppo possono richiedere la modalità sandbox, che restituisce numeri e codici simulati per test di integrazione end to end senza spendere fondi. Vedi i prezzi oppure crea un account.

Domande frequenti

Posso testare il flusso di registrazione indonesiano della mia app senza una SIM locale?

Sì. Ordina un numero +62 dall'OTP Gateway per il servizio interessato, inseriscilo nella tua app e leggi il codice nella dashboard o tramite l'API.

Quale id paese usa l'API di OTP Route per l'Indonesia?

L'Indonesia è id, quindi una ricerca del prezzo si scrive GET /api/v1/prices?country=id&service=<id>.

Pago se l'SMS indonesiano non arriva mai?

No. Se nulla arriva durante la finestra di 20 minuti, o se annulli, l'intero addebito torna automaticamente sul tuo wallet.

Devo mantenere lo 0 iniziale quando salvo un cellulare indonesiano?

Tienilo solo per la visualizzazione in formato locale. Salva +62 seguito dal numero nazionale senza lo 0, che è la forma E.164.

I testi di verifica indonesiani saranno in inglese?

Non sempre. Molti arrivano in bahasa indonesiano, quindi analizza il codice numerico senza affidarti alle parole circostanti.

I numeri indonesiani sono ammessi per qualsiasi scopo?

Solo per un uso legittimo: testare e gestire i tuoi prodotti e account nel rispetto dei termini di ciascun servizio. L'Acceptable Use Policy di OTP Route si applica a ogni ordine.

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.