Testowanie weryfikacji telefonu w Burundi bez lokalnej karty SIM

Dlaczego sprawdzenie rejestracji +257 z zagranicy jest tak trudne?

Wyobraź sobie zespół produktowy, który dodaje Burundi do wdrożenia we Wschodniej Afryce. Ekran rejestracji prosi o numer telefonu, backend wysyła jednorazowy kod, a nikt w zespole nie ma burundyjskiej karty SIM. Karty roamingowe kupione w podróży wygasają, a proszenie kolegi w Bużumburze o odczytywanie kodów na głos ujawnia jego prywatny numer i nie da się tego uruchomić w nocnym zestawie testów.

Routing OTP usuwa to wąskie gardło. Zamiast fizycznego telefonu zamawiasz numer weryfikacyjny z Burundi dla jednej konkretnej usługi, kod przechwytuje OTP Route, a Twój harness testowy odczytuje go jak każde inne zdarzenie. To samo podejście sprawdza się u zespołów operacyjnych, które prowadzą profile firmowe na trasach burundyjskich i chcą trzymać własne telefony z dala od sprawy.

Które usługi mogą dziś weryfikować się numerem z Burundi?

Aktualna migawka dla Burundi obejmuje znane aplikacje do wiadomości, wyszukiwania i handlu, między innymi WhatsApp, Viber, imo, Telegram, Signal, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, ChatGPT (OpenAI), Uber i Amazon. Łącznie trasa obsługuje ponad 1000 usług.

Pula zmienia się w ciągu dnia, więc traktuj tę listę jako punkt wyjścia, a nie obietnicę. Twój kod powinien odpytywać GET /api/v1/services i GET /api/v1/countries, aby poznać aktualny stan, a pełny katalog można przeglądać w sekcji kraje.

Jak API OTP dla Burundi wpisuje się w przebieg testu?

Utwórz klucz w konsoli deweloperskiej; klucze produkcyjne zaczynają się od or_live_ i trafiają do nagłówka Bearer w żądaniach do https://otproute.com/api/v1. Typowy test automatyczny wygląda wtedy tak:

1. Wywołaj GET /api/v1/prices?country=bi&service=whatsapp, aby odczytać aktualną cenę tej pary.
2. Wyślij POST /api/v1/activations z treścią {"service": "whatsapp", "country": "bi"}. Odpowiedź zawiera identyfikator aktywacji i numer +257 do wpisania w testowanej aplikacji.
3. Poczekaj na webhook activation.sms_received albo odpytuj GET /api/v1/activations/{id} w rozsądnych odstępach.
4. Sprawdź asercją kod i zakończ test.

Żądania webhooków zawierają X-OTPRoute-Signature: t=<unix>,v1=<hex>, czyli HMAC-SHA256 z <t>.<raw body> z kluczem sekretu endpointu. Przelicz go ponownie, porównaj w stałym czasie i odrzucaj nieaktualne znaczniki czasu; szczegóły omawia ten poradnik. Konto może mieć do 10 kluczy i 5 endpointów webhooków, przy limicie 300 żądań na minutę. Pełna dokumentacja: docs.

Czego powinien oczekiwać mój walidator od numeru z Burundi?

Burundi ma zamknięty plan numeracyjny: numery abonenckie mają osiem cyfr po kodzie kraju i nie ma krajowego prefiksu międzymiastowego do usunięcia. W E.164 oznacza to +257 i osiem cyfr, zapisane bez spacji. Formularze często wyświetlają numer w grupach po dwie cyfry, więc znormalizuj dane wejściowe, usuwając spacje, myślniki i wiodące 00 przed zapisem.

Częsty błąd to walidator napisany pod dziewięcio- lub dziesięciocyfrowe numery krajowe, który po cichu odrzuca poprawne wpisy +257. Dodaj do testów jednostkowych fixture o takiej długości.

Językami urzędowymi są kirundi, francuski i angielski, a w handlu powszechnie używa się suahili. Teksty weryfikacyjne z globalnych aplikacji zwykle przychodzą po angielsku lub francusku, zależnie od logiki lokalizacji nadawcy, więc analizuj cyfry, a nie treść komunikatu.

Kod nie dotarł: co teraz?

