Portare i codici di verifica argentini (+54) nella tua integrazione

Quali sono le quattro chiamate API dietro un'attivazione +54?

Tutto si trova sotto https://otproute.com/api/v1 e si autentica con una chiave Bearer che inizia con or_live_. Le chiavi si emettono nella Developer console; un account può averne fino a 10 e registrare 5 endpoint webhook, con un tetto di 300 richieste al minuto.

1. Chiedi il prezzo. Chiama GET /api/v1/prices?country=ar&service=<id> così il tuo codice conosce il costo live prima di impegnare fondi del wallet. L'id paese dell'Argentina è ar.
2. Ordina. Invia POST /api/v1/activations con il corpo JSON {"service": "whatsapp", "country": "ar"}, sostituendo l'id del servizio che serve al tuo test. La risposta contiene un id di attivazione e il numero +54 da inserire nell'app sotto test.
3. Attendi. Leggi GET /api/v1/activations/{id} a intervalli ragionevoli, oppure lascia che sia il webhook activation.sms_received a dirti che il codice è arrivato.
4. Rilascialo in anticipo, se serve. POST /api/v1/activations/{id}/cancel chiude un'attivazione che non ti serve più e restituisce il denaro al wallet.

Se vuoi vedere gli id prima di scriverli nel codice, GET /api/v1/services e GET /api/v1/countries elencano ciò che la piattaforma offre in questo momento. Il materiale di riferimento completo è nella documentazione.

Come rendo affidabile il ricevitore webhook per i codici argentini?

Ogni consegna include un header X-OTPRoute-Signature nella forma t=<unix>,v1=<hex>. Ricostruisci la stringa "<t>.<raw body>", calcola l'HMAC-SHA256 con il secret di quell'endpoint e confronta il risultato con v1 usando una funzione a tempo costante. Scarta ogni richiesta con timestamp vecchio, perché una firma vecchia ma valida è esattamente l'aspetto di un replay.

Oltre a activation.sms_received, sottoscrivi activation.expired e activation.cancelled, così un test runner non resta mai in attesa di un numero già chiuso. Tratta ogni evento come identificato dall'id dell'attivazione e scrivi l'handler in modo che una seconda consegna dello stesso evento non cambi nulla. L'articolo su come firmare e verificare i webhook OTP approfondisce la logica di confronto.

Con quali app posso verificare un numero argentino?

L'istantanea live per l'Argentina elenca più di 2.000 servizi. Quelli a cui i team di prodotto e QA argentini ricorrono più spesso includono:

• Messaggistica: WhatsApp, Telegram, Signal, Discord
• Account e produttività: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI)
• Social e video: Instagram, TikTok
• Commercio e mobilità: Amazon, Uber, Airbnb, Netflix

Questo elenco cambia durante la giornata, ed è per questo che l'API riporta la disponibilità in tempo reale invece che in una tabella statica. Interroga GET /api/v1/services pensando al paese ar prima che parta un job CI pianificato e fallisci subito con un messaggio chiaro se il servizio di destinazione manca temporaneamente.

Perché i cellulari argentini mettono in difficoltà i validatori di numeri?

L'Argentina ha uno dei piani di numerazione più insoliti della regione. A livello nazionale si scrive uno 0 di prefisso prima del prefisso distrettuale e, per i cellulari, un 15 prima delle cifre dell'abbonato, quindi un cellulare di Buenos Aires può comparire come 011 15 seguito da otto cifre. Nella forma internazionale E.164 entrambi scompaiono e un 9 viene inserito subito dopo il prefisso del paese: +54 9 11 e poi le otto cifre dell'abbonato.

Questa differenza conta per chiunque salvi numeri di telefono. Normalizza tutto in E.164 prima di salvare, elimina lo 0 e il 15 in input e aggiungi il 9 per i numeri mobili. Un validatore che controlla solo la lunghezza accetterà volentieri un valore +54 11 in stile linea fissa che non può ricevere SMS. Usa il numero esattamente come lo restituisce l'API invece di riformattarlo da solo.

I codici inviati ai numeri argentini arrivano di solito in spagnolo, spesso con una frase come "Tu código es" attorno alle cifre. Estrai il codice numerico con un pattern invece di cercare le parole, perché i template cambiano. I team testano qui quando si lanciano in America Latina, quando verificano i testi in spagnolo rioplatense (le forme locali con vos differiscono dallo spagnolo da manuale), quando gestiscono operazioni regionali o quando servono argentini all'estero che si registrano ancora con una SIM +54.

