Verifizierungsnummern für Französisch-Guayana (+594) für Entwickler und QA

Ein Code oder eine Nummer zum Behalten: Was unterstützt Französisch-Guayana?

Bevor Sie Code schreiben, klären Sie, welches Produkt die Aufgabe braucht.

• OTP Gateway passt zu einmaligen Verifizierungen: Sie prüfen, ob Ihr Registrierungsablauf eine Verifizierungsnummer aus Französisch-Guayana akzeptiert, führen vor einem Release einen Regressionslauf durch oder richten einmalig ein regionales Geschäftsprofil ein. Jede Nummer dient für genau einen Code.
• Dedicated Virtual Numbers passen zu Konten, die dauerhaft Codes empfangen müssen, etwa ein Staging-Login, den Ihr QA-Team jede Woche öffnet. Sie werden nur in den USA und Kanada sofort bereitgestellt, ab $1.95/Monat.

Französisch-Guayana gehört zur ersten Gruppe. Eine selbst buchbare Langzeit-Leitung mit +594 gibt es nicht; wenn Ihr Team eine braucht, schreiben Sie an [email protected] – die Verfügbarkeit hängt von den lokalen Vorschriften ab. Der Vergleich temporäre vs. dedizierte Nummern hilft, wenn Sie unsicher sind, auf welche Seite eine Aufgabe fällt.

Wie läuft die OTP-API-Abfolge für Französisch-Guayana ab?

Die Länderkennung für Französisch-Guayana ist gf. Mit einem Bearer-Schlüssel (Präfix or_live_) gegen https://otproute.com/api/v1:

1. GET /api/v1/prices?country=gf&service=<id> liefert den aktuellen Preis und zeigt, ob die Route offen ist.
2. POST /api/v1/activations mit {"service": "facebook", "country": "gf"} reserviert eine +594-Nummer und gibt eine Aktivierungs-ID zurück.
3. Ihr Test gibt die Nummer in der zu testenden App ein.
4. Der Code erreicht Sie über activation.sms_received an einem Webhook oder über GET /api/v1/activations/{id}, falls Sie pollen.
5. POST /api/v1/activations/{id}/cancel gibt eine Bestellung frei, die der Test nicht mehr braucht.

Webhook-Anfragen enthalten X-OTPRoute-Signature in der Form t=<unix>,v1=<hex>. Berechnen Sie HMAC-SHA256 über "<t>.<raw body>" mit dem Endpoint-Secret, vergleichen Sie in konstanter Zeit, lehnen Sie veraltete Zeitstempel ab und entdoppeln Sie anhand der Aktivierungs-ID. Pro Konto gelten 10 API-Schlüssel, 5 Webhook-Endpunkte und 300 Anfragen pro Minute; die vollständige Referenz finden Sie in der Dokumentation.

Warum bringen +594-Nummern die Telefonvalidierung durcheinander?

Französisch-Guayana ist eine französische Übersee-Region und folgt dem französischen Nummernplan, hat aber mit +594 eine eigene Landesvorwahl statt der französischen +33. National sind die Nummern zehnstellig mit führender 0: Mobilnummern beginnen typischerweise mit 0694, Festnetznummern mit 0594. International entfällt die 0, aus einer Mobilnummer wird also +594 694 XX XX XX.

Diese Konstruktion erzeugt einige klassische Fehler, und eine +594-Nummer zum Testen ist der einfachste Weg, sie zu finden:

• Eine Länderauswahl, die französische Gebiete unter Frankreich zusammenfasst und einer 0694-Nummer fälschlich +33 voranstellt.
• Telefonbibliotheken, die die Region als GF melden, während Ihre Geschäftslogik nur FR kennt.
• Anzeigecode, der in französischen Zifferngruppen formatiert, aber den formatierten String statt E.164 speichert.

Speichern Sie +594… ohne Leerzeichen und behandeln Sie Region und Land in Ihrem Datenmodell als getrennte Konzepte.

Welche Apps können Verifizierungscodes an Nummern aus Französisch-Guayana senden?

Auf der Route für Französisch-Guayana sind derzeit mehr als 700 Dienste verfügbar. Der aktuelle Stand umfasst WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Snapchat, Telegram, Microsoft & Outlook, Amazon, Airbnb, Uber und LinkedIn.

Der SMS-Text ist meist französisch, passend zur Sprache der meisten lokalen Konten, doch jeder Dienst wählt seine eigenen Vorlagen. Extrahieren Sie deshalb die Ziffern, statt auf eine Formulierung zu prüfen. Teams testen hier, wenn sie französischsprachige Abläufe über das europäische Frankreich hinaus lokalisieren, Kunden in den französischen Überseeregionen bedienen oder prüfen, ob ein regionales Konto nach einer Konfigurationsänderung weiterhin verifiziert wird.

Wie bestellt man eine +594-Nummer im Dashboard?

Dafür ist kein Code nötig:

