Odbieranie OTP Zalo na numerach OTP Route przez API

Jak wygląda przepływ API kodu weryfikacyjnego Zalo?

Identyfikator usługi to zalo. Wywołania trafiają na https://otproute.com/api/v1 z kluczem Bearer z prefiksem or_live_, wydawanym w konsoli deweloperskiej.

1. Pobierz identyfikatory krajów z GET /api/v1/countries; Wietnam to na przykład vn.
2. Sprawdź aktualną cenę i dostępność przez GET /api/v1/prices?country=vn&service=zalo.
3. Utwórz aktywację: POST /api/v1/activations z {"service": "zalo", "country": "vn"}. Zapisz identyfikator aktywacji i zwrócony numer.
4. Wpisz numer na ekranie telefonu Zalo na kontrolowanym przez ciebie koncie testowym.
5. Odbierz kod przez webhook lub odpytywanie albo zakończ zamówienie przez POST /api/v1/activations/{id}/cancel.

Sprawdzenie salda przez GET /api/v1/balance na początku zestawu testów pozwala uniknąć niespodzianek w trakcie uruchomienia. Pełne kształty żądań znajdziesz w dokumentacji API.

Budowa odbiornika webhooków dla kodów Zalo

Zarejestruj endpoint w konsoli deweloperskiej i zasubskrybuj activation.sms_received, activation.expired i activation.cancelled. Każde żądanie ma nagłówek X-OTPRoute-Signature w formacie t=<unix>,v1=<hex>; oblicz HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, porównaj w stałym czasie i odrzucaj stare znaczniki czasu.

Zadbaj o idempotentność handlera, zapisując wyniki pod identyfikatorem aktywacji. Jeśli to samo zdarzenie zostanie dostarczone dwukrotnie, drugi zapis powinien nic nie zmieniać. Zespoły bez publicznego endpointu mogą zamiast tego odpytywać GET /api/v1/activations/{id}; limit 300 żądań na minutę zostawia miejsce na krótki interwał odpytywania w kilku równoległych testach.

Kiedy Zalo prosi o numer telefonu?

Zalo to wietnamski komunikator i aplikacja społecznościowa, w której numer telefonu jest głównym identyfikatorem konta. Kod jest zwykle wymagany przy zakładaniu konta, logowaniu na nowym urządzeniu i odzyskiwaniu dostępu. Dokładne komunikaty określa Zalo i mogą się one zmieniać, więc plan testów powinien obejmować każdy ekran, a nie zakładać jednej stałej sekwencji.

Dla zespołów QA ma to znaczenie, bo integracja komunikatora, mini aplikacja lub kanał obsługi klienta zbudowany wokół Zalo często wymaga świeżego, zweryfikowanego konta testowego, zanim da się uruchomić jakikolwiek inny scenariusz.

Z jakich krajów można odbierać OTP Zalo w OTP Route?

Trasy Zalo są dostępne w 198 krajach. Należą do nich Wietnam, Stany Zjednoczone, Japonia, Korea Południowa, Tajwan, Australia, Kanada, Kambodża, Laos, Tajlandia, Malezja, Singapur, Niemcy, Francja i Wielka Brytania.

Wybierz kraj odpowiadający testowanemu kontu. Start w Wietnamie wymaga numerów +84, aby odtworzyć to, co widzą lokalni użytkownicy, a zespół obsługujący wietnamską diasporę może potrzebować numerów z krajów, w których mieszkają ci klienci. Kraj wpływa też na cenę i dostępność, dlatego warto najpierw sprawdzić endpoint cen.

Kroki w panelu dla testu weryfikacji SMS Zalo

Nie każdy w projekcie pisze kod. W panelu wybierz Zalo jako usługę, wskaż kraj, potwierdź wyświetloną cenę i złóż zamówienie. Skopiuj numer do Zalo; kod pojawi się obok zamówienia, gdy SMS dotrze. Anulowanie z tego samego ekranu zwraca całą kwotę. Rejestracja w samym panelu wymaga adresu e-mail i 6-cyfrowego kodu e-mail albo logowania przez Google, a uwierzytelnianie dwuskładnikowe TOTP może chronić login zespołu.

Dlaczego kod Zalo może nie dotrzeć?

Dostarczenie zależy od usługi i trasy, więc nie ma stałego czasu oczekiwania. Zalo może też odrzucać niektóre numery wirtualne, i właśnie po to istnieje zwrot. Jeśli nic się nie pojawia:

• Zostaw zamówienie otwarte do końca okna 20 minut albo je anuluj; w obu przypadkach środki wracają do portfela.
• Spróbuj ponownie później albo przełącz się na inny kraj odpowiedni dla testu.
• Nie składaj zamówień w ciasnej pętli; w zadaniach automatycznych dodaj wycofanie (backoff).
• Sprawdź, czy samo konto testowe nie jest zablokowane lub ograniczone limitem po stronie Zalo.

Czy konto testowe Zalo powinno używać numeru dedykowanego?

Numer z OTP Gateway obsługuje jeden kod. Jeśli konto stagingowe lub wsparcia musi się zalogować ponownie za miesiąc, lepszy jest numer dedykowany: linia amerykańska lub kanadyjska od $1.95/month, którą zatrzymujesz na czas odnowień, z przychodzącymi SMS-ami w panelu i w webhooku number.sms_received. Więcej na stronie numerów wirtualnych.

Korzystaj z obu opcji odpowiedzialnie. Przestrzegaj regulaminu Zalo, utrzymuj jedno konto na rzeczywistą osobę lub firmę i używaj OTP Route wyłącznie do testowania i obsługi własnych, legalnych kont i produktów. Zalo jest znakiem towarowym swojego właściciela, a OTP Route nie jest z nim powiązany.

Najczęstsze pytania

Jakiego identyfikatora usługi używa API OTP Route dla Zalo?

To zalo, przesyłane w treści POST /api/v1/activations razem z identyfikatorem kraju.

Czy mogę odebrać OTP Zalo na numerze spoza Wietnamu?

Tak. Trasy Zalo są dostępne w 198 krajach, a dostępność każdej z nich zwraca na żywo endpoint cen.

Czy zapłacę, jeśli Zalo odrzuci numer wirtualny?

Nie. Jeśli kod nie dotrze na numer w ciągu 20 minut lub anulujesz zamówienie, cała kwota wraca do portfela.

Czy numer wirtualny dla Zalo nadaje się do konta, którego potrzebuję długoterminowo?

Numer jednorazowy nie. Przy cyklicznych logowaniach bezpieczniejszym wyborem jest numer dedykowany z USA lub Kanady, który zatrzymujesz na czas odnowień.

Jak zapłacić za weryfikację SMS Zalo do testów?

Zasil przedpłacony portfel w USD kartą lub USDT/USDC; nie ma opłaty miesięcznej, a każde zasilenie otrzymuje fakturę PDF.

Czy mogę wypróbować integrację Zalo bez wydawania pieniędzy?

Tak. Gdy zespół wsparcia przełączy konto deweloperskie w tryb sandbox, zamówienia Zalo zwracają symulowane numery i kody, więc kod webhooków i odpytywania można sprawdzić przed prawdziwymi wydatkami.

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.