Numery weryfikacyjne Gujany Francuskiej (+594) dla programistów i QA

Jeden kod czy numer na stałe: co obsługuje Gujana Francuska?

Zanim napiszesz pierwszą linijkę kodu, ustal, którego produktu wymaga zadanie.

• OTP Gateway sprawdza się przy jednorazowych weryfikacjach: potwierdzeniu, że Twój proces rejestracji akceptuje numer weryfikacyjny z Gujany Francuskiej, teście regresji przed wydaniem albo jednorazowej konfiguracji regionalnego profilu firmy. Każdy numer służy do odbioru jednego kodu.
• Dedicated Virtual Numbers sprawdzają się tam, gdzie konto musi odbierać kody dalej, na przykład przy loginie stagingowym, z którego zespół QA korzysta co tydzień. Sprzedajemy je natychmiast wyłącznie w Stanach Zjednoczonych i Kanadzie, od $1.95/miesiąc.

Gujana Francuska należy do pierwszej grupy. Nie ma samoobsługowej linii +594 na dłużej; jeśli Twój zespół jej potrzebuje, napisz na [email protected], a dostępność zależy od lokalnych przepisów. Gdy nie wiesz, do której grupy należy dane zadanie, pomoże porównanie numerów tymczasowych i dedykowanych.

Jak wygląda sekwencja wywołań OTP API dla Gujany Francuskiej?

Identyfikator kraju dla Gujany Francuskiej to gf. Z kluczem Bearer (prefiks or_live_) i adresem https://otproute.com/api/v1:

1. GET /api/v1/prices?country=gf&service=<id> zwraca aktualną cenę i pokazuje, czy trasa jest otwarta.
2. POST /api/v1/activations z treścią {"service": "facebook", "country": "gf"} rezerwuje numer +594 i zwraca identyfikator aktywacji.
3. Twój test wpisuje numer w testowanej aplikacji.
4. Kod dociera do Ciebie przez activation.sms_received na webhooku albo przez GET /api/v1/activations/{id}, jeśli odpytujesz API.
5. POST /api/v1/activations/{id}/cancel zwalnia zamówienie, którego test już nie potrzebuje.

Żądania webhooków zawierają nagłówek X-OTPRoute-Signature w postaci t=<unix>,v1=<hex>. Oblicz HMAC-SHA256 z "<t>.<raw body>" przy użyciu sekretu endpointu, porównaj w stałym czasie, odrzucaj przestarzałe znaczniki czasu i deduplikuj po identyfikatorze aktywacji. Limity na konto to 10 kluczy API, 5 endpointów webhooków i 300 żądań na minutę; pełna dokumentacja jest w docs.

Dlaczego numery +594 mylą walidację telefonów?

Gujana Francuska to francuski region zamorski i korzysta z francuskiego planu numeracyjnego, ale ma własny kod kraju, +594, a nie francuskie +33. W użyciu krajowym numery mają dziesięć cyfr z zerem na początku: komórkowe zwykle zaczynają się od 0694, a stacjonarne od 0594. W formacie międzynarodowym zero odpada, więc numer komórkowy przyjmuje postać +594 694 XX XX XX.

Takie rozwiązanie rodzi kilka klasycznych błędów, a numer +594 do testów to najprostszy sposób, by je wychwycić:

• Selektor kraju, który zalicza francuskie terytoria do Francji i dokleja +33 do numeru 0694.
• Biblioteki telefoniczne, które zgłaszają region GF, podczas gdy Twoja logika biznesowa zna tylko FR.
• Kod wyświetlający numery w francuskich parach cyfr, ale zapisujący sformatowany ciąg zamiast E.164.

Przechowuj +594… bez spacji i traktuj region oraz kraj jako osobne pojęcia w modelu danych.

Które aplikacje mogą wysyłać kody weryfikacyjne na numery z Gujany Francuskiej?

Na trasie Gujany Francuskiej dostępnych jest obecnie ponad 700 usług. Aktualny przegląd obejmuje WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Snapchat, Telegram, Microsoft & Outlook, Amazon, Airbnb, Uber i LinkedIn.

Treść SMS-a jest zwykle po francusku, czyli w języku, którego używa większość lokalnych kont, ale każda usługa wybiera własne szablony, więc wyciągaj cyfry zamiast dopasowywać frazę. Zespoły testują tę trasę przy lokalizacji francuskojęzycznych procesów poza metropolią, obsłudze klientów z francuskich regionów zamorskich albo sprawdzaniu, czy konto regionalne nadal przechodzi weryfikację po zmianie konfiguracji.

Jak zamówić numer +594 z poziomu panelu?

Nie musisz pisać kodu:

1. Zarejestruj się za pomocą e-maila i 6-cyfrowego kodu z wiadomości albo przez logowanie Google, a przy okazji włącz uwierzytelnianie dwuskładnikowe TOTP.
2. Zasil portfel kartą lub stablecoinami USDT/USDC.
3. Wybierz Gujanę Francuską i usługę; cena wyświetla się przed potwierdzeniem.
4. Wklej numer do aplikacji, a następnie obserwuj stronę aktywacji, na której pojawi się kod.

Tę drogę zwykle wybierają pracownicy operacyjni i account managerowie w agencjach, podczas gdy inżynierowie podłączają API. Obie ścieżki korzystają z tego samego portfela.

Co zrobić, gdy kod nie przychodzi?

Aktywacje trwają 20 minut. Płatność jest pobierana tylko wtedy, gdy kod dotrze; anulowane zamówienie albo okno, które zamknie się bez SMS-a, automatycznie zwraca całą kwotę do portfela.

Jeśli czekasz na kod na numer +594:

• Poczekaj do końca okna; usługa bywa wolna, choć nic złego się nie dzieje.
• Sprawdź, czy usługa akceptuje numery wirtualne. Niektóre ich nie akceptują i właśnie na taki przypadek istnieje zwrot środków.
• Spróbuj później albo wybierz inną trasę usługi.
• Nie pisz skryptów, które natychmiast ponawiają zamówienie po każdej porażce; wykładniczy backoff sprawia, że trasa +594 pozostaje użyteczna dla wszystkich.

Więcej znajdziesz w naszych uwagach o ograniczaniu nieudanych dostaw OTP. Testy dla Gujany Francuskiej ograniczaj do produktów i kont, które należą do Twojego zespołu, przestrzegaj regulaminów usług i traktuj Politykę Dopuszczalnego Użytku OTP Route jako część umowy.

Jak wyglądają płatności, faktury i testy w sandboxie?

OTP Route działa w oparciu o przedpłacony portfel w USD: płacisz za faktyczne użycie, bez miesięcznej opłaty i bez planu. Portfel zasilasz kartą lub stablecoinami USDT/USDC, a po każdym doładowaniu dla Twojego działu księgowości przychodzi e-mailem faktura PDF. Aktualne stawki znajdziesz na stronie cennika.

Inżynierowie, którzy budują przepływ dla gf, mogą poprosić wsparcie o przełączenie konta deweloperskiego w tryb sandbox. Zwraca on symulowane numery i kody, więc przepływ +594, weryfikację webhooków i logikę ponowień można przetestować od początku do końca bez wydawania środków z portfela. Z perspektywy API routing OTP do Gujany Francuskiej niczym nie różni się od innych rynków: zmienia się tylko identyfikator kraju, a API weryfikacji SMS pozostaje takie samo.

Najczęstsze pytania

Czy mogę przetestować rejestrację w mojej aplikacji dla Gujany Francuskiej bez lokalnej karty SIM?

Tak. Zamów numer OTP Gateway dla gf, wpisz go w formularzu rejestracji i odczytaj kod w panelu albo z webhooka.

Czy numer z Gujany Francuskiej to to samo co francuski numer +33?

Nie. Gujana Francuska korzysta z francuskiego planu numeracyjnego, ale ma własny kod kraju, +594, a biblioteki telefoniczne traktują ją jako osobny region.

Ile kosztuje kod +594?

Od $0.20 za kod, w zależności od usługi; aktualną cenę pokazują panel i GET /api/v1/prices. Brak SMS-a w ciągu 20 minut oznacza automatyczny zwrot.

Czy mogę zatrzymać numer z Gujany Francuskiej na potrzeby późniejszych logowań?

Nie ma takiej opcji samoobsługowej. Długoterminowe Dedicated Numbers są dostępne tylko w USA i Kanadzie; napisz na [email protected], aby zapytać o +594.

W jakim języku przychodzą kody?

Zwykle po francusku, choć każda usługa wybiera własny szablon i może kierować się ustawieniem języka konta.

Czy mogę przetestować integrację, zanim zasilę portfel?

Poproś o tryb sandbox dla konta deweloperskiego. Symuluje on numery i kody, więc cały przepływ wypróbujesz bez wydawania pieniędzy.

Dlaczego mój kod z Gujany Francuskiej nie dotarł?

Usługa mogła zadziałać wolno, odrzucić numery wirtualne albo trasa mogła być zajęta. Poczekaj do końca okna, a potem spróbuj później lub inną trasą; nieudane zamówienia są zwracane.

Nazwy usług są znakami towarowymi ich właścicieli. OTP Route nie jest z nimi powiązany. Korzystaj z numerów zgodnie z prawem oraz przestrzegaj regulaminów poszczególnych usług i naszej Polityki akceptowalnego użytkowania.