La via degli sviluppatori ai codici di verifica svizzeri (+41)

Quali richieste restituiscono un codice svizzero tramite API?

L'API OTP per la Svizzera è la stessa piccola superficie usata per ogni paese, con ch come id del paese. Autenticati con una chiave Bearer (prefisso or_live_) creata nella console Developer; un account può avere fino a 10 chiavi.

1. Recupera gli id da GET /api/v1/services e GET /api/v1/countries e tienili in cache tra un'esecuzione e l'altra.
2. Controlla GET /api/v1/prices?country=ch&service=<id>. La risposta contiene il prezzo attuale e indica se in questo momento c'è una route disponibile.
3. Invia POST /api/v1/activations con {"service": "whatsapp", "country": "ch"} o con il servizio che il tuo test deve coprire. Conserva l'id dell'attivazione restituito.
4. Inserisci il numero +41 nel campo telefono del tuo prodotto.
5. Leggi il risultato da GET /api/v1/activations/{id} o da un webhook; per interrompere in modo pulito usa POST /api/v1/activations/{id}/cancel.

GET /api/v1/balance va nel passaggio di setup della tua suite. Il limite è di 300 richieste al minuto per account, sufficiente per più job concorrenti che fanno polling a intervalli rilassati. Riferimento degli endpoint: documentazione.

Polling o webhook per le attivazioni +41?

Il polling mantiene semplice uno script rapido. I webhook diventano preferibili appena i test girano in parallelo, perché nulla resta in attesa mentre un SMS diretto a Zurigo è ancora in viaggio.

OTP Route permette di registrare fino a cinque endpoint; iscrivi ciascuno a activation.sms_received, activation.expired e activation.cancelled. Verifica ogni consegna prima di fidarti: prendi le parti t e v1 di X-OTPRoute-Signature, calcola l'HMAC-SHA256 di "<t>.<raw body>" con il secret dell'endpoint, confronta in tempo costante e rifiuta i timestamp fuori da una breve tolleranza. Basa l'elaborazione sull'id dell'attivazione, così una consegna ripetuta non ha effetti.

Per un approfondimento sui controlli della firma, vedi come proteggere i webhook OTP con HMAC.

Come dovrebbe apparire un numero svizzero nel tuo database?

A livello nazionale i numeri svizzeri iniziano con il prefisso 0, ad esempio un cellulare scritto 079 123 45 67. In formato internazionale quello zero scompare: la forma E.164 è +41 79 123 45 67, con nove cifre dopo il prefisso del paese. Le numerazioni mobili rientrano nel blocco 07x. Salva la stringa canonica +41… e formattala solo per la visualizzazione, altrimenti deduplicazione e ricerche si rompono quando una forma dice 079 e un'altra +4179.

L'altra peculiarità svizzera è la lingua. Con tedesco, francese, italiano e romancio tutti lingue nazionali, un SMS di verifica può arrivare in una delle prime tre a seconda di come il mittente gestisce la localizzazione, e molte app ripiegano semplicemente sull'inglese. Se il tuo prodotto si localizza per regione, un vero codice +41 è un modo economico per verificare che venga attivato il template giusto.

I team testano qui prima di lanciare un prodotto fintech o e-commerce sul mercato svizzero, quando supportano personale che gestisce account aziendali da Ginevra o Basilea, o quando convalidano flussi transfrontalieri che toccano anche il Liechtenstein, che usa il proprio prefisso +423.

Servizi verificabili con un numero di verifica svizzero

L'istantanea attuale per ch elenca Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, WhatsApp, Telegram, Signal, Uber, Airbnb, Amazon, eBay, Netflix, Discord, ChatGPT (OpenAI) e Claude, tra gli altri. In totale la Svizzera conta più di 1.700 servizi sull'OTP Gateway.

Poiché la disponibilità cambia nel corso della giornata, considera questo elenco un punto di partenza e interroga i dati in tempo reale durante l'esecuzione. Un harness che controlla prima i prezzi e segna un test come saltato quando la route è chiusa produce report molto più puliti di uno che riprova alla cieca.

Come risolvere un'attivazione svizzera che resta vuota

Quando un numero +41 non riceve nulla, segui questi passaggi prima di toccare il codice:

• Dai una possibilità all'intera finestra di 20 minuti; alcune piattaforme mettono in coda i messaggi in uscita.
• Controlla se il servizio rifiuta i numeri virtuali. Diversi lo fanno, ed è proprio il caso per cui esiste il rimborso automatico.
• Riprova dopo una pausa, oppure usa un'altra route di servizio, invece di rifare l'ordine in un ciclo serrato.
• Annulla le attivazioni abbandonate, così il denaro torna subito.

L'articolo sul routing dei paesi per gli OTP spiega perché la stessa app può comportarsi in modo diverso da una route paese all'altra.

Esiste un numero svizzero a lungo termine?

Non come prodotto self-service. Per la Svizzera, OTP Route offre numeri monouso solo tramite l'OTP Gateway.

I Dedicated Virtual Numbers, che mantieni finché li rinnovi, sono limitati a Stati Uniti e Canada e partono da $1.95/mese. Se ti serve proprio una linea svizzera persistente, scrivi a [email protected] descrivendo il caso d'uso; la risposta dipende dalle norme locali e non può essere promessa in anticipo.

Wallet, fatture e sandbox per il routing OTP svizzero

Paghi a consumo da un unico wallet USD prepagato. Non c'è canone mensile né piano da scegliere. Lo ricarichi con carta o con USDT/USDC e per ogni ricarica ricevi una fattura PDF via email, utile all'amministrazione delle società svizzere che riconciliano in franchi.

Per il lavoro di integrazione, richiedi la modalità sandbox su un account di sviluppo. Restituisce numeri e codici simulati, così l'intero percorso dell'API di verifica SMS si testa senza spendere fondi del wallet. Usa le attivazioni reali solo per i tuoi prodotti e account, nel rispetto dei termini di ciascun servizio e dell'Acceptable Use Policy di OTP Route. La pagina della soluzione per il QA testing mostra come i team la integrano nei controlli di rilascio.

Domande frequenti

Quale id paese usa l'API per la Svizzera?

La Svizzera è ch. Le richieste svizzere portano questo valore di due lettere ovunque sia previsto un paese, compreso il corpo dell'attivazione.

Posso verificare un login svizzero senza una SIM svizzera?

Sì. Un numero +41 per i test dell'OTP Gateway riceve il codice, che poi leggi nella dashboard o tramite API.

Devo tenere lo 0 quando salvo un cellulare svizzero?

No. Lo 0 è un prefisso interurbano nazionale; salva la forma E.164 che inizia con +41 seguito da nove cifre.

In che lingua sarà un SMS di verifica svizzero?

Dipende dal mittente: tedesco, francese, italiano o inglese sono tutti frequenti. Estrai il codice con un pattern di cifre anziché con una formulazione fissa.

Quanto costa un OTP SMS per la Svizzera?

Da $0.20 per codice, con il prezzo esatto per servizio restituito da GET /api/v1/prices prima dell'ordine.

Che fine fanno i miei soldi se non arriva nessun codice?

Tornano automaticamente sul tuo wallet quando la finestra si chiude o quando annulli l'attivazione.

Il Liechtenstein è coperto dalla route svizzera?

No, il Liechtenstein ha un proprio prefisso +423 e una propria pagina nell'elenco dei paesi, quindi va ordinato separatamente.

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.