Testowanie rejestracji w Mali, gdy nikt w zespole nie ma karty SIM +223

Produkt startuje w Mali, ale nikt nie ma lokalnej karty SIM. Co teraz?

To znany kłopot lidera QA. Dział produktu chce zweryfikować malijską ścieżkę rejestracji przed kampanią marketingową w Bamako, pole telefonu już przyjmuje +223, a w telefonie każdego inżyniera tkwi karta europejska lub północnoamerykańska. Pożyczanie prywatnego numeru kolegi jest zawodne, nie skaluje się na zestaw testów i przenosi dane pracowników na konta testowe.

Numer weryfikacyjny z Mali z OTP Gateway rozwiązuje ten wąski problem: jeden prawdziwy numer +223, użyty do jednego kodu, a potem wyrzucony. Możesz sterować nim ze skryptu albo zamawiać ręcznie w panelu, a strony testów QA i CI/CD opisują, jak zespoły wplatają go w przebiegi regresji.

Z jakich aplikacji numer weryfikacyjny z Mali może odbierać kody?

Bieżące zestawienie dla Mali obejmuje WhatsApp, Facebook, Telegram, TikTok, Google (Gmail & YouTube), Instagram, Snapchat, imo, Viber, Signal, Microsoft & Outlook, ChatGPT (OpenAI) i LinkedIn. We wszystkich usługach bramki dla Mali dostępnych jest ponad 1 600.

Dostępność nie jest stała. Trasy otwierają się i zamykają w ciągu dnia, więc skrypt powinien potwierdzać w czasie działania, że usługę można kupić, zamiast zakładać, że wczorajszy wynik nadal obowiązuje.

Jak wygląda przepływ API OTP dla Mali w kodzie?

Żądania trafiają na https://otproute.com/api/v1 z kluczem Bearer zaczynającym się od or_live_. Klucze tworzy się w konsoli deweloperskiej, do 10 na konto.

1. Pobierz identyfikatory raz z GET /api/v1/services i GET /api/v1/countries. Mali to ml.
2. Odczytaj aktualną cenę przez GET /api/v1/prices?country=ml&service=<id>.
3. Złóż zamówienie przez POST /api/v1/activations, na przykład {"service": "whatsapp", "country": "ml"}, i zachowaj identyfikator aktywacji.
4. Wpisz zwrócony numer +223 w formularzu weryfikacji w aplikacji.
5. Odbierz kod z GET /api/v1/activations/{id} albo pozwól, by poinformował Cię webhook. Niewykorzystane numery zwalniaj przez POST /api/v1/activations/{id}/cancel.

W przypadku webhooków zasubskrybuj endpoint (dozwolonych jest pięć) na activation.sms_received, activation.expired i activation.cancelled. Sprawdź X-OTPRoute-Signature, obliczając HMAC-SHA256 z "<t>.<raw body>" przy użyciu sekretu endpointu, odrzucaj nieaktualne znaczniki czasu i zadbaj, by handler był idempotentny względem identyfikatora aktywacji. Limit konta to 300 żądań na minutę, a przewodnik integracji API zawiera działające przykłady.

Osiem cyfr, bez prefiksu wyjściowego: przechowywanie numerów malijskich

Mali stosuje zamknięty plan ośmiocyfrowy bez prefiksu wyjściowego, więc numer wybierany w kraju to te same osiem cyfr, które następują po +223 za granicą. Normalizacja jest dzięki temu wyjątkowo prosta: postać E.164 to +223 i osiem cyfr, bez wiodącego zera do dodania lub usunięcia. Mimo to jawnie waliduj długość, bo ogólna reguła napisana dla rynku z dziesięciocyfrowymi numerami odrzuci poprawne malijskie dane.

Zwykłym językiem wiadomości weryfikacyjnych z międzynarodowych aplikacji jest francuski, podczas gdy w codziennym życiu najczęściej mówi się w bambara. Kody przychodzą więc zazwyczaj w szablonach francuskich lub angielskich; wyciągaj je wzorcem liczbowym, a nie dopasowując frazy.

Po co w ogóle testować tutaj? Zespoły uruchamiające produkty zbliżone do mobile money w Afryce Zachodniej, organizacje pozarządowe i operatorzy logistyczni prowadzący konta pracowników terenowych z Bamako oraz aplikacje obsługujące liczną diasporę malijską we Francji i krajach sąsiednich potrzebują, by ścieżka +223 działała. Połącz to z kontrolami tras takich jak Senegal, gdy wdrożenie jest regionalne.

Co robić, gdy kod +223 milczy

Brak SMS-a zwykle oznacza problem z trasą lub usługą, a nie z Twoją integracją. Zanim zgłosisz błąd:

• Poczekaj pełne 20 minut; niektórzy nadawcy wypuszczają wiadomości partiami.
• Sprawdź, czy usługa odrzuca numery wirtualne. Niektóre tak robią, a wtedy chroni Cię automatyczny zwrot.
• Wróć później albo spróbuj innej trasy usługi zamiast ponawiać zamówienia w ciasnej pętli.
• Anuluj porzucone aktywacje, aby saldo zostało przywrócone od razu.

Jeśli po zamknięciu okna nic nie dotarło albo wcześniej anulujesz zamówienie, cała kwota wraca do Twojego portfela.

Czy mój zespół może zachować malijski numer na dłużej?

OTP Route nie oferuje samoobsługowego długoterminowego numeru malijskiego. Dla ml dostępny jest wyłącznie jednorazowy OTP Gateway.

Numery dedykowane (Dedicated Virtual Numbers) OTP Route, które odnawiają się z portfela i obsługują przychodzące i wychodzące SMS-y oraz połączenia z przeglądarki, istnieją tylko w Stanach Zjednoczonych i Kanadzie, od $1.95/miesiąc. Jeśli stała linia +223 jest ważna dla Twojej działalności, napisz na [email protected]; wszystko ponad bramkę zależy od lokalnych przepisów i nie jest gwarantowane.

Płatności za routing OTP dla Mali i testowanie bez wydatków

Jeden przedpłacony portfel w USD finansuje każdy kraj: płatność za użycie, bez miesięcznej opłaty i wyboru planu. Doładuj go kartą albo w USDT/USDC, a do każdego doładowania dostaniesz e-mailem fakturę PDF.

Gdy jeszcze budujesz rozwiązanie, poproś wsparcie o przełączenie konta deweloperskiego w tryb sandbox. Otrzymasz wtedy symulowane numery i kody i przećwiczysz całą sekwencję API weryfikacji SMS bez wydatków z portfela. Prawdziwych numerów używaj tylko do własnych produktów i legalnych kont, przestrzegając regulaminów usług oraz Acceptable Use Policy. Aktualne stawki znajdziesz na stronie cennika.

Najczęstsze pytania

Czy mogę zweryfikować rejestrację w Mali bez podróży i kupowania lokalnej karty SIM?

Tak. Zamów numer +223 do testów w OTP Gateway, wpisz go w aplikacji i odczytaj kod w panelu lub przez API.

Jaki jest identyfikator Mali w API OTP Route?

Mali to ml, wartość, którą podajesz zarówno w zapytaniu o ceny, jak i w treści żądania aktywacji.

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

Nie. Mali nie ma prefiksu wyjściowego; poprawny numer to +223 i osiem cyfr.

Ile kosztuje SMS OTP z Mali?

Malijskie kody zaczynają się od $0.20 za kod, a stawkę dla każdej aplikacji API podaje na żywo przed zakupem.

Czy stracę pieniądze, jeśli aplikacja nie wyśle kodu?

Nie. Aktywacja bez SMS-a do końca 20-minutowego okna, albo taka, którą anulujesz, jest w całości zwracana do portfela.

Czy może z tego korzystać ktoś bez umiejętności programowania?

Tak. W panelu wybierz Mali i usługę, zamów numer, wklej go do aplikacji, a kod pojawi się na ekranie aktywacji.

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.