Costruire un test di verifica +592 con webhook e polling

Come progetto un flusso API OTP per la Guyana basato sui webhook?

Per qualsiasi cosa oltre a un controllo occasionale, lascia che sia la piattaforma a inviarti i codici invece di chiederli continuamente. Nella console sviluppatori aggiungi un endpoint HTTPS (un account può averne 5) e iscrivilo a activation.sms_received, oltre a activation.expired e activation.cancelled, così il tuo test runner viene a sapere dei vicoli ciechi con la stessa rapidità dei successi.

Considera ogni richiesta in arrivo non attendibile finché non supera la verifica:

• Leggi l'header X-OTPRoute-Signature, che ha la forma t=<unix>,v1=<hex>.
• Unisci il timestamp, un punto e il corpo della richiesta non modificato, poi calcola l'HMAC-SHA256 di quella stringa con il secret dell'endpoint.
• Confronta il tuo digest con v1 in tempo costante e scarta la richiesta se il timestamp è obsoleto.
• Trova l'id dell'attivazione nell'evento; se l'hai già elaborato, restituisci successo e non fare altro.

Quest'ultima regola rende il gestore idempotente, così una nuova consegna dopo un problema di rete non confonde mai il test. Un approfondimento si trova in acquisizione OTP tramite webhook.

Quali endpoint e id usa un ordine +592?

Autenticati con una chiave Bearer della console sviluppatori; le chiavi live iniziano con or_live_ e ogni account può tenerne fino a 10. L'URL di base è https://otproute.com/api/v1 e l'id paese della Guyana è gy.

Un'esecuzione tipica legge prima GET /api/v1/prices?country=gy&service=<id>, perché prezzo e disponibilità su questa rotta sono valori in tempo reale e non costanti. Poi invia POST /api/v1/activations con {"service": "<id>", "country": "gy"} e ottiene un numero +592 insieme a un id di attivazione. Senza webhook, il runner fa polling su GET /api/v1/activations/{id} ogni pochi secondi, ben al di sotto del limite di 300 richieste al minuto. Un passaggio di teardown chiama POST /api/v1/activations/{id}/cancel quando il test viene interrotto, e una chiamata preliminare a GET /api/v1/balance ferma subito la suite se il wallet è scarico. Gli id dei servizi arrivano da GET /api/v1/services; l'hub per sviluppatori contiene esempi client per questa API di verifica SMS.

Come si formattano i numeri +592 per l'archiviazione?

La Guyana usa il prefisso internazionale 592 e numeri nazionali di sette cifre senza alcun prefisso interurbano da togliere, quindi la forma E.164 è semplicemente +592 seguito da quelle sette cifre. Di solito le cifre si scrivono in un gruppo da tre e uno da quattro.

Senza zero iniziale da rimuovere, la normalizzazione si riduce a eliminare spazi e trattini e ad aggiungere il prefisso paese quando l'utente digita solo le cifre locali. Un bug frequente è un modulo che presume che ogni numero sudamericano abbia un prefisso di zona, oppure impone una lunghezza minima superiore a sette cifre, e così respinge inserimenti guyanesi validi. Un numero +592 per i test lo fa emergere subito. Salva la stringa E.164 e applica la formattazione locale solo al momento della visualizzazione.

Quali servizi possono ricevere codici SMS OTP della Guyana e posso ordinare manualmente?

La rotta della Guyana elenca più di 900 servizi. Tra quelli richiesti più spesso ci sono WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix e Claude. Quell'elenco è un'istantanea del catalogo in tempo reale, quindi confermalo tramite l'API o la dashboard prima di pianificare un test attorno a un mittente specifico.

Per i colleghi che non scrivono codice, la dashboard svolge lo stesso compito. Accedi, apri l'OTP Gateway, scegli la Guyana e un servizio, controlla il prezzo e ordina. Il numero di verifica della Guyana compare insieme a un conto alla rovescia di 20 minuti e, all'arrivo, il codice viene mostrato accanto.

Cosa deve fare un test quando il codice +592 è in ritardo o manca?

