Programowe odbieranie indonezyjskich kodów OTP +62

Jakie endpointy wywołuje integracja Indonesia OTP API?

Wszystko działa względem https://otproute.com/api/v1 z kluczem Bearer z prefiksem or_live_. Utwórz go w konsoli Developer; konto może mieć do 10 kluczy, co ułatwia oddzielenie runnera CI od maszyny stagingowej.

1. Pobierz GET /api/v1/services i GET /api/v1/countries i zapisz obie listy w pamięci podręcznej. Indonezja występuje pod id id.
2. Zapytaj GET /api/v1/prices?country=id&service=<id> o aktualną cenę i dostępność usługi, którą zamierzasz testować. Zasoby zmieniają się w ciągu dnia, więc odpytuj je w każdym przebiegu zamiast wpisywać na stałe.
3. Utwórz zamówienie przez POST /api/v1/activations z treścią taką jak {"service": "tokopedia", "country": "id"}. W odpowiedzi dostajesz id aktywacji i numer +62.
4. Wpisz lub wstrzyknij ten numer w pole telefonu własnej aplikacji lub konta testowego.
5. Odczytaj wynik przez webhook albo odpytując GET /api/v1/activations/{id}. Przerwij czysto przez POST /api/v1/activations/{id}/cancel, gdy test padnie przed krokiem SMS.

Szybkie GET /api/v1/balance przed startem zestawu pozwala przebiegowi paść wcześniej, a nie w połowie. Odpytywanie w rozsądnych odstępach spokojnie mieści się w limicie 300 żądań na minutę. Pełne schematy znajdziesz w dokumentacji API.

Jak przetwarzać kody +62 podpisanym webhookiem?

Odpytywanie wystarcza jednemu deweloperowi; równoległe zadania są spokojniejsze z dostarczaniem push. Zarejestruj do 5 endpointów na konto i zasubskrybuj activation.sms_received, activation.expired i activation.cancelled.

Każde żądanie zawiera nagłówek X-OTPRoute-Signature w formie t=<unix>,v1=<hex>. Zbuduj podpisywany ciąg jako <t>.<raw body>, oblicz HMAC-SHA256 z sekretem endpointu i porównaj z v1 w stałym czasie. Haszuj surowe bajty przed jakimkolwiek parsowaniem JSON i odrzucaj żądania ze zbyt starym znacznikiem czasu, aby przechwyconego ładunku nie dało się odtworzyć.

Traktuj zdarzenia jako kluczowane id aktywacji i zadbaj o idempotentność handlera: ponowione dostarczenie powinno po prostu zastać kod już zapisany. Nasz tekst o bezpieczeństwie webhooków HMAC przechodzi przez te kontrole.

Które usługi mogą odbierać indonezyjskie SMS-y OTP w OTP Route?

Migawka na żywo dla Indonezji obejmuje ponad 3000 usług. Do popularnych tras należą WhatsApp, Tokopedia, Shopee, Lazada, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LINE, Discord, Microsoft & Outlook i ChatGPT (OpenAI).

Dla współpracowników, którzy nigdy nie dotykają API, panel robi to samo: zaloguj się, wybierz usługę, wybierz Indonezję, sprawdź pokazaną cenę i zamów. Numer +62 pojawia się na ekranie, a kod jest wyświetlany obok, gdy tylko nadejdzie SMS. Anuluj z tego samego widoku, jeśli test zostanie odwołany.

Jak przechowywać i normalizować numer +62?

Indonezja używa prefiksu krajowego 0, więc lokalnie numery komórkowe zapisuje się jako 08 i dalsze cyfry. W E.164 zero znika: numer zapisany lokalnie jako 0812... staje się +62812.... Przechowuj formę E.164, normalizuj wszystko, co wpisze użytkownik, usuwając spacje, myślniki i wiodące 0, a o poprawności niech orzeka utrzymywana biblioteka do numerów telefonów, bo indonezyjskie numery abonentów nie mają jednej długości.

Szablony SMS-ów wysyłane na numery indonezyjskie są często w języku indonezyjskim (bahasa Indonesia), choć niektóre usługi wysyłają po angielsku. Wyodrębniaj kod wzorcem cyfr zamiast dopasowywać słowa takie jak „kode” czy „code”, a parser nie będzie zważał na język szablonu.

Dlaczego zespoły produktowe testują przepływy rejestracji w Indonezji?

Indonezja to jeden z najludniejszych krajów świata, a jej internet jest silnie nastawiony na urządzenia mobilne, więc weryfikacja numeru telefonu stoi na początku wielu przepływów onboardingu. Zespoły wchodzące do Azji Południowo-Wschodniej chcą zobaczyć, jak ich indonezyjskie ekrany rejestracji i logowania zachowują się z prawdziwym numerem +62, sprawdzić, czy teksty w języku indonezyjskim wyświetlają się bez ucinania, i potwierdzić, że ich reguły antyfraudowe nie blokują legalnych lokalnych użytkowników.

Regionalne zespoły operacyjne i marketplace'owe używają tej trasy także do weryfikacji kont firmowych, którymi zarządzają dla indonezyjskich sklepów. Strona o testach QA opisuje, jak włączyć to do planu regresji.

Co jeśli indonezyjski kod się nie pojawi?

Czas dostarczenia zależy od usługi i trasy, więc daj aktywacji czas, zanim uznasz ją za nieudaną. Gdy SMS nie nadejdzie:

• Poczekaj do końca 20-minutowego okna albo anuluj; tak czy inaczej pełna kwota automatycznie wraca do portfela.
• Zamów ponownie nieco później albo spróbuj innej trasy usługi, jeśli test na to pozwala.
• Potwierdź, że docelowa usługa akceptuje numery wirtualne dla tej akcji. Niektóre nie, i dlatego istnieje reguła zwrotu.
• Unikaj ponownych zamówień w ciasnej pętli. Stosuj backoff między próbami, aby zadanie CI nie przepaliło ponowień w kilka sekund.

Więcej pomysłów diagnostycznych znajdziesz w tekście o ograniczaniu nieudanych dostaw OTP.

Czy istnieje dedykowany numer +62 i jak jest rozliczany?

Nie. Samoobsługowa długoterminowa linia indonezyjska nie jest oferowana. Numery dedykowane to produkt dla Stanów Zjednoczonych i Kanady, od $1.95/month. Jeśli Twój zespół naprawdę potrzebuje stałej linii +62, napisz na [email protected]; to, czy da się ją załatwić, zależy od lokalnych przepisów i nie jest obiecane.

Rozliczenia OTP Gateway opierają się na jednym przedpłaconym portfelu w USD, bez opłaty miesięcznej i bez planu do wyboru. Zasil portfel kartą lub stablecoinami USDT/USDC; każde doładowanie uruchamia wysłanie faktury PDF e-mailem dla Twojej księgowości. Konta deweloperskie mogą poprosić o tryb sandbox, który zwraca symulowane numery i kody do testów integracyjnych end-to-end bez wydawania środków. Zobacz cennik lub załóż konto.

Najczęstsze pytania

Czy mogę przetestować indonezyjską rejestrację w mojej aplikacji bez lokalnej karty SIM?

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

Jakiego id kraju API OTP Route używa dla Indonezji?

Indonezja to id, więc zapytanie o cenę wygląda tak: GET /api/v1/prices?country=id&service=<id>.

Czy płacę, jeśli indonezyjski SMS nigdy nie dotrze?

Nie. Jeśli nic nie przyjdzie w 20-minutowym oknie albo anulujesz, cała opłata automatycznie wraca do portfela.

Czy zachować wiodące 0 przy zapisywaniu indonezyjskiego numeru komórkowego?

Zachowaj je tylko do wyświetlania w formacie lokalnym. Przechowuj +62 i numer krajowy bez 0, czyli formę E.164.

Czy indonezyjskie SMS-y weryfikacyjne będą po angielsku?

Nie zawsze. Wiele przychodzi w języku indonezyjskim, więc parsuj kod numeryczny, zamiast polegać na otaczających słowach.

Czy numery indonezyjskie wolno wykorzystywać w dowolnym celu?

Tylko w uprawnionym zakresie: do testowania i obsługi własnych produktów i kont, zgodnie z regulaminem każdej usługi. Do każdego zamówienia stosuje się Polityka dopuszczalnego użytkowania OTP Route.

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.