Testowanie macedońskich (+389) kodów rejestracyjnych przed premierą

Lista kontrolna premiery mówi „zweryfikuj rejestracje +389”: od czego zacząć w QA?

Znana sytuacja: produkt wchodzi na Bałkany Zachodnie, proces rejestracji obsługuje już kilkanaście rynków, a ktoś musi udowodnić, że przyjmuje numery z Macedonii Północnej i że SMS wysyłany przez aplikację naprawdę dociera. Pożyczanie telefonu od kolegi się nie skaluje, a lokalna karta SIM jest niewygodna w runnerze CI.

OTP Gateway usuwa tę zależność. Zamawiasz numer weryfikacyjny z Macedonii Północnej przez API lub panel, wpisujesz go we własnym procesie i odbierasz każdy kod, który nadejdzie. Każdy numer obsługuje jedną weryfikację, więc zestaw testów regresyjnych może przy każdym uruchomieniu prosić o świeży numer +389 do testów. Przegląd testów QA pokazuje, jak zespoły włączają to w proces wydawniczy.

Jak zapisuje się numery +389 i co powinien akceptować Twój walidator?

Kod kraju Macedonii Północnej to +389, a krajowy prefiks wybierania to 0. Numery komórkowe zapisuje się lokalnie jako 07X XXX XXX; w formie międzynarodowej 0 znika, co daje +389 7X XXX XXX z ośmiocyfrowym numerem krajowym. Zapisuj format E.164 (+3897…), a formę lokalną traktuj wyłącznie jako format wejściowy.

Przypadki testowe, które warto zachować w zestawie:

• Użytkownik wybiera +389 i mimo to wpisuje 0; formularz powinien je usunąć, a nie odrzucić dane.
• Wklejone numery ze spacjami, ukośnikami lub myślnikami powinny normalizować się do jednej zapisanej wartości.
• Kontrole zakresów należą do utrzymywanej biblioteki numerów telefonów, a nie do zakodowanych na sztywno prefiksów, ponieważ zakresy operatorów z czasem się zmieniają.

Dlaczego szablony SMS cyrylicą zasługują na osobny test?

Macedoński jest językiem urzędowym w całym kraju i zapisuje się go cyrylicą; albański także ma status urzędowy i jest szeroko używany. Jeśli Twoja aplikacja wysyła wiadomość weryfikacyjną po macedońsku, znaki cyrylicy wymuszają kodowanie UCS-2, które zmniejsza pojedynczy segment SMS ze 160 do 70 znaków. Szablon, który po angielsku mieści się z zapasem, może rozpaść się na kilka segmentów albo zostać ucięty, jeśli Twój nadawca ogranicza długość.

Odbiór prawdziwej wiadomości na numerze +389 pokazuje, co zobaczyłby użytkownik: czy kod znajduje się na tyle blisko początku, by dało się go odczytać w podglądzie powiadomienia, czy uruchamia się wariant w alfabecie łacińskim i czy podpowiedzi autouzupełniania nadal działają. Parser powinien dopasowywać cyfry, a nie stałą frazę, ponieważ zewnętrzne usługi same wybierają sformułowanie i język.

Które wywołania pobierają numer z Macedonii Północnej programowo?

Dokumentacja dla deweloperów opisuje każde pole; zarys tego API weryfikacji SMS jest krótki. Uwierzytelnij się kluczem Bearer zaczynającym się od or_live_ w https://otproute.com/api/v1, a następnie:

1. Pobierz listę krajów przez GET /api/v1/countries; identyfikator Macedonii Północnej to mk.
2. Zapytaj GET /api/v1/prices?country=mk&service=<id> o aktualną cenę i dostępność.
3. Utwórz aktywację przez POST /api/v1/activations z treścią taką jak {"service": "viber", "country": "mk"}.
4. Odpytuj GET /api/v1/activations/{id} albo czekaj na activation.sms_received w webhooku.
5. Anuluj przez POST /api/v1/activations/{id}/cancel, gdy test skończy się wcześniej.

Wywołania webhooków niosą nagłówek X-OTPRoute-Signature: t=<unix>,v1=<hex>. Odtwórz HMAC-SHA256 z "<t>.<raw body>" przy użyciu sekretu endpointu, porównaj w stałym czasie, odrzucaj stare znaczniki czasu i przetwarzaj zdarzenia według identyfikatora aktywacji, aby ponowna dostawa była nieszkodliwa. Każde konto ma do 10 kluczy, 5 endpointów webhooków i 300 żądań na minutę.

