API OTP Samoa: testare le registrazioni +685 nel Pacifico

Samoa in breve per team di prodotto e QA

Samoa è una nazione indipendente del Pacifico, con il samoano e l'inglese come lingue ufficiali. Una grande comunità samoana vive in Nuova Zelanda, Australia e Stati Uniti, perciò le app di rimesse, messaggistica e viaggi devono spesso funzionare per utenti che si spostano tra questi paesi e la madrepatria.

Vale la pena conoscere due particolarità. La prima: Samoa (+685) è un paese diverso dalle Samoa Americane, che rientrano nel piano di numerazione nordamericano con il prefisso +1 684; confonderli in un selettore di paese fa finire i codici nel posto sbagliato. La seconda: nel 2011 Samoa è passata sul lato occidentale della linea internazionale del cambio di data e oggi ha un orario molto in anticipo rispetto a UTC, il che la rende un caso comodo per testare i confini di data nella logica di scadenza.

Per un team di prodotto, Samoa raramente è un mercato di lancio a sé. Di solito compare all'interno di un rollout nel Pacifico, come requisito di un'app rivolta alla diaspora, oppure perché un'organizzazione partner di Apia ha bisogno di confermare un account aziendale. In ogni caso il compito è lo stesso: dimostrare che un utente +685 riesce a completare il tuo flusso di registrazione.

Come gestire un numero +685 nel codice?

I numeri nazionali samoani sono brevi rispetto alla maggior parte dei mercati, quindi i validatori tarati su numeri di nove o dieci cifre possono rifiutarne uno reale. Salva i numeri come +685 più le cifre nazionali, senza separatori, ed elimina lo zero che un utente aggiunge per abitudine. Poiché i timestamp dei webhook sono in secondi Unix, confrontali in UTC e non nell'ora locale: eviterai sorprese quando il tuo server e un tester a Samoa si trovano in giorni di calendario diversi.

Se il tuo prodotto permette agli utenti di passare da un numero neozelandese a uno samoano sullo stesso profilo, aggiungi un test che cambi il prefisso internazionale e verifichi che lo stato di verifica precedente venga azzerato, così che un codice inviato a un numero non venga mai accettato per l'altro.

Quali servizi sono disponibili sulle rotte di Samoa?

Il catalogo di Samoa elenca attualmente più di 600 servizi. Tra i più richiesti ci sono WhatsApp, Facebook, Instagram, Telegram, Google (Gmail e YouTube), Viber, Signal, TikTok, Microsoft e Outlook, Amazon e Discord. La copertura qui è più ridotta rispetto ai mercati grandi e cambia nel corso della giornata, quindi controlla GET /api/v1/services e GET /api/v1/countries prima di ogni esecuzione. Se un servizio manca, una rotta vicina come Figi o Tonga può andare bene per il tuo test.

Un catalogo più leggero è un buon motivo per rendere tollerante il tuo harness di test: se il servizio preferito è assente al momento dell'esecuzione, segna il caso come saltato e non come fallito, e annotalo perché qualcuno possa riprovare più tardi.

Richiedere un codice per Samoa tramite API

Con una chiave Bearer (or_live_…) su https://otproute.com/api/v1, consulta il prezzo con GET /api/v1/prices?country=ws&service=<id>, poi invia {"service": "<id>", "country": "ws"} a POST /api/v1/activations. Segui l'id dell'attivazione facendo polling su GET /api/v1/activations/{id} oppure restando in ascolto di activation.sms_received. Verifica l'HMAC di X-OTPRoute-Signature su ogni webhook, rifiuta i timestamp troppo vecchi e rendi il gestore sicuro da eseguire due volte per la stessa attivazione. La guida all'integrazione mostra lo schema completo.

I limiti di frequenza sono generosi per un mercato di queste dimensioni: ogni account ha fino a 10 chiavi, 5 endpoint webhook e 300 richieste al minuto. Se fai polling, qualche secondo tra un controllo e l'altro è più che sufficiente.

Farlo a mano dalla dashboard

1. Accedi e apri l'OTP Gateway.
2. Scegli il servizio, poi Samoa.
3. Controlla il prezzo in tempo reale e conferma.
4. Incolla il numero +685 nell'app in prova e richiedi il codice.
5. Leggi il codice a schermo, oppure annulla se non ti serve più.

Quando un codice +685 è lento o non arriva

Tieni l'attivazione aperta per tutti i 20 minuti prima di rinunciare. Alcune app rifiutano del tutto i numeri virtuali, ed è proprio per questo che gli ordini senza risposta vengono rimborsati. Se una rotta resta muta, riprova più tardi o scegli un'altra rotta di servizio; lanciare nuovi ordini a raffica raramente aiuta e consuma il tuo limite di richieste.

Registra l'id dell'attivazione a ogni tentativo, così potrai capire se il silenzio dipende da una particolare app o dall'intera rotta.

Numeri a lungo termine e pagamento dell'utilizzo

OTP Route non vende un numero samoano a lungo termine in modalità self-service. I Numeri Dedicati partono da $1.95/month e sono limitati a Stati Uniti e Canada; per una linea a Samoa scrivi a [email protected], senza alcuna promessa che si possa organizzare. Il wallet prepagato in USD accetta carte e USDT/USDC, invia una fattura PDF per ogni ricarica e non ha canone mensile. Richiedi la modalità sandbox su un account di sviluppo per provare il flusso ws senza spendere fondi.

Domande frequenti

Samoa è la stessa cosa delle Samoa Americane per i numeri di telefono?

No. Samoa usa +685, mentre le Samoa Americane usano +1 684. Scegli quello giusto nel selettore di paese e nell'API.

Qual è l'id di paese API per Samoa?

Usa ws nella query dei prezzi e nella richiesta di attivazione.

Quanto costa un codice di verifica per Samoa?

Da $0.20 per codice; il prezzo esatto dipende dal servizio e viene mostrato prima dell'ordine.

Posso testare la registrazione di un utente samoano dalla Nuova Zelanda o dall'Australia?

Sì. Il numero +685 riceve l'SMS e OTP Route te lo mostra ovunque lavori il tuo team.

Pago se non arriva nessun messaggio?

No. Le attivazioni scadute o annullate vengono rimborsate automaticamente sul wallet.

In che lingua arrivano i codici di Samoa?

Di solito in inglese, lingua ufficiale insieme al samoano. Analizza le cifre, non il testo che le circonda.

Posso usare questi numeri per aprire molti account?

No. Rispetta i termini di ciascun servizio; l'Acceptable Use Policy limita OTP Route ai test e alla gestione dei tuoi account e prodotti legittimi.

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.