Kody weryfikacyjne z Monako (+377) dla zespołów produktowych i QA

Dlaczego zespoły w ogóle testują na numerach monakijskich?

Monako jest maleńkie, ale dla firm z sektora bankowości prywatnej, hotelarstwa, usług jachtowych i imprez międzynarodowych znaczy więcej, niż wynikałoby z jego rozmiarów. Tamtejsi klienci oczekują, że produkt bez zastrzeżeń przyjmie numer +377, a zaskakująco wiele formularzy nadal zakłada, że każdy w okolicach Riwiery ma francuską linię +33.

To założenie powoduje realne zgłoszenia do wsparcia. Wiele osób pracujących w Monako mieszka za granicą we Francji i ma francuskie numery, podczas gdy mieszkańcy mają monakijskie, więc jedna baza klientów miesza oba kierunkowe. Numer weryfikacyjny z Monako, zamówiony jako numer +377 do testów, pozwala inżynierom QA udowodnić, że selektor krajów, reguły walidacji i szablony SMS traktują księstwo jako osobny kraj, a nie jako francuskie przedmieście.

Jak formularz powinien przechowywać i walidować numery +377?

Monako ma własny numer kierunkowy kraju, odrębny od Francji, a jego numery krajowe są krótkie w porównaniu z większością Europy. W formie międzynarodowej nie ma prefiksu krajowego: numer to +377 i bezpośrednio cyfry abonenta.

Kilka praktycznych zasad dla inżynierów:

• Zapisuj numery w E.164 (+377…), a przyjazne grupowanie stosuj dopiero przy wyświetlaniu.
• Użytkownicy przyzwyczajeni do francuskiego wybierania czasem z nawyku wpisują początkowe 0. Usuń je podczas normalizacji, zamiast zawalać walidację.
• Nie wnioskuj o kraju z prefiksu +33 i monakijskiego adresu pocztowego; kraj telefonu i kraj rozliczeniowy trzymaj w niezależnych polach.
• Używaj utrzymywanej biblioteki do numerów telefonów zamiast ręcznie pisanego sprawdzania długości, bo zakodowane na sztywno francuskie długości odrzucają poprawne numery monakijskie.

Językiem urzędowym jest francuski, więc wiadomości weryfikacyjne zwykle przychodzą po francusku, choć lokalnie szeroko używa się też włoskiego i angielskiego, a wiele aplikacji wysyła angielski, gdy tak ustawiono ustawienia regionalne konta. Przetestuj oba warianty, jeśli Twój onboarding jest zlokalizowany.

Które usługi może zweryfikować trasa Monako?

Na trasie Monako dostępnych jest teraz ponad 1 300 usług. Do popularnych w dzisiejszym zestawie należą Instagram, Airbnb, Telegram, Claude, WhatsApp, Facebook, Google (Gmail & YouTube), Uber, Netflix, eBay, LinkedIn i X (Twitter).

Pokrycie nie jest stałe. Partnerzy operatorscy rotują zasobami w ciągu dnia, więc usługa widoczna rano po południu może być wstrzymana. Rozsądny routing OTP odczytuje dostępność w momencie zamówienia, zamiast polegać na zapisanej liście, a API do weryfikacji SMS udostępnia dokładnie to przez endpoint cen.

Jak wygląda sekwencja Monaco OTP API?

Żądania trafiają pod https://otproute.com/api/v1 i uwierzytelniają się kluczem Bearer zaczynającym się od or_live_, utworzonym w konsoli deweloperskiej. Identyfikator kraju Monako to mc.

1. Od czasu do czasu pobieraj GET /api/v1/services i GET /api/v1/countries, aby odwzorować nazwy na identyfikatory.
2. Przed każdym zamówieniem wywołaj GET /api/v1/prices?country=mc&service=<id>. Odpowiada aktualną ceną i informacją, czy da się obsłużyć tę parę.
3. Utwórz zamówienie przez POST /api/v1/activations, na przykład {"service": "airbnb", "country": "mc"}. Zachowaj zwrócony identyfikator aktywacji.
4. Wpisz numer +377 w swojej aplikacji i poczekaj na activation.sms_received na webhooku albo odpytuj GET /api/v1/activations/{id}.
5. Przy sprzątaniu wywołaj POST /api/v1/activations/{id}/cancel dla wszystkiego, co nadal oczekuje.

