Testowanie ugandyjskiej weryfikacji telefonu na prawdziwych trasach +256

Co sprawia, że Uganda zasługuje na osobną rundę testów?

Uganda to rynek zorientowany na telefon komórkowy, gdzie numer telefonu często pełni też rolę tożsamości finansowej: pieniądze mobilne są częścią codzienności, więc portfele, aplikacje pożyczkowe, platformy agrotechniczne i marketplace'y mocno opierają się na weryfikacji SMS. Dla zespołu produktowego oznacza to, że krok z telefonem w onboardingu nie jest tu formalnością. To główne wejście.

Liczy się też kontekst regionalny. Produkty rozwijające się w Afryce Wschodniej często startują w Kenii, Tanzanii i Rwandzie razem z Ugandą, a każdy kraj ma własne formaty numerów i dostępność usług. Testowanie każdego z osobna, na prawdziwych trasach, wychwytuje problemy, które umykają przy teście jednego kraju. O tym, jak zespoły organizują taką pracę, piszemy w materiale o onboardingu fintech.

Jak zapisuje się i normalizuje ugandyjskie numery telefonów?

W Ugandzie obowiązuje prefiks krajowy 0. Numery komórkowe zapisuje się lokalnie zwykle jako 07 i osiem cyfr; w formie międzynarodowej zero znika, zostaje +2567 i osiem kolejnych cyfr, czyli dziewięć cyfr po kodzie kraju.

• Przyjmuj lokalne dane z początkowym 0 i zamieniaj je na E.164 przed zapisem.
• Uważaj na użytkowników, którzy wpisują zarówno kod kraju, jak i 0 (+2560…); usuń 0 zamiast odrzucać wpis.
• Trzymaj jedną kanoniczną kolumnę, aby wykrywanie duplikatów i wyszukiwanie przy logowaniu działały poprawnie.

Angielski jest głównym językiem biznesu i oficjalnych komunikatów, swahili także jest językiem urzędowym, a powszechnie używa się luganda. Szablony weryfikacyjne międzynarodowych usług zwykle przychodzą po angielsku, więc kontrola lokalizacji skupia się tu bardziej na maskach numerów, wyborze kraju i tonie tekstów niż na kodowaniu znaków.

Które usługi można zweryfikować na numerze +256?

Uganda ma jeden z szerszych katalogów: ponad 1600 usług ma obecnie aktywne trasy. Popularne wybory to WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Uber, Amazon, LinkedIn, Snapchat, Discord i ChatGPT (OpenAI). Lista to bieżący zrzut. Użyj endpointu cen, aby sprawdzić trasę w chwili, gdy jej potrzebujesz.

Jak wygląda zamówienie przez API OTP dla Ugandy od początku do końca?

Wysyłaj żądania do https://otproute.com/api/v1 z kluczem API Bearer zaczynającym się od or_live_. Identyfikator kraju dla Ugandy to ug.

1. Sprawdź cenę i dostępność: GET /api/v1/prices?country=ug&service=<id>.
2. Utwórz aktywację: POST /api/v1/activations z {"service": "whatsapp", "country": "ug"}.
3. Wpisz zwrócony numer w testowanej aplikacji i zażądaj kodu.
4. Odbierz go z webhooka activation.sms_received albo odpytuj GET /api/v1/activations/{id}.
5. Przebieg porzucony? POST /api/v1/activations/{id}/cancel natychmiast zwraca środki.

Nagłówek X-OTPRoute-Signature (t=<unix>,v1=<hex>) to HMAC-SHA256 z sygnatury czasowej, kropki i surowej treści, z kluczem w postaci sekretu endpointu. Zweryfikuj go, odrzucaj nieaktualne sygnatury czasowe i spraw, by handler był idempotentny względem identyfikatora aktywacji. Przy zestawach testów dla Ugandy uwzględnij limity konta: 10 kluczy, 5 endpointów webhooków, 300 żądań na minutę. Pełna dokumentacja: dokumentacja dla deweloperów.

