Codici di verifica della Polonia (+48): checklist, passaggi API e soluzioni

Controlli preliminari: cosa mi serve prima di testare le registrazioni polacche?

Scorri questo elenco una volta sola, e il primo ordine polacco tende a filare liscio:

1. Credenziali. Genera una chiave Bearer nella console per sviluppatori (inizia con or_live_). Chiavi separate per staging, CI e produzione rendono indolore la rotazione.
2. Identificativi. La Polonia è pl. Recupera gli id dei servizi da GET /api/v1/services invece di scrivere nel codice i nomi visualizzati.
3. Fondi. Ricarica il wallet; ogni prezzo è visibile prima dell'ordine.
4. Destinazione di consegna. Registra un webhook HTTPS e tieni il suo segreto fuori dal controllo di versione. Funziona anche il polling se il traffico in ingresso è bloccato.
5. Budget di richieste. L'API consente 300 richieste al minuto per account, quindi regola di conseguenza le suite parallele.
6. Ambito. Verifica solo account che appartengono al tuo prodotto, alla tua azienda o al tuo cliente, e rispetta i termini di ogni servizio insieme alla nostra Acceptable Use Policy.

Per le pipeline in particolare, vedi i test degli SMS OTP nelle pipeline CI.

Quali servizi inviano attualmente codici ai numeri +48?

Per il routing OTP, la Polonia è una delle voci più ampie del catalogo, con più di 2.300 servizi. L'istantanea attuale dei più richiesti comprende Facebook, Instagram, TikTok, WhatsApp, Telegram, Viber, Signal, Snapchat, Discord, X (Twitter), LinkedIn, Google (Gmail & YouTube), Amazon, AliExpress, Uber e Netflix.

Considera quell'elenco un punto di partenza e non una promessa. La disponibilità di ogni rotta cambia durante la giornata, quindi chiedi all'endpoint dei prezzi la coppia specifica prima di ogni ordine.

Quali sono i passaggi esatti per l'API OTP della Polonia?

Usando l'API di verifica SMS su https://otproute.com/api/v1, un test automatico fa quanto segue:

1. GET /api/v1/prices?country=pl&service=<id> conferma un prezzo in tempo reale per quel servizio in Polonia.
2. POST /api/v1/activations con {"service": "<id>", "country": "pl"} restituisce il numero +48 e un id di attivazione.
3. Il tuo test digita il numero nel modulo di registrazione e richiede l'SMS.
4. Il gestore riceve activation.sms_received; se vede activation.expired o activation.cancelled, segna l'esecuzione come non consegnata.
5. Senza un webhook, leggi GET /api/v1/activations/{id} ogni pochi secondi finché il codice compare o la finestra termina.
6. Chiama POST /api/v1/activations/{id}/cancel quando un test viene smontato in anticipo.

Convalida l'intestazione X-OTPRoute-Signature prima di fidarti di qualsiasi payload: contiene t=<unix>,v1=<hex>, dove v1 è l'HMAC-SHA256 di <t>.<raw body> firmato con il segreto dell'endpoint. Respingi tutto ciò che ha un timestamp vecchio e rendi il gestore idempotente sull'id di attivazione. La guida alla sicurezza dei webhook mostra il controllo in dettaglio.

Il mio team operativo può ordinare un numero polacco senza l'API?

Sì. Nella dashboard di OTP Route apri l'OTP Gateway, scegli la Polonia, cerca il servizio e conferma il prezzo mostrato. Dopo l'ordine, copia il numero di verifica polacco nella schermata di verifica dell'app e osserva la scheda dell'attivazione; il testo dell'SMS vi compare appena ricevuto. Non c'è nulla da installare, e lo stesso wallet finanzia sia il browser sia l'API.

Cosa rende diversi da gestire i numeri e i messaggi polacchi?

La Polonia usa un piano di numerazione chiuso senza prefisso nazionale (trunk): ogni numero, mobile o fisso, ha nove cifre dopo +48. Questo rende la validazione piacevolmente rigorosa. Rifiuta gli input che non si riducono a nove cifre nazionali, elimina gli spazi e i trattini che gli utenti aggiungono a gruppi di tre, e salva +48 più le nove cifre come un'unica stringa E.164. Uno zero iniziale di troppo è un errore di battitura, non un prefisso da conservare.

I messaggi di verifica arrivano spesso in polacco quando la lingua dell'account è il polacco. Caratteri come ą, ę, ł e ż non rientrano nell'alfabeto GSM a 7 bit, quindi se invii i tuoi SMS OTP in polacco aspettati segmenti più corti e testa il template così come viene visualizzato davvero su un telefono. Quando analizzi i codici in ingresso, basati sulle cifre e ignora le parole intorno.

Motivi comuni per testare qui: un prodotto che entra nel mercato polacco, il QA di localizzazione per i flussi in lingua polacca, i team regionali che gestiscono account aziendali in Europa centrale e le app i cui clienti includono polacchi che vivono altrove nell'UE.

Risoluzione dei problemi: perché manca il codice +48?

• La finestra è ancora aperta. Concedile tutti i 20 minuti prima di concludere qualcosa; paghi solo se un codice arriva.
• Il servizio potrebbe rifiutare i numeri virtuali. Alcune piattaforme lo fanno, e in quel caso il rimborso automatico riporta l'intero importo nel wallet.
• La rotta è occupata. Riprova più tardi, oppure prova un'altra rotta di servizio.
• Il test va in loop. Riordinare ogni pochi secondi consuma il tuo budget di richieste; aggiungi un backoff.

Altri schemi sono raccolti in ridurre i mancati recapiti OTP.

La Polonia ha numeri dedicati e come funzionano i pagamenti?

Non come prodotto self-service. I Dedicated Virtual Numbers, da $1.95/mese, sono offerti solo negli Stati Uniti e in Canada. Per una linea polacca a lungo termine scrivi a [email protected]; le norme locali decidono se è possibile, quindi non c'è alcuna promessa.

I pagamenti confluiscono in un unico wallet prepagato in USD: nessun piano, nessun canone mensile, ricariche con carta o USDT/USDC e una fattura PDF inviata via email per ogni ricarica. Gli sviluppatori possono richiedere la modalità sandbox per un account di sviluppo per ricevere numeri e codici simulati mentre costruiscono l'integrazione. Consulta i prezzi per le tariffe aggiornate.

Domande frequenti

Come posso testare una registrazione polacca se nessuno nel team ha una SIM +48?

Ordina un numero +48 per i test sull'OTP Gateway e usalo nel flusso. Il codice compare nella dashboard e può essere inviato al tuo webhook.

Qual è il codice paese della Polonia nelle chiamate API di OTP Route?

È pl, usato sia in POST /api/v1/activations sia nella query dei prezzi.

Quante cifre ha un numero di telefono polacco?

Nove cifre nazionali dopo +48, senza zero di trunk. Quella lunghezza fissa rende semplice la validazione lato server.

Quanto costa ricevere un SMS OTP dalla Polonia?

I prezzi partono da $0.20 per codice e variano in base al servizio. La dashboard e l'endpoint dei prezzi mostrano la cifra esatta prima dell'ordine.

Perdo denaro se un'attivazione polacca scade a vuoto?

No. Un'attivazione che termina senza codice, o che annulli, viene rimborsata per intero nel wallet.

Posso simulare l'intero flusso della Polonia prima di andare in produzione?

Sì. Chiedi la modalità sandbox per un account di sviluppo per ottenere numeri e codici simulati senza spendere fondi del wallet.

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.