Każda aktywacja pozostaje otwarta przez 20 minut. Jeśli w tym czasie żaden SMS nie dotrze na numer albo anulujesz przez POST /api/v1/activations/{id}/cancel, pełna kwota automatycznie wraca na portfel.

• Pozwól oknu dobiec końca, zanim uznasz próbę za nieudaną; niektórzy nadawcy kolejkują wiadomości.
• Sprawdź, czy docelowa usługa w ogóle akceptuje numery wirtualne, bo niektóre odrzucają je z zasady.
• Spróbuj później albo przetestuj ten sam przepływ przez inną trasę usługi.
• Unikaj ponownego zamawiania w ciasnej pętli; rób przerwy między próbami.

Wolisz panel? Zaloguj się, wybierz Burundi i usługę, skopiuj numer do aplikacji i obserwuj kod na ekranie. Więcej taktyk znajdziesz w poradniku ograniczanie nieudanych dostaw OTP.

Czy możemy zachować burundyjski numer do kont, na które logujemy się wielokrotnie?

Nie jako produkt samoobsługowy. OTP Route nie sprzedaje długoterminowych numerów z Burundi; OTP Gateway wydaje jeden numer na jedną weryfikację. Jeśli Twój zespół naprawdę potrzebuje tam stałej linii, napisz na [email protected] i opisz przypadek użycia; dostępność zależy od lokalnych przepisów i nie jest gwarantowana.

Numery dedykowane istnieją tylko w Stanach Zjednoczonych i Kanadzie, od $1.95/month, z odbiorem SMS-ów, przekazywaniem na webhook i połączeniami w przeglądarce. Zobacz numery wirtualne, jeśli amerykańska lub kanadyjska linia pasuje do Twoich kont stagingowych.

Jak rozliczane jest korzystanie z numerów z Burundi?

Jest jeden przedpłacony portfel w USD, bez opłaty miesięcznej i bez wybierania pakietu. Doładowanie działa kartą lub stablecoinami USDT/USDC; dział finansów dostaje e-mailem fakturę PDF za każde doładowanie. Zanim podłączysz płatności do CI, poproś o przełączenie konta deweloperskiego na sandbox, który zwraca symulowane numery i kody bez ruszania środków z portfela.

Używaj każdego numeru wyłącznie do własnego produktu lub legalnych kont firmowych, przestrzegaj warunków każdej usługi i pamiętaj, że obowiązuje Regulamin dopuszczalnego użycia OTP Route. Aktualne stawki znajdziesz w cenniku.

Najczęstsze pytania

Czy mogę przetestować rejestrację w mojej aplikacji z Burundi bez lokalnej karty SIM?

Tak. Zamów numer +257 w OTP Gateway dla swojej usługi, wpisz go w aplikacji i odczytaj kod w panelu, przez API lub webhook.

Jakiego identyfikatora kraju używa API dla Burundi?

Przekaż bi jako wartość kraju, na przykład w POST /api/v1/activations razem z identyfikatorem usługi takim jak telegram.

Czy zostanę obciążony, jeśli kod +257 nie dotrze?

Nie. Jeśli w 20-minutowym oknie nic nie dotrze albo anulujesz zamówienie, pełna kwota wraca automatycznie na portfel.

Czy numery z Burundi mają wiodące zero, które trzeba usunąć?

Nie. Burundi nie ma prefiksu międzymiastowego, więc forma E.164 to po prostu +257 i osiem cyfr.

W jakim języku będzie SMS weryfikacyjny z Burundi?

To zależy od usługi nadawczej, ale typowy jest angielski lub francuski. Wyodrębniaj kod liczbowy, zamiast polegać na treści wiadomości.

Czy mogę użyć tego samego numeru z Burundi w przyszłym miesiącu?

Nie. Numery z Gateway służą do jednej weryfikacji. Do powtarzanych logowań numer dedykowany jest dostępny tylko w USA i Kanadzie.

Ile kosztuje numer weryfikacyjny z Burundi?

Ceny dla Burundi zaczynają się od $0.20 za kod i są ustalane dla każdej usługi. Dokładną kwotę zwraca GET /api/v1/prices i widać ją przed zamówieniem.

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.