Testy rejestracji +226: lista kontrolna numeru weryfikacyjnego z Burkina Faso

Co powinno być gotowe, zanim zamówisz numer +226?

Większość nieudanych pierwszych prób wynika z braku przygotowania, a nie z samej trasy. Odhacz te punkty przed pierwszym zamówieniem:

• Klucz API. Utwórz go w konsoli deweloperskiej; klucze produkcyjne mają prefiks or_live_ i są przesyłane jako token Bearer. Możesz mieć do 10 kluczy, więc daj osobne środowisku staging i CI.
• Zasilony portfel. Doładuj go kartą lub stablecoinami USDT/USDC. Za kod, który nie dotrze, nic nie jest pobierane.
• Właściwe identyfikatory. Burkina Faso to w API bf. Identyfikator usługi sprawdź przez GET /api/v1/services, zamiast go zgadywać.
• Plan odbioru kodu. Albo endpoint webhooka z bezpiecznie przechowywanym sekretem, albo pętla odpytywania z rozsądnymi odstępami. Konto może zarejestrować do 5 endpointów webhooków, co przydaje się do rozdzielenia stagingu i produkcji.
• Legalne konto do weryfikacji. Użytkownik testowy w Twoim produkcie albo firmowe konto prowadzone przez zespół. Obowiązują warunki każdej usługi oraz Regulamin dopuszczalnego użycia OTP Route.

Dokumentacja API opisuje każde pole, jeśli chcesz ją przeczytać przed napisaniem kodu.

Które aplikacje mogą dostarczać kody na trasę z Burkina Faso?

Aktualny katalog dla bf obejmuje ponad 900 usług. Wśród popularnych, dostępnych w momencie pisania, są WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, imo, Viber, Signal, LinkedIn, Uber, Amazon i ChatGPT (OpenAI).

Dostępność zmienia się w ciągu dnia, bo nasi partnerzy operatorscy dodają i wycofują pulę numerów, więc potraktuj tę listę jako migawkę. Twój kod powinien tuż przed każdym zamówieniem zapytać GET /api/v1/prices; odpowiada on aktualną ceną i informacją, czy dana para w ogóle da się zamówić.

Jak wygląda sekwencja wywołań API dla kraju `bf`?

1. Odczytaj cenę dla swojej pary przez GET /api/v1/prices?country=bf&service=whatsapp (podstaw własny identyfikator usługi).
2. Utwórz aktywację przez POST /api/v1/activations z treścią {"service": "whatsapp", "country": "bf"}. Zapisz zwrócony identyfikator aktywacji; wszystko dalej jest przypisane do niego.
3. Wywołaj wysyłkę SMS z testowanej aplikacji, używając numeru +226 z odpowiedzi.
4. Czekaj na activation.sms_received na swoim webhooku. Sprawdź 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 wynik i odrzucaj żądania z nieaktualnym znacznikiem czasu. Przypadki brzegowe omawia poradnik zabezpieczanie webhooków OTP przez HMAC.
5. Nie masz webhooka? Odpytuj GET /api/v1/activations/{id} co kilka sekund.
6. Skończyłeś wcześniej albo testujesz ścieżkę błędu? Wywołaj POST /api/v1/activations/{id}/cancel. Zobaczysz też activation.expired lub activation.cancelled, gdy przebieg kończy się bez kodu.

Konto pozwala na 300 żądań na minutę, co w zupełności wystarcza do odpytywania, o ile każdy przebieg robi niewielkie przerwy.

Czy osoba, która nie programuje, może zamówić kod +226?

Tak. Pracownicy wsparcia, marketerzy i opiekunowie kont mogą zrobić to samo ręcznie. Zaloguj się, otwórz OTP Gateway, wybierz Burkina Faso, wskaż usługę i potwierdź cenę widoczną na ekranie. Numer pojawia się od razu; wklej go do aplikacji, poproś o SMS, a kod trafi do tego samego wiersza w panelu. Możesz zostawić kartę otwartą albo wrócić później, bo aktywacja nasłuchuje przez pełne 20 minut.

Jak przechowywać numery +226 i w jakim języku przyjdzie SMS?

