Odbieranie kodów weryfikacji telefonu Gojek przez API

Jak Gojek wykorzystuje Twój numer telefonu?

Gojek zaczął w Indonezji jako usługa przejazdów motocyklowych, a wyrósł na super-aplikację obejmującą przejazdy, dostawę jedzenia, wysyłkę paczek i płatności; należy dziś do tej samej grupy co Tokopedia. Numer telefonu jest centrum konta Gojek: to identyfikator logowania, jednorazowy kod potwierdza go przy rejestracji, a kolejny kod jest wymagany, gdy ktoś loguje się na nowym urządzeniu lub zmienia numer.

Dlatego każdy, kto integruje się z Gojek lub obsługuje jego użytkowników, potrzebuje numeru telefonu Gojek do testów. Jeśli aplikacja daje wybór kanału dostarczenia, wybierz SMS, bo numer z OTP Gateway odbiera wiadomości tekstowe.

Typowe powody, dla których zespół prosi o weryfikację SMS Gojek do testów:

• Integracja partnerska, na przykład z merchantem lub programem lojalnościowym, która potrzebuje świeżego loginu Gojek w przebiegu stagingowym.
• Pracownicy wsparcia odtwarzający problem z logowaniem klienta na czystym koncie, które kontrolują.
• Kontrole lokalizacji potwierdzające, jak wyglądają ekran kodu i licznik ponownego wysłania po indonezyjsku i angielsku.

Dlaczego kraj numeru testowego Gojek ma znaczenie?

Usługa gojek jest wymieniona w 197 krajach w OTP Route, ale właściwy zależy od tego, co sprawdzasz. Większość prawdziwych kont Gojek jest indonezyjska, więc naturalnym domyślnym wyborem jest Indonezja (+62); indonezyjskie komórki zapisuje się lokalnie jako 08…, a w formacie E.164 po odrzuceniu zera wiodącego przyjmują postać +62 8…. SMS-y weryfikacyjne na kontach indonezyjskich zwykle przychodzą po indonezyjsku.

Inne trasy to Singapur, Malezja, Wietnam, Filipiny, Tajlandia, Indie, Australia, Japonia, Wielka Brytania, Stany Zjednoczone i Brazylia. Numer spoza Azji Południowo-Wschodniej przydaje się, gdy chcesz zobaczyć, jak rejestracja zachowuje się dla podróżnika lub w nieobsługiwanym regionie. Jak wybierać, wyjaśnia artykuł o routingu krajowym.

Jak wygląda przepływ API dla usługi gojek?

Wysyłaj żądania na https://otproute.com/api/v1 z kluczem Bearer zaczynającym się od or_live_.

1. Odczytaj GET /api/v1/prices?country=id&service=gojek, by poznać aktualną cenę i dostępność na trasie indonezyjskiej.
2. Utwórz zamówienie: POST /api/v1/activations z treścią {"service": "gojek", "country": "id"}. Zachowaj identyfikator aktywacji.
3. Wpisz zwrócony numer w aplikacji Gojek i poproś o kod.
4. Odbierz kod ze zdarzenia activation.sms_received na webhooku albo odpytuj GET /api/v1/activations/{id}.
5. Wywołaj POST /api/v1/activations/{id}/cancel, jeśli test zostaje porzucony.

W przypadku webhooków sprawdź nagłówek X-OTPRoute-Signature (t=<unix>,v1=<hex>), obliczając HMAC-SHA256 z <t>.<raw body> sekretem endpointu, i odrzucaj stare znaczniki czasu. Ponieważ dostarczenie może zostać ponowione, zadbaj o idempotentność obsługi: wiąż ją z identyfikatorem aktywacji i ignoruj powtórzenia. Odpytywanie jest w porządku przy pojedynczych przebiegach w limicie 300 żądań na minutę. Pełną dokumentację znajdziesz w docs.

Czy mogę odebrać OTP z Gojek w panelu?

Tak. Wybierz Gojek jako usługę, wskaż kraj, potwierdź wyświetlaną cenę i zamów. Wpisz numer w aplikacji, stuknij, by wysłać kod, i obserwuj kartę aktywacji; SMS pojawi się tam po nadejściu. Zamówienie pozostaje otwarte przez 20 minut, a jeśli nic nie przyjdzie albo anulujesz, pełna kwota wraca do portfela.

Dlaczego SMS z Gojek może nie dotrzeć?

Kilka przyczyn jest powszechnych:

• Gojek, jak wiele aplikacji, może odrzucać numery wirtualne albo prosić o dodatkowe kontrole; gdy kod nie dotrze, nie ponosisz opłaty.
• Aplikacja mogła wysłać kod innym kanałem niż SMS.
• Trasa może być zajęta; poczekaj do końca okna, a potem spróbuj później albo z innym krajem.
• Szybkie powtórne żądania mogą uruchomić własne blokady czasowe aplikacji, więc rozstaw próby zamiast działać w pętli.

Kiedy lepiej pasuje numer dedykowany?

Numer jednorazowy obsługuje jeden kod. Jeśli konto testowe lub operacyjne Gojek musi się dalej logować, lepiej może pasować numer dedykowany z długoterminowymi SMS-ami, ale są one oferowane tylko w Stanach Zjednoczonych i Kanadzie, od $1.95/miesiąc, i pomagają tylko tam, gdzie konto akceptuje numer amerykański lub kanadyjski. Porównaj obie opcje w artykule numery tymczasowe a dedykowane.

Jak zachować odpowiedzialność w testach Gojek?

Przestrzegaj regulaminu Gojek. Trzymaj się jednego konta na jedną prawdziwą osobę lub firmę, używaj numerów wyłącznie do testowania przepływów własnego produktu lub obsługi własnych legalnych kont, a nigdy do zakładania dodatkowych kont czy odbierania promocji za rejestrację. OTP Route nie jest powiązany z Gojek, nazwa jest znakiem towarowym swojego właściciela, a do każdego zamówienia stosuje się Acceptable Use Policy OTP Route.

Najczęstsze pytania

Czy mogę odebrać OTP z Gojek bez indonezyjskiej karty SIM?

Tak. Zamów jednorazowy numer +62 dla usługi gojek w OTP Gateway i odczytaj kod w panelu lub przez API.

Jaki jest identyfikator usługi Gojek w API OTP Route?

To gojek; połącz go z identyfikatorem kraju, takim jak id dla Indonezji.

Czy numer wirtualny dla Gojek jest akceptowany za każdym razem?

Nie. Gojek może odrzucać niektóre numery wirtualne, dlatego aktywacja bez kodu jest zwracana automatycznie.

Jak długo aktywacja Gojek pozostaje otwarta?

Dwadzieścia minut. Jeśli w tym czasie nie dotrze SMS albo anulujesz, opłata wraca do portfela.

Czy mogę użyć tego samego numeru do późniejszego logowania w Gojek?

Nie z OTP Gateway, który obejmuje jeden kod na numer. Do powtarzanych logowań rozważ amerykański lub kanadyjski numer dedykowany, jeśli konto na to pozwala.

Jak uniknąć podwójnego przetwarzania webhooków z kodami Gojek?

Zweryfikuj podpis, a potem zapisz identyfikator aktywacji i ignoruj każde zdarzenie, które już obsłużyłeś.

Czy mogę testować bez wydawania pieniędzy?

Tak, na prośbę konto deweloperskie można przenieść do sandboxa, który zwraca symulowane numery i kody.

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.