Numeri di verifica della Guyana francese (+594) per sviluppatori e QA

Un solo codice o un numero da tenere: cosa offre la Guyana francese?

Prima di scrivere codice, decidi quale prodotto serve al tuo caso.

• OTP Gateway è adatto alle verifiche una tantum: controllare che il tuo flusso di registrazione accetti un numero di verifica della Guyana francese, una regressione prima di un rilascio, o la configurazione una tantum di un profilo aziendale regionale. Ogni numero serve per un solo codice.
• Dedicated Virtual Numbers sono pensati per gli account che devono continuare a ricevere codici, come un login di staging che il tuo team QA apre ogni settimana. Si acquistano subito solo negli Stati Uniti e in Canada, da $1.95/month.

La Guyana francese rientra nel primo gruppo. Non esiste una linea +594 a lungo termine in self-service; se il tuo team ne ha bisogno, scrivi a [email protected], tenendo presente che la disponibilità dipende dalle norme locali. Il confronto tra numeri temporanei e dedicati aiuta quando non sai da che parte stia un'attività.

Come funziona la sequenza dell'API OTP per la Guyana francese?

L'id paese della Guyana francese è gf. Con una chiave Bearer (prefisso or_live_) verso https://otproute.com/api/v1:

1. GET /api/v1/prices?country=gf&service=<id> restituisce il prezzo in tempo reale e indica se la rotta è aperta.
2. POST /api/v1/activations con {"service": "facebook", "country": "gf"} riserva un numero +594 e restituisce un id di attivazione.
3. Il tuo test inserisce il numero nell'app sotto test.
4. Il codice ti arriva tramite activation.sms_received su un webhook, oppure tramite GET /api/v1/activations/{id} se fai polling.
5. POST /api/v1/activations/{id}/cancel libera un ordine che il test non richiede più.

Le richieste webhook includono X-OTPRoute-Signature nel formato t=<unix>,v1=<hex>. Calcola l'HMAC-SHA256 di "<t>.<raw body>" con il segreto dell'endpoint, confronta in tempo costante, rifiuta i timestamp scaduti e deduplica sull'id di attivazione. I limiti per account sono 10 chiavi API, 5 endpoint webhook e 300 richieste al minuto; il riferimento completo è nella documentazione.

Perché i numeri +594 mettono in crisi la validazione dei telefoni?

La Guyana francese è una regione d'oltremare della Francia e segue il piano di numerazione francese, ma ha un prefisso internazionale proprio, +594, e non il +33 della Francia. A livello nazionale i numeri hanno dieci cifre con uno 0 iniziale: i cellulari iniziano di solito con 0694 e le linee fisse con 0594. In formato internazionale lo 0 si elimina, quindi un cellulare diventa +594 694 XX XX XX.

Questa struttura genera alcuni bug classici, e un numero +594 per i test è il modo più semplice per scovarli:

• Un selettore di paese che raggruppa i territori francesi sotto la Francia e antepone +33 a un numero 0694.
• Librerie telefoniche che riportano la regione come GF mentre la tua logica di business conosce solo FR.
• Codice di visualizzazione che formatta a coppie di cifre alla francese ma salva la stringa formattata invece dell'E.164.

Memorizza +594… senza spazi e tieni distinti nel modello dati i concetti di regione e di paese.

Quali app possono inviare codici di verifica ai numeri della Guyana francese?

Sulla rotta della Guyana francese sono attualmente disponibili più di 700 servizi. L'istantanea in tempo reale comprende WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Snapchat, Telegram, Microsoft & Outlook, Amazon, Airbnb, Uber e LinkedIn.

Il testo dell'SMS è di solito in francese, la lingua più usata dagli account locali, ma ogni servizio sceglie i propri modelli: estrai le cifre invece di cercare una frase precisa. I team fanno test qui quando localizzano flussi in francese oltre la Francia metropolitana, servono clienti nelle regioni francesi d'oltremare o verificano che un account regionale si convalidi ancora dopo una modifica di configurazione.

Come si ordina un numero +594 dalla dashboard?

Non serve alcun codice:

1. Registrati con la tua email e un codice email di 6 cifre, oppure con l'accesso Google, e già che ci sei attiva l'autenticazione a due fattori TOTP.
2. Ricarica il wallet con carta o con USDT/USDC.
3. Scegli la Guyana francese e il servizio; il prezzo viene mostrato prima della conferma.
4. Incolla il numero nell'app, poi osserva la pagina dell'attivazione per vedere il codice.

Questa strada è quella che di solito scelgono il personale operativo e gli account manager delle agenzie, mentre gli ingegneri integrano l'API. Entrambi attingono allo stesso wallet.

Cosa succede se il codice non arriva mai?

Le attivazioni durano 20 minuti. Il pagamento viene addebitato solo se il codice arriva; un ordine annullato, o una finestra che si chiude senza SMS, riaccredita automaticamente l'intero importo sul wallet.

Se stai aspettando un codice +594:

• Lascia terminare la finestra; un servizio può essere lento senza che ci sia alcun problema.
• Verifica se il servizio accetta numeri virtuali. Alcuni no, ed è proprio per questo caso che esiste il rimborso.
• Riprova più tardi o scegli un'altra rotta di servizio.
• Evita di automatizzare riordini immediati dopo ogni insuccesso; un backoff esponenziale mantiene la rotta +594 utilizzabile per tutti.

Le nostre note su come ridurre i mancati recapiti OTP approfondiscono il tema. Limita i test sulla Guyana francese a prodotti e account del tuo team, rispetta i termini di ciascun servizio e considera la Acceptable Use Policy di OTP Route parte dell'accordo.

Come si gestiscono pagamenti, fatture e test in sandbox?

OTP Route funziona con un wallet prepagato in USD: paghi a consumo, senza canone mensile e senza piani. La ricarica avviene con carta o con le stablecoin USDT/USDC, e dopo ogni ricarica ricevi via email una fattura PDF per la tua contabilità. Le tariffe attuali sono elencate nella pagina dei prezzi.

Gli ingegneri che stanno integrando il flusso gf possono chiedere al supporto di portare un account di sviluppo in sandbox. Restituisce numeri e codici simulati, così il flusso +594, la verifica dei webhook e la logica di retry si possono provare end to end senza spendere fondi dal wallet. Dal punto di vista dell'API, l'instradamento OTP verso la Guyana francese non è diverso da quello verso qualsiasi altro mercato: cambia solo l'id paese, mentre l'API di verifica SMS resta la stessa.

Domande frequenti

Posso testare la registrazione della Guyana francese della mia app senza una SIM locale?

Sì. Ordina un numero OTP Gateway per gf, inseriscilo nel tuo modulo di registrazione e leggi il codice nella dashboard o dal tuo webhook.

Un numero della Guyana francese è uguale a un numero francese +33?

No. La Guyana francese usa il piano di numerazione francese ma ha un proprio prefisso, +594, e le librerie telefoniche la trattano come una regione separata.

Quanto costa un codice +594?

Da $0.20 a codice, a seconda del servizio; la dashboard e GET /api/v1/prices mostrano il prezzo in tempo reale. Se non arriva alcun SMS entro 20 minuti, il rimborso è automatico.

Posso tenere un numero della Guyana francese per accessi futuri?

Non c'è un'opzione self-service. I Dedicated Numbers a lungo termine sono limitati a Stati Uniti e Canada; scrivi a [email protected] per informarti sul +594.

In che lingua arrivano i codici?

Di solito in francese, anche se ogni servizio sceglie il proprio modello e può seguire l'impostazione della lingua dell'account.

Posso provare l'integrazione prima di ricaricare il wallet?

Richiedi la modalità sandbox per un account di sviluppo. Simula numeri e codici, così puoi provare l'intero flusso senza spendere nulla.

Perché il mio codice della Guyana francese non è arrivato?

Il servizio potrebbe essere lento, rifiutare i numeri virtuali, oppure la rotta potrebbe essere occupata. Attendi la fine della finestra, poi riprova più tardi o su un'altra rotta; gli ordini non riusciti vengono rimborsati.

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.