Burkina Faso używa ośmiocyfrowych numerów krajowych i nie ma prefiksu międzymiastowego, więc nie trzeba usuwać żadnego wiodącego zera: forma krajowa to te same cyfry, które następują po +226. Zapisuj numery w E.164 jako +226 i osiem cyfr, a wpisane dane normalizuj, usuwając spacje, myślniki i międzynarodowe 00 przed zapisem. Reguły walidacji skopiowane z rynków z zerem wiodącym odrzucą poprawne numery +226, co jest klasycznym błędem lokalizacyjnym wartym testu regresyjnego.

Francuski od dawna jest językiem administracji, szkolnictwa i biznesu, a powszechnie mówi się też językami mossi, diula i fulfulde. Większość szablonów weryfikacyjnych przychodzi po francusku lub angielsku, zależnie od ustawień konta, więc upewnij się, że parser radzi sobie ze znakami diakrytycznymi wokół cyfr.

Zespoły testują tu zwykle przy wejściu na frankofoński rynek Afryki Zachodniej, sprawdzając francuskie teksty na ekranie rejestracji albo wdrażając klientów produktów płatniczych i mobile money; ten wzorzec opisuje strona onboarding fintech.

Co zrobić, gdy kod nie dociera na numer?

• Poczekaj do końca okna. Niektóre usługi wysyłają z opóźnieniem; anulowanie w trzeciej minucie wyrzuca przebieg, który mógłby się jeszcze udać.
• Sprawdź, czy usługa akceptuje numery wirtualne. Niektóre platformy odrzucają je całkowicie. Właśnie dlatego niewykorzystane aktywacje są zwracane.
• Spróbuj innej trasy albo ponów później. Inny moment lub sąsiednia trasa w Afryce Zachodniej często zachowuje się inaczej.
• Nie zamawiaj ponownie w ciasnej pętli. Szybkie powtórki zwykle uruchamiają limity po stronie aplikacji wysyłającej i pogarszają kolejną próbę.

Poradnik o ograniczaniu nieudanych dostaw OTP szerzej omawia projektowanie ponowień.

Czy istnieje długoterminowy numer z Burkina Faso i jak działa rozliczanie?

Nie ma samoobsługowego, długoterminowego numeru +226. Numery dedykowane to produkt dostępny w Stanach Zjednoczonych i Kanadzie, od $1.95/month, z przychodzącymi i wychodzącymi SMS-ami oraz połączeniami w przeglądarce. Jeśli potrzebujesz stałego numeru z Burkina Faso, napisz na [email protected]; to, czy da się go uzyskać, zależy od lokalnych przepisów i nie jest obiecane.

Płatność za aktywacje +226 pobierana jest z jednego przedpłaconego portfela w USD, bez abonamentu i bez wybierania pakietu. Doładowania kartą lub USDT/USDC dostają faktury PDF e-mailem. Do prac integracyjnych poproś o przełączenie konta deweloperskiego na sandbox, który zwraca symulowane numery i kody, dzięki czemu Twój zestaw testów nigdy nie dotyka prawdziwych środków. Aktualne stawki znajdziesz na stronie cennika.

Najczęstsze pytania

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

Tak. Zamów numer +226 w OTP Gateway, wywołaj SMS z aplikacji i odczytaj kod w panelu lub przez API. Płacisz tylko wtedy, gdy kod dotrze.

Jaki jest identyfikator kraju dla Burkina Faso w API OTP Route?

To bf. Połącz go z identyfikatorem usługi z GET /api/v1/services, wywołując endpointy cen lub aktywacji.

Czy numery +226 zaczynają się od zera?

Nie. Burkina Faso nie ma prefiksu międzymiastowego, więc numer to po prostu +226 i osiem cyfr w formacie E.164.

Jak długo numer weryfikacyjny z Burkina Faso pozostaje aktywny?

Dwadzieścia minut na aktywację. Jeśli okno zamknie się bez SMS-a albo anulujesz zamówienie, pełna kwota wraca automatycznie na portfel.

Czy kod przyjdzie po francusku?

To zależy od usługi wysyłającej i języka ustawionego na koncie. Zwykle jest to francuski lub angielski, więc przetestuj oba, jeśli Twój produkt je obsługuje.

Czy mogę użyć numeru +226 do założenia wielu kont na jednej platformie?

Nie. OTP Route służy do testowania własnego produktu i obsługi legalnych kont firmowych. Masowe rejestracje lub zmyślone tożsamości łamią Regulamin dopuszczalnego użycia i warunki samej platformy.

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.