Jakie usługi są teraz dostępne na trasie +389?

Macedonia Północna ma obecnie w OTP Gateway ponad 900 usług. Aktualna migawka obejmuje Viber, WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), TikTok, Microsoft & Outlook, Signal, LinkedIn, Uber i ChatGPT (OpenAI).

Nie każda usługa jest dostępna o każdej porze; to normalne w przypadku zasobu numerów SMS i dlatego ceny oraz dostępność podaje API. Koledzy pracujący bez kodu mogą wykonać te same kroki w panelu: załóż konto, doładuj portfel, wybierz Macedonię Północną i usługę, a kod pojawi się na stronie aktywacji, gdy tylko dotrze.

Kod nie dotarł: co teraz?

Każda aktywacja trwa 20 minut i płacisz tylko wtedy, gdy SMS nadejdzie. Anuluj ją albo pozwól, aby okno zamknęło się puste, a pełna kwota automatycznie wróci do portfela.

Zanim zamówisz ponownie:

• Poczekaj, aż okno upłynie; wolny nadawca zdarza się znacznie częściej niż zagubiona wiadomość.
• Sprawdź, czy usługa przyjmuje numery wirtualne; niektóre odrzucają je zgodnie z polityką, i właśnie to pokrywa zwrot.
• Spróbuj później albo przez inną trasę usługi.
• Zrób przerwę między próbami, aby niestabilny test nie wysyłał zamówienia za zamówieniem na trasę +389.

Przewodnik po routingu krajów wyjaśnia, jak planować rezerwy między rynkami. Używaj numerów wyłącznie do własnych produktów i kont, przestrzegaj regulaminu każdej usługi i pamiętaj, że obowiązują Zasady dopuszczalnego użytkowania OTP Route.

A co ze stałą macedońską linią, rozliczeniami i sandboxem?

OTP Route nie oferuje samoobsługowego numeru długoterminowego w Macedonii Północnej. Numery dedykowane to produkt dla USA i Kanady, sprzedawany natychmiast od $1.95/miesiąc; w sprawie trwałej linii +389 napisz na [email protected], a zespół odpowie, czy lokalne przepisy na to pozwalają, bez obietnicy dostępności.

Płatność odbywa się w modelu pay as you go z przedpłaconego portfela w USD, zasilanego kartą lub USDT/USDC, bez opłaty miesięcznej i z fakturą PDF za każde doładowanie. Konta deweloperskie można na życzenie przełączyć w tryb sandbox, aby integracje działały na symulowanych numerach i kodach.

Najczęstsze pytania

Czy mogę sprawdzić macedoński SMS rejestracyjny w mojej aplikacji bez karty SIM?

Tak. Poproś o numer OTP Gateway z krajem mk, użyj go na własnym ekranie rejestracji i odczytaj wiadomość w panelu lub z webhooka.

Ile kosztuje kod weryfikacyjny na numer +389?

Od $0.20 za kod; dokładna kwota zależy od usługi i jest widoczna w panelu lub zwracana przez GET /api/v1/prices. Jeśli 20-minutowe okno zamknie się bez SMS-a, odzyskasz całą kwotę.

Czy wiadomości weryfikacyjne na numery z Macedonii Północnej będą pisane cyrylicą?

To zależy od nadawcy. Własny szablon kontrolujesz Ty, a usługi zewnętrzne dobierają język na podstawie ustawień konta lub urządzenia, więc parsuj cyfry.

Czy baza danych powinna zachowywać wiodące 0 macedońskich numerów komórkowych?

Zapisuj raczej E.164: +389 i ośmiocyfrowy numer krajowy, bez prefiksu 0 i bez spacji.

Czy mogę zachować numer z Macedonii Północnej do powtarzanych logowań?

Nie w trybie samoobsługowym. Długoterminowe Numery dedykowane istnieją tylko dla USA i Kanady; w sprawie +389 napisz do wsparcia, a odpowiedź zależy od lokalnych przepisów.

Czy da się uruchomić CI dla Macedonii Północnej bez wydawania środków?

Poproś o sandbox na koncie deweloperskim. Symuluje numery i kody, więc cała integracja może przebiec od początku do końca bez opłat z portfela.

Dlaczego usługa może odrzucić mój numer +389?

Niektóre platformy nie przyjmują numerów wirtualnych. Aktywacja wygasa wtedy albo można ją anulować, a opłata automatycznie wraca do portfela.

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.