Wolisz klikać? W panelu wybierz Ugandę i usługę, potwierdź aktualną cenę, a kod pojawi się przy zamówieniu, gdy tylko nadejdzie.

Co zrobić, gdy ugandyjski kod się spóźnia?

Odczekaj 20-minutowe okno. Płacisz tylko wtedy, gdy kod nadejdzie; po wygaśnięciu lub anulowaniu cała kwota wraca do portfela bez żadnej prośby z Twojej strony.

Jeśli kody wciąż nie docierają, sprawdź, czy usługa akceptuje numery wirtualne w testowanym kroku, spróbuj później albo inną trasą usługi i dodaj przerwę między próbami w testach automatycznych. Ponowne zamawianie w ciasnej pętli traci czas i może uruchomić limity samej usługi.

Czy zamiast tego potrzebuję długoterminowej linii ugandyjskiej?

Tylko jeśli to samo konto musi wielokrotnie odbierać kody. OTP Route sprzedaje Numery dedykowane od ręki w Stanach Zjednoczonych i Kanadzie, od $1.95/month, z przychodzącymi i wychodzącymi SMS-ami, przekazywaniem na webhook i połączeniami z przeglądarki. Uganda nie wchodzi w skład tego produktu samoobsługowego. Zespoły potrzebujące stałej linii +256 mogą napisać na [email protected]; możliwość zależy od lokalnych przepisów i nie jest gwarantowana. Porównanie obu produktów w projektach ugandyjskich znajdziesz w tekście o numerach tymczasowych i dedykowanych.

Jak portfel i sandbox pasują do projektu dla Ugandy?

Jeden przedpłacony portfel w USD obejmuje wszystko, w modelu pay as you go, bez opłaty miesięcznej i bez planu. Doładuj go kartą lub USDT/USDC i otrzymuj fakturę PDF e-mailem za każde zasilenie i zakup. W trakcie integracji konto deweloperskie można na prośbę przełączyć na sandbox, który zwraca symulowane numery i kody, dzięki czemu sprawdzisz logikę routingu OTP przed prawdziwymi zamówieniami. Używaj tras wyłącznie do własnych, legalnych produktów i kont, zgodnie z regulaminami usług i Zasadami dopuszczalnego użytkowania OTP Route.

Najczęstsze pytania

Czy mogę zweryfikować ugandyjski proces rejestracji spoza Ugandy?

Tak. Zamów numer +256 w OTP Gateway, zażądaj kodu z aplikacji lub usługi i odczytaj go w panelu albo przez webhook.

Jak zamienić numery zaczynające się od 07 na format międzynarodowy?

Usuń początkowe 0 i dodaj +256, więc lokalny numer komórkowy przyjmuje postać +2567 i osiem cyfr.

Jakiego identyfikatora kraju używa API dla Ugandy?

Użyj ug, na przykład w GET /api/v1/prices?country=ug&service=<id>.

Czy ugandyjskie SMS-y weryfikacyjne przychodzą po angielsku?

Zwykle tak, ponieważ angielski jest powszechny w komunikacji biznesowej, ale język zależy od usługi i ustawień konta.

Czy pobierana jest opłata, gdy kod z Ugandy nie przyjdzie?

Nie. Jeśli w ciągu 20 minut nic nie nadejdzie albo anulujesz zamówienie, cała kwota automatycznie wraca do portfela.

Czy mogę testować rynki Afryki Wschodniej razem?

Tak. Te same wywołania API działają dla Kenii, Tanzanii i Rwandy; zmienia się tylko identyfikator kraju, a dostępność jest sprawdzana na żywo dla każdej trasy.

Czy OTP Route nadaje się do masowych rejestracji na numerach ugandyjskich?

Nie. Służy do testowania i prowadzenia własnych, legalnych kont, a obowiązują regulaminy usług oraz Zasady dopuszczalnego użytkowania OTP Route.

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.