Chi non scrive codice può ordinare un numero +54?

Sì. Il personale di supporto, growth e delle agenzie può fare tutto dal browser:

1. Crea un account dalla pagina di registrazione con un'email e un codice a 6 cifre, oppure con l'accesso Google.
2. Aggiungi fondi al wallet.
3. Apri l'OTP Gateway, scegli l'Argentina e poi il servizio che stai testando.
4. Controlla il prezzo mostrato, conferma e copia il numero +54 nella schermata di verifica dell'app.
5. Osserva l'attivazione; il codice compare lì non appena viene ricevuto.

La dashboard e l'API usano lo stesso wallet e le stesse attivazioni, quindi uno sviluppatore può riprendere un numero ordinato da un collega tramite il suo id di attivazione.

Il codice argentino non è arrivato. E ora?

Ogni attivazione resta aperta per 20 minuti. Se non arriva nulla, o se annulli prima, l'intero importo torna automaticamente nel wallet, quindi una rotta silenziosa ti costa tempo, non denaro. La velocità di consegna dipende dal servizio e dalla rotta, perciò dai alla finestra una possibilità reale prima di dichiararla fallita.

Poi passa in rassegna questo breve elenco:

• Richiedi di nuovo il codice dall'interno dell'app una volta sola, poi lascia scorrere la finestra.
• Riprova più tardi nella giornata, oppure ordina tramite un'altra rotta per lo stesso servizio.
• Verifica che il servizio accetti i numeri virtuali; alcuni li rifiutano, ed è il motivo per cui esiste il rimborso automatico.
• Evita di rifare l'ordine a ciclo continuo dalla CI. Aggiungi un back-off e un limite di tentativi.

Il nostro approfondimento su come ridurre le consegne OTP fallite tratta altri schemi per le rotte argentine. Mantieni ogni test entro i termini di ciascun servizio; si applica anche l'Acceptable Use Policy di OTP Route.

Possiamo tenere una linea argentina e come si paga?

Oggi non esiste un numero argentino a lungo termine in self-service. Se il tuo team ha bisogno di una linea +54 stabile, scrivi a [email protected] descrivendo il caso d'uso; la fattibilità dipende dalle norme locali e non è assicurata. I Dedicated Virtual Numbers, che mantieni finché si rinnovano e che inoltrano gli SMS in entrata al tuo webhook, sono un prodotto per Stati Uniti e Canada da $1.95/month.

La fatturazione passa da un unico wallet prepagato in USD, senza canone mensile e senza piani da scegliere. Ricarichi con carta o con USDT/USDC e ogni ricarica produce una fattura PDF via email. I dettagli sono nella pagina dei prezzi. Prima di spendere fondi reali, chiedi di passare il tuo account di sviluppo alla sandbox, che restituisce numeri e codici simulati così puoi provare l'intero flusso per l'Argentina end to end.

Domande frequenti

Qual è l'id del paese Argentina nell'API di OTP Route?

È ar. Passalo nel campo country di POST /api/v1/activations e nella query string di GET /api/v1/prices.

Devo aggiungere il 9 quando inserisco il numero +54 in un'app?

Usa il numero esattamente come lo restituisce OTP Route. Nel tuo database salva i cellulari argentini in formato E.164, che include il 9 dopo +54 ed elimina lo 0 e il 15 nazionali.

Quanto costa ricevere un SMS OTP dall'Argentina?

Da $0.20 per codice, in base al servizio. La cifra esatta è restituita da GET /api/v1/prices e mostrata prima che tu confermi un ordine.

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

Sì. Ordina un'attivazione per l'Argentina per la tua app o per il servizio di terze parti del tuo test, inserisci il numero +54 e leggi il codice nella dashboard o dal tuo webhook.

Lo stesso numero +54 funzionerà di nuovo per un accesso il mese prossimo?

No. Un numero del gateway copre un solo codice entro 20 minuti. Per gli account che devono continuare a ricevere codici, l'opzione adatta è un Dedicated Number negli USA o in Canada.

In che lingua sarà il testo di verifica argentino?

Di solito in spagnolo, anche se dipende dal mittente e dalle impostazioni di lingua dell'account. Estrai le cifre invece di affidarti alle parole circostanti.

Il polling è accettabile al posto dei webhook?

Sì. Interroga GET /api/v1/activations/{id} a intervalli moderati e resta ben al di sotto del limite di 300 richieste al minuto per account.

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.