Un'attivazione resta aperta per 20 minuti. Paghi solo se il codice arriva entro quella finestra; se scade o annulli, l'intero importo torna sul wallet senza alcun ticket al supporto.

Gestione sensata in un'esecuzione automatizzata:

1. Attendi la fine della finestra prima di dichiarare il fallimento, a meno che il test abbia un limite di tempo rigido, nel qual caso annulla esplicitamente.
2. Riprova più tardi, oppure passa a un'altra rotta di servizio se l'API ne offre una.
3. Verifica se il servizio di destinazione accetta numeri virtuali; alcuni li rifiutano e il rimborso copre esattamente questo caso.
4. Distanzia i tentativi con un backoff invece di riordinare in un ciclo serrato.

La guida all'instradamento per paese dei codici OTP spiega come scegliere rotte di riserva.

Perché i team testano i flussi di registrazione in Guyana?

La Guyana è l'unico paese sudamericano con l'inglese come lingua ufficiale e Georgetown ospita il Segretariato della CARICOM, perciò compare spesso nei lanci che trattano la Comunità caraibica come un unico mercato. Un settore energetico offshore in rapida crescita ha attirato appaltatori e fornitori internazionali, mentre una vasta diaspora negli Stati Uniti, in Canada e nel Regno Unito mantiene attive le app di rimesse, messaggistica e viaggi sui numeri +592. Il creolo guyanese è molto parlato nella vita di tutti i giorni, ma i messaggi di verifica arrivano in genere in inglese. Per il QA questo sposta l'attenzione sull'inserimento del numero, sui selettori del paese e sul testo del consenso SMS, più che sui testi tradotti. Mantieni ogni controllo su account della tua organizzazione, rispetta i termini di ciascun servizio e ricorda che l'Acceptable Use Policy di OTP Route copre tutti gli ordini.

Posso tenere una linea guyanese e come viene fatturato l'utilizzo?

Per la Guyana non sono offerti numeri a lungo termine self-service. I numeri dedicati di OTP Route coprono solo Stati Uniti e Canada, a partire da $1.95/month. Per una linea +592 scrivi a [email protected] e il team verificherà cosa consentono le norme locali, senza alcuna promessa.

Il pagamento avviene tramite un unico wallet prepagato in USD: nessun canone mensile, nessun piano, ricariche con carta o USDT/USDC e una fattura PDF via email per ciascuna. Un account di sviluppo può essere passato in sandbox su richiesta, così i test di integrazione girano su numeri e codici simulati lasciando intatto il saldo. Le tariffe per servizio compaiono nella pagina dei prezzi.

Domande frequenti

Posso verificare la registrazione della mia app in Guyana senza una SIM di un operatore guyanese?

Sì. Ordina dall'OTP Gateway un numero +592 per il tuo servizio, inseriscilo nel tuo flusso e il codice compare nella dashboard o arriva al tuo webhook. I prezzi partono da $0.20 per codice.

Quale id paese usa l'API per la Guyana?

È gy, usato sia nella query dei prezzi sia nel corpo della richiesta di attivazione.

Devo togliere uno zero iniziale dai numeri guyanesi?

No. La Guyana non ha prefisso interurbano, quindi la forma E.164 è +592 seguito dal numero di sette cifre.

In che lingua arrivano i messaggi di verifica +592?

Di solito in inglese, la lingua ufficiale. Tuttavia è il mittente a decidere il testo e può seguire l'impostazione di lingua dell'app.

C'è un rimborso se il servizio non invia mai l'SMS?

Sì, ed è automatico. Se passano 20 minuti senza codice, o se annulli, l'intero importo torna sul tuo wallet.

Posso provare l'intera integrazione senza spendere denaro?

Chiedi al supporto di passare in sandbox il tuo account di sviluppo. Restituisce numeri e codici simulati, così chiamate API e webhook si possono esercitare end to end.

È disponibile un numero +592 a lungo termine?

Non come prodotto self-service. I numeri dedicati sono venduti solo negli Stati Uniti e in Canada; scrivi a [email protected] per informarti sulla Guyana.

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.