1. Registrieren Sie sich mit Ihrer E-Mail-Adresse und einem 6-stelligen E-Mail-Code oder per Google-Anmeldung und aktivieren Sie dabei gleich die TOTP-Zwei-Faktor-Authentifizierung.
2. Laden Sie das Guthaben per Karte oder mit USDT/USDC auf.
3. Wählen Sie Französisch-Guayana und den Dienst; der Preis wird vor der Bestätigung angezeigt.
4. Fügen Sie die Nummer in die App ein und beobachten Sie auf der Aktivierungsseite, wann der Code eintrifft.

Mitarbeitende im Betrieb und Account-Manager von Agenturen nutzen meist diesen Weg, während Entwickler die API anbinden. Beide greifen auf dasselbe Guthaben zu.

Was passiert, wenn der Code nie ankommt?

Aktivierungen laufen 20 Minuten. Bezahlt wird nur, wenn der Code ankommt; bei einer stornierten Bestellung oder einem Zeitfenster, das ohne SMS endet, geht der volle Betrag automatisch zurück ins Guthaben.

Wenn Sie auf einen +594-Code warten:

• Lassen Sie das Zeitfenster ablaufen; ein Dienst kann langsam sein, ohne dass etwas falsch ist.
• Prüfen Sie, ob der Dienst virtuelle Nummern akzeptiert. Manche tun es nicht, und genau für diesen Fall gibt es die Erstattung.
• Versuchen Sie es später erneut oder wählen Sie eine andere Dienstroute.
• Verzichten Sie darauf, nach jedem Fehlversuch sofort automatisch neu zu bestellen; ein exponentielles Backoff hält die +594-Route für alle nutzbar.

Unsere Hinweise zum Verringern fehlgeschlagener OTP-Zustellungen gehen weiter ins Detail. Beschränken Sie Tests für Französisch-Guayana auf Produkte und Konten, die Ihrem Team gehören, halten Sie die Nutzungsbedingungen jedes Dienstes ein und betrachten Sie die Acceptable Use Policy von OTP Route als Teil der Vereinbarung.

Wie laufen Zahlung, Rechnungen und Sandbox-Tests ab?

OTP Route arbeitet mit einem vorausbezahlten USD-Guthaben: Pay as you go, keine Monatsgebühr, kein Tarif. Aufgeladen wird per Karte oder mit den Stablecoins USDT/USDC, und nach jeder Aufladung erhält Ihre Buchhaltung eine PDF-Rechnung per E-Mail. Die aktuellen Preise stehen auf der Preisseite.

Wer den gf-Ablauf einbaut, kann den Support bitten, ein Entwicklungskonto auf Sandbox umzustellen. Es liefert simulierte Nummern und Codes, sodass der +594-Ablauf, die Webhook-Prüfung und die Retry-Logik durchgängig getestet werden können, ohne Guthaben auszugeben. Aus Sicht der API unterscheidet sich das OTP-Routing nach Französisch-Guayana nicht von anderen Märkten: Nur die Länderkennung ändert sich, die SMS-Verifizierungs-API bleibt dieselbe.

Häufige Fragen

Kann ich die Registrierung meiner App für Französisch-Guayana ohne lokale SIM-Karte testen?

Ja. Bestellen Sie eine OTP-Gateway-Nummer für gf, geben Sie sie in Ihr Registrierungsformular ein und lesen Sie den Code im Dashboard oder über Ihren Webhook.

Ist eine Nummer aus Französisch-Guayana dasselbe wie eine französische +33-Nummer?

Nein. Französisch-Guayana nutzt den französischen Nummernplan, hat aber eine eigene Landesvorwahl, +594, und Telefonbibliotheken behandeln es als eigene Region.

Was kostet ein +594-Code?

Ab $0.20 pro Code, je nach Dienst unterschiedlich; Dashboard und GET /api/v1/prices zeigen den aktuellen Preis. Keine SMS innerhalb von 20 Minuten bedeutet automatische Erstattung.

Kann ich eine Nummer aus Französisch-Guayana für spätere Logins behalten?

Eine selbst buchbare Option gibt es nicht. Langzeit-Dedicated-Numbers sind auf die USA und Kanada beschränkt; fragen Sie wegen +594 per E-Mail an [email protected] nach.

In welcher Sprache kommen die Codes an?

Meist auf Französisch, wobei jeder Dienst seine eigene Vorlage wählt und sich ggf. nach der Spracheinstellung des Kontos richtet.

Kann ich die Integration testen, bevor ich Guthaben aufgeladen habe?

Bitten Sie um den Sandbox-Modus für ein Entwicklungskonto. Er simuliert Nummern und Codes, sodass Sie den gesamten Ablauf testen können, ohne etwas auszugeben.

Warum ist mein Code für Französisch-Guayana nicht angekommen?

Der Dienst ist womöglich langsam, lehnt virtuelle Nummern ab oder die Route ist ausgelastet. Warten Sie das Zeitfenster ab, versuchen Sie es dann später oder über eine andere Route; fehlgeschlagene Bestellungen werden erstattet.

Dienstnamen sind Marken ihrer jeweiligen Inhaber. OTP Route steht in keiner Verbindung zu ihnen. Nutzen Sie die Nummern rechtmäßig und beachten Sie die Bedingungen des jeweiligen Dienstes sowie unsere Richtlinie zur akzeptablen Nutzung.