Numery weryfikacyjne Gwatemali (+502) do testów i operacji

Co sprawia, że Gwatemala zasługuje na osobny przebieg testów?

Gwatemala to najludniejszy kraj Ameryki Środkowej i dla wielu zespołów pierwszy rynek w regionalnym wdrożeniu hiszpańskojęzycznym. Językiem urzędowym jest hiszpański, a duża część mieszkańców mówi także jednym z licznych języków Majów, co ma znaczenie, jeśli teksty onboardingu lub treści wsparcia wykraczają poza hiszpański.

Trzy sytuacje powtarzają się najczęściej:

• Starty regionalne, w których ekran wpisywania numeru, hiszpańskie brzmienie SMS-a i krok weryfikacji trzeba sprawdzić na prawdziwej trasie +502 (weryfikacja aplikacji mobilnych).
• Produkty dla diaspory, takie jak aplikacje do przekazów pieniężnych lub rozmów używane przez Gwatemalczyków mieszkających w Stanach Zjednoczonych, gdzie konto jest powiązane z numerem z kraju ojczystego.
• Zespoły operacyjne zarządzające profilami firmowymi klientów z Gwatemali, którzy wolą nie wiązać z nimi niczyjego prywatnego telefonu (zespoły operacyjne).

Jak formatuje się gwatemalskie numery telefonów?

Gwatemala używa ośmiocyfrowych numerów krajowych i nie ma prefiksu krajowego, więc nie ma początkowego zera do usunięcia. Forma E.164 to po prostu +502 i te osiem cyfr, zapisywane jako +502 xxxx xxxx.

Ta krótka długość myli walidatory formularzy pisane z myślą o dziesięciocyfrowych numerach północnoamerykańskich. Dodaj przypadki testowe dla wpisu ośmiocyfrowego, dla użytkowników wpisujących 502 bez znaku plus oraz dla spacji lub myślników w środku. Przechowuj znormalizowany ciąg E.164 i nie zgaduj, czy numer jest komórkowy czy stacjonarny, wyłącznie po długości, bo oba mają te same osiem cyfr.

Czy mogę odbierać kody SMS OTP z Gwatemali przez API?

Tak. Guatemala OTP API używa identyfikatora kraju gt z adresem bazowym https://otproute.com/api/v1, z uwierzytelnianiem kluczem Bearer z prefiksem or_live_.

Zacznij od GET /api/v1/services, by znaleźć identyfikator usługi, a potem sprawdź aktualną wycenę przez GET /api/v1/prices?country=gt&service=<id>. Utwórz numer przez POST /api/v1/activations z treścią {"service": "<id>", "country": "gt"}. Gdy Twoja aplikacja wyśle SMS, odpytuj GET /api/v1/activations/{id} albo pozwól endpointowi webhooka odebrać activation.sms_received. Zweryfikuj nagłówek X-OTPRoute-Signature, czyli HMAC-SHA256 ze znacznika czasu i surowej treści, i odrzucaj przestarzałe znaczniki czasu, jak opisano w tekście o zabezpieczaniu webhooków OTP. Przegląd dla deweloperów podaje limity: 10 kluczy, 5 endpointów webhooków, 300 żądań na minutę.

Które usługi są teraz na trasie +502?

Dla Gwatemali wymienionych jest ponad 1,600 usług. Aktualny przegląd popularnych obejmuje WhatsApp, Facebook, TikTok, Telegram, Instagram, Google (Gmail & YouTube), X (Twitter), Uber, Amazon, Discord, LinkedIn, Signal, Netflix i Microsoft & Outlook. Zasoby rotują w ciągu dnia, dlatego API zwraca dostępność na żywo, a nie stały katalog.

Czy jest ścieżka bez kodu dla supportu i operacji?

Każdy w zespole może zamawiać z panelu po rejestracji za pomocą e-maila i 6-cyfrowego kodu albo logowania Google. Wybierz Gwatemalę, wskaż usługę, potwierdź wyświetloną cenę i skopiuj numer +502 do aplikacji. Kod pojawi się na tym samym ekranie, gdy dotrze. Włączenie uwierzytelniania dwuskładnikowego (TOTP) na samym koncie OTP Route to rozsądny krok przy współdzielonym dostępie zespołu.

Dlaczego mój kod +502 się nie pojawił i co spróbować?

Numer pozostaje aktywny przez 20 minut, a opłata obowiązuje tylko wtedy, gdy kod zostanie dostarczony. Jeśli okno wygaśnie albo anulujesz, cała kwota automatycznie wraca do portfela.

1. Poczekaj do końca okna; czas dostarczenia zależy od usługi i trasy.
2. Spróbuj później albo inną trasą usługi, jeśli jest dostępna.
3. Sprawdź, czy usługa akceptuje numery wirtualne, bo niektóre je odrzucają.
4. Nie wysyłaj nowych zamówień w ciasnej pętli; rób przerwy między próbami.

A co z długoterminowymi numerami gwatemalskimi, rozliczeniami i sandboxem?

Samoobsługowy, długoterminowy numer gwatemalski nie istnieje w OTP Route. Linie dedykowane są tylko dla Stanów Zjednoczonych i Kanady, od $1.95/miesiąc. Jeśli potrzebujesz trwałej linii +502, napisz na [email protected]; to, czy da się coś zorganizować, zależy od lokalnych przepisów i nie jest pewne.

Płatność odbywa się przez jeden przedpłacony portfel w USD, bez planu i opłaty miesięcznej, zasilany kartą lub USDT/USDC, a po każdym doładowaniu na e-mail przychodzi faktura PDF. Do prac integracyjnych konto deweloperskie można na prośbę przełączyć w tryb sandbox, aby symulowane numery i kody przepływały przez Twój kod bez kosztów.

Najczęstsze pytania

Czy mogę sprawdzić hiszpańskojęzyczny proces rejestracji dla Gwatemali bez lokalnej karty SIM?

Tak. Zamów numer gt w OTP Gateway, wpisz go w aplikacji i odczytaj hiszpański kod w panelu lub z webhooka.

Czy gwatemalskie numery wymagają początkowego zera?

Nie. Gwatemala nie ma prefiksu krajowego, więc numer to po prostu +502 i osiem cyfr.

Ile minimalnie może kosztować kod +502?

Ceny zaczynają się od $0.20 za kod; kwotę dla konkretnej usługi zwraca GET /api/v1/prices i jest pokazywana przed potwierdzeniem.

Czy zapłacę, jeśli SMS weryfikacyjny nigdy nie przyjdzie?

Nie. Bez dostarczonego kodu w 20-minutowym oknie albo po anulowaniu cała kwota wraca do portfela.

Czy OTP Route może na stałe zatrzymać ten sam numer +502 dla mojego zespołu?

Nie w trybie samoobsługowym. Numery OTP Gateway obsługują pojedynczy kod, a linie długoterminowe są tylko w USA i Kanadzie, więc w sprawie Gwatemali napisz na [email protected].

Jakie zasady obowiązują przy korzystaniu z tych numerów?

Regulaminy poszczególnych usług oraz Polityka Dopuszczalnego Użytku OTP Route. Używaj numerów wyłącznie do testowania lub prowadzenia własnych, legalnych produktów i kont firmowych.

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.