Weryfikuj nagłówek X-OTPRoute-Signature każdego webhooka, obliczając ponownie HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, i odrzucaj stare znaczniki czasu. Każde konto może zarejestrować 5 endpointów webhooków i wysyłać do 300 żądań na minutę, co zostawia miejsce na równoległe przebiegi dla Monako. Przewodnik integracji przechodzi przez te same kroki wraz z obsługą błędów.

Czy jest sposób bez kodowania dla pracowników operacji?

Panel obejmuje tę samą ścieżkę dla każdego, kto woli nie dotykać API. Wybierz Monako w OTP Gateway, wskaż usługę, sprawdź cenę, która się pojawi, i potwierdź. Numer +377 pokazuje się na karcie aktywacji; wklej go na ekran logowania lub rejestracji, a kod pojawi się na tej karcie, gdy dotrze SMS.

Okno trwa 20 minut. Jeśli kod nie dotrze na czas albo anulujesz zamówienie, cała kwota wraca do portfela bez zgłoszenia do wsparcia.

Co zrobić, gdy kod z Monako nie dociera?

Małe rynki mają mniej tras, więc cierpliwość i plan awaryjny liczą się tu bardziej niż w dużych krajach.

• Daj zamówieniu pełne okno, zanim anulujesz.
• Sprawdź, czy usługa akceptuje numery wirtualne dla tej akcji; niektóre odmawiają wprost.
• Ponów próbę po przerwie zamiast zamawiać w pętli, co po stronie usługi może uruchomić limity.
• Jeśli test wymaga tylko numeru z okolic Riwiery, trasa Francji lub trasa Włoch mogą w danej chwili mieć większe zasoby.

Trzymaj każdy test w granicach regulaminu usługi. OTP Route służy do weryfikacji własnych produktów i legalnych kont biznesowych, a obowiązuje jej Acceptable Use Policy.

Czy można zachować numer z Monako na dłużej i jak działają rozliczenia?

Nie istnieje samoobsługowa, długoterminowa linia +377. Wirtualne Numery Dedykowane, które zachowujesz, dopóki się odnawiają, i które obsługują odbiór SMS, wysyłanie SMS oraz dzwonienie z przeglądarki, to produkt dla Stanów Zjednoczonych i Kanady od $1.95/month. W sprawie linii monakijskiej napisz na [email protected]; zespół powie, czy lokalne przepisy cokolwiek dopuszczają, bez żadnej obietnicy.

Zamówienia dla Monako korzystają z tego samego przedpłaconego portfela w USD co wszystko inne, bez opłaty miesięcznej i bez planu do wyboru. Zasilasz go kartą lub USDT/USDC i możesz oczekiwać faktury PDF e-mailem po każdej wpłacie. Podczas prac nad integracją konto deweloperskie można na prośbę przełączyć w tryb sandbox, który zwraca symulowane numery i kody, więc możesz testować od początku do końca za darmo. Szczegóły znajdują się na stronie cennika.

Najczęstsze pytania

Czy numer z Monako jest taki sam jak francuski?

Nie. Monako używa własnego kierunkowego +377, więc logika walidacji musi traktować go osobno od francuskiego +33.

Jaki jest identyfikator kraju Monako w API OTP Route?

Użyj mc w zapytaniu o ceny i w treści żądania aktywacji.

Czy mogę dostać numer +377 do testowania europejskiej premiery?

Tak, OTP Gateway wydaje jednorazowe numery +377 do pojedynczych weryfikacji, zamawiane z panelu lub przez API.

Ile mam czasu na odebranie kodu z Monako?

Każda aktywacja pozostaje otwarta przez 20 minut; jeśli nic nie dotrze, opłata jest zwracana automatycznie.

Czy numery monakijskie zawierają prefiks krajowy?

Nie w formie międzynarodowej. Usuń początkowe 0, które wpisze użytkownik, i zapisz numer jako +377 oraz cyfry abonenta.

W jakim języku będzie wiadomość weryfikacyjna od usługi z Monako?

Zwykle po francusku, ale zależy to od aplikacji i ustawień językowych konta, więc możliwe są też teksty angielskie lub włoskie.

Czy mogę uruchomić testy dla Monako bez wydawania prawdziwych środków?

Poproś o tryb sandbox dla konta deweloperskiego. Zwraca on symulowane numery i kody do testów integracji.

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.