Salwadorskie (+503) kody weryfikacyjne dla zespołów QA i wdrożeniowych

Kod jednorazowy czy linia długoterminowa: czego potrzebuje test salwadorski?

Zacznij od kształtu testu, bo to on decyduje o produkcie.

• Pojedynczy krok weryfikacji (rejestracja, zmiana telefonu, dodatkowe sprawdzenie) odpowiada OTP Gateway. Zamawiasz numer +503 dla jednej usługi, kod przychodzi raz i numer jest zużyty.
• Konto, które musi się logować przez tygodnie, potrzebuje linii na własność. Numery dedykowane to produkt dla USA i Kanady od $1.95/month, kupowany natychmiast z panelu, z przychodzącymi SMS, wychodzącymi SMS i połączeniami z przeglądarki.

Dla Salwadoru nie ma samoobsługowego numeru dedykowanego. Jeśli zespół naprawdę potrzebuje długoterminowej linii salwadorskiej, napisz na [email protected]; to, czy uda się ją zorganizować, zależy od lokalnych przepisów i nie jest gwarantowane. Wiele zespołów rozwiązuje przypadek „powtarzanych logowań” linią amerykańską, gdy testowana usługa ją akceptuje. Przy wdrożeniu w Salwadorze rozważ obie ścieżki z pomocą tekstu o numerach tymczasowych i dedykowanych.

Jak przechowywać i walidować numery +503?

Salwador używa 8-cyfrowego zamkniętego planu numeracyjnego bez prefiksu międzymiastowego. Numer, który miejscowy wpisuje w formularzu, to te same 8 cyfr, które po +503 tworzą numer międzynarodowy, więc normalizacja sprowadza się głównie do usuwania znaków interpunkcyjnych: miejscowi często zapisują numery komórkowe jako dwa bloki po cztery cyfry oddzielone myślnikiem.

• Przechowuj formę E.164, +503 i osiem cyfr, w jednej kolumnie.
• Numery komórkowe zwykle zaczynają się od 6 lub 7; stacjonarne zwykle od 2. Walidator akceptujący tylko takie początkowe cyfry wyłapuje większość literówek.
• Odrzucaj dodatkowe zero na początku. Użytkownicy przyzwyczajeni do planów innych krajów Ameryki Łacińskiej czasem je dodają, a niektóre platformy SMS po cichu porzucają wiadomość.

Szablony SMS Twojej aplikacji na ten rynek są zwykle po hiszpańsku. Znaki takie jak á, í czy ó wykraczają poza podstawowy alfabet GSM, więc szablon, który ich używa, może przełączyć się na kodowanie UCS-2 i skrócić każdy segment. Umieść kod blisko początku wiadomości, aby przetrwał podział.

Dlaczego zespoły testują przepływy rejestracji w Salwadorze?

Kilka wzorców wraca regularnie:

• Premiery w Ameryce Środkowej. Produkt wdrażany w Gwatemali, Hondurasie i Salwadorze wymaga sprawdzenia kroku telefonicznego w każdym kraju, zanim ruszą reklamy.
• Klienci z diaspory. Wielu Salwadorczyków mieszka w Stanach Zjednoczonych i zachowuje numer +503 do kontaktu z rodziną, więc produkty do przekazów, płatności i komunikacji widzą salwadorskie numery, nawet gdy adres użytkownika jest amerykański. Ten przepływ opisuje onboarding w fintechu.
• Testy lokalizacji. Hiszpańskie teksty, selektor kraju i maski numerów wymagają prawdziwego salwadorskiego kodu, by potwierdzić, że ekrany działają od początku do końca.
• Ceny w dolarach amerykańskich. Dolar amerykański jest oficjalną walutą Salwadoru, co czyni ten rynek wygodnym miejscem do wspólnego testowania płatności i onboardingu.

Jak wygląda sekwencja wywołań El Salvador OTP API?

Wszystkie żądania trafiają na https://otproute.com/api/v1 z kluczem Bearer z prefiksem or_live_, tworzonym w konsoli deweloperskiej (do 10 kluczy, 300 żądań na minutę). Identyfikator kraju dla Salwadoru to sv.

1. Pobierz GET /api/v1/countries i GET /api/v1/services i zbuforuj identyfikatory.
2. Odczytaj aktualną cenę przez GET /api/v1/prices?country=sv&service=<id>; mówi ona też, czy trasa jest teraz dostępna.
3. Utwórz zamówienie przez POST /api/v1/activations z treścią w rodzaju {"service": "telegram", "country": "sv"}. Zapisz identyfikator aktywacji i numer.
4. Niech salwadorska wersja Twojej aplikacji wyśle SMS weryfikacyjny na ten numer.
5. Poczekaj na zdarzenie activation.sms_received na swoim endpoincie; bez niego odpytuj GET /api/v1/activations/{id} co kilka sekund.
6. Jeśli przepływ zostanie porzucony, wywołaj POST /api/v1/activations/{id}/cancel, aby środki wróciły od razu.

Każdy webhook niesie X-OTPRoute-Signature: t=<unix>,v1=<hex>, czyli HMAC-SHA256 ze znacznika czasu, kropki i surowej treści z sekretem Twojego endpointu. Zweryfikuj go i odrzucaj przeterminowane znaczniki; omawia to zabezpieczanie webhooków OTP. Osoby niebędące programistami zrobią to samo z panelu: wybierz Salwador, wybierz usługę, potwierdź aktualną cenę i obserwuj kod na karcie aktywacji.

Jakie usługi można zweryfikować na salwadorskim numerze?

Aktualne zestawienie pokazuje ponad 900 usług z trasami dla Salwadoru. Popularne to WhatsApp, Facebook, Instagram, TikTok, Uber, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Telegram, Signal, LinkedIn i ChatGPT (OpenAI). Dostępność zmienia się w ciągu dnia, dlatego Twój runner testów powinien opierać się na endpoincie cen, a nie na stałej liście.

Niektóre usługi odrzucają numery, które klasyfikują jako wirtualne. Nie mamy na to wpływu i właśnie po to istnieje reguła zwrotu.

Co jeśli salwadorski kod nie dotrze?

Wolny kod +503 to jeszcze nie nieudany, więc zostaw zamówienie otwarte przez pełne 20 minut. Jeśli nic nie przyjdzie, zamówienie wygasa, uruchamia się activation.expired, a cała kwota wraca automatycznie do portfela. Następnie:

• sprawdź, czy usługa akceptuje numery wirtualne dla tego rodzaju kroku;
• spróbuj później albo wybierz inną trasę usługi, zamiast zamawiać ponownie w ciasnej pętli;
• upewnij się, że Twoja aplikacja faktycznie wysłała SMS na dokładnie ten numer zwrócony w formacie E.164.

Dalsze wskazówki, przydatne także w Ameryce Środkowej, znajdziesz w tekście o ograniczaniu nieudanych dostaw OTP.

Jak rozliczane są zamówienia dla Salwadoru?

OTP Route korzysta z jednego przedpłaconego portfela w USD, w modelu pay as you go, bez opłaty miesięcznej i bez wyboru planu. Zasilić go można kartą lub stablecoinami USDT/USDC, a faktura PDF trafia na Twoją skrzynkę po każdym doładowaniu lub zakupie numeru. Do prac integracyjnych na życzenie można przełączyć konto deweloperskie w tryb sandbox, który zwraca symulowane numery i kody, dzięki czemu cała pętla działa bez wydawania środków z portfela. Aktualne stawki są na stronie cennika.

Najczęstsze pytania

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

Tak. Zamów numer +503 w OTP Gateway dla testowanej usługi, wywołaj SMS i odczytaj kod w panelu lub przez API.

Czy salwadorskie numery mają prefiks międzymiastowy, np. 0?

Nie. Numery salwadorskie mają osiem cyfr bez prefiksu międzymiastowego, więc forma międzynarodowa to po prostu +503 i te osiem cyfr.

Jaki jest identyfikator kraju dla Salwadoru w API OTP Route?

Użyj sv w zapytaniach o ceny i w treści aktywacji, na przykład GET /api/v1/prices?country=sv&service=<id>.

Czy zostanę obciążony, jeśli numer +503 nie dostanie kodu?

Nie. Jeśli w 20-minutowym oknie nie nadejdzie SMS albo wcześniej anulujesz, cała kwota wraca automatycznie do portfela.

Czy mogę zachować salwadorski numer do powtarzanych logowań?

Nie jako produkt samoobsługowy. Długoterminowe numery dedykowane są oferowane w Stanach Zjednoczonych i Kanadzie; w sprawie Salwadoru możesz napisać na [email protected], bez obietnicy dostępności.

Czy OTP Route służy do tworzenia wielu kont?

Nie. Służy do testowania i prowadzenia własnych, legalnych produktów i kont, w granicach regulaminu każdej usługi i Acceptable Use Policy OTP Route.

Czy mogę uruchamiać salwadorski przepływ w CI bez wydawania pieniędzy?

Tak. Konto deweloperskie można na życzenie przełączyć w tryb sandbox, który zwraca symulowane numery i kody, aby Twój pipeline przećwiczył pełną ścieżkę API.

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.