Droga programisty do szwajcarskich (+41) kodów weryfikacyjnych

Które zapytania zwracają szwajcarski kod przez API?

Switzerland OTP API to ta sama niewielka powierzchnia, której używasz dla każdego kraju, z identyfikatorem kraju ch. Uwierzytelniasz się kluczem Bearer (prefiks or_live_) utworzonym w konsoli Developer; jedno konto może mieć do 10 kluczy.

1. Pobierz identyfikatory z GET /api/v1/services i GET /api/v1/countries i przechowuj je w pamięci podręcznej między uruchomieniami.
2. Sprawdź GET /api/v1/prices?country=ch&service=<id>. Odpowiedź zawiera aktualną cenę oraz informację, czy trasa jest w tej chwili otwarta.
3. Wyślij POST /api/v1/activations z {"service": "whatsapp", "country": "ch"} lub z dowolną usługą, którą obejmuje Twój test. Zachowaj zwrócony identyfikator aktywacji.
4. Wpisz numer +41 w pole telefonu we własnym produkcie.
5. Odczytaj wynik z GET /api/v1/activations/{id} lub z webhooka; w razie potrzeby czysto przerwij przez POST /api/v1/activations/{id}/cancel.

GET /api/v1/balance warto umieścić w kroku przygotowawczym swojego zestawu testów. Limit to 300 żądań na minutę na konto, co spokojnie wystarcza dla kilku równoległych zadań odpytujących API w spokojnym odstępie. Opis endpointów: dokumentacja.

Polling czy webhooki dla aktywacji +41?

Polling sprawdza się w prostym, szybkim skrypcie. Webhooki wygrywają, gdy tylko testy działają równolegle, bo nic nie musi się kręcić w pętli, gdy SMS jest jeszcze w drodze do Zurychu.

OTP Route pozwala zarejestrować do pięciu endpointów; na każdy z nich zasubskrybuj activation.sms_received, activation.expired i activation.cancelled. Każdą dostawę zweryfikuj, zanim jej zaufasz: weź części t i v1 z nagłówka X-OTPRoute-Signature, policz HMAC-SHA256 z "<t>.<raw body>" z użyciem sekretu endpointu, porównaj w stałym czasie i odrzucaj znaczniki czasu spoza krótkiej tolerancji. Przetwarzanie opieraj na identyfikatorze aktywacji, aby ponowiona dostawa była nieszkodliwą operacją bez skutków.

Dokładniej o sprawdzaniu podpisów piszemy w artykule zabezpieczanie webhooków OTP przez HMAC.

Jak szwajcarski numer powinien wyglądać w Twojej bazie danych?

W kraju szwajcarskie numery zaczynają się od prefiksu krajowego 0, na przykład numer komórkowy zapisany jako 079 123 45 67. W formacie międzynarodowym to zero znika: postać E.164 to +41 79 123 45 67, czyli dziewięć cyfr po kodzie kraju. Zakresy komórkowe mieszczą się w bloku 07x. Zapisuj kanoniczny ciąg +41…, a formatuj go dopiero do wyświetlenia, inaczej deduplikacja i wyszukiwanie przestaną działać, gdy jedna postać będzie zapisana jako 079, a inna jako +4179.

Drugą szwajcarską osobliwością jest język. Skoro niemiecki, francuski, włoski i romansz są językami narodowymi, SMS weryfikacyjny może przyjść w jednym z trzech pierwszych, zależnie od tego, jak nadawca obsługuje ustawienia regionalne, a wiele aplikacji po prostu wraca do angielskiego. Jeśli Twój produkt lokalizuje treści według regionu, prawdziwy kod z numeru +41 to tani sposób, by sprawdzić, czy uruchamia się właściwy szablon.

Zespoły testują tutaj przed wejściem z produktem fintech lub e-commerce na rynek szwajcarski, przy obsłudze pracowników zarządzających kontami firmowymi z Genewy czy Bazylei oraz przy walidacji przepływów transgranicznych, które obejmują także Liechtenstein z własnym kodem +423.

Usługi, które możesz zweryfikować numerem weryfikacyjnym ze Szwajcarii

Bieżąca migawka dla ch obejmuje m.in. Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, WhatsApp, Telegram, Signal, Uber, Airbnb, Amazon, eBay, Netflix, Discord, ChatGPT (OpenAI) i Claude. W sumie Szwajcaria ma w OTP Gateway ponad 1700 usług.

Ponieważ dostępność zmienia się w ciągu dnia, traktuj tę listę jako punkt wyjścia i pytaj o dane na żywo w trakcie działania. Zestaw testów, który najpierw sprawdza ceny i oznacza test jako pominięty, gdy trasa jest zamknięta, daje znacznie czystsze raporty niż taki, który ślepo ponawia próby.

Rozwiązywanie problemów: szwajcarska aktywacja, która pozostaje pusta

Gdy numer +41 niczego nie odbiera, przejdź przez poniższe kroki, zanim ruszysz kod:

• Daj szansę pełnemu 20-minutowemu oknu; niektóre platformy kolejkują wiadomości wychodzące.
• Sprawdź, czy usługa odrzuca numery wirtualne. Kilka tak robi i właśnie na taki przypadek istnieje automatyczny zwrot środków.
• Ponów próbę po przerwie albo użyj innej trasy usługi zamiast zamawiać w ciasnej pętli.
• Anuluj porzucone aktywacje, aby pieniądze wróciły od razu.

Wpis o routingu OTP według kraju wyjaśnia, dlaczego ta sama aplikacja może zachowywać się inaczej na trasach różnych krajów.

Czy istnieje długoterminowy numer szwajcarski?

Nie jako produkt samoobsługowy. Dla Szwajcarii OTP Route oferuje wyłącznie numery jednorazowe w OTP Gateway.

Dedykowane numery wirtualne, które zachowujesz, dopóki się odnawiają, są dostępne tylko w Stanach Zjednoczonych i Kanadzie i kosztują od $1.95/miesiąc. Jeśli potrzebujesz konkretnie stałej linii szwajcarskiej, napisz na [email protected] i opisz swój przypadek użycia; odpowiedź zależy od lokalnych przepisów i nie można jej obiecać z góry.

Portfel, faktury i sandbox dla szwajcarskiego routingu OTP

Płacisz na bieżąco z jednego przedpłaconego portfela w USD. Nie ma opłaty miesięcznej ani planu do wyboru. Zasilasz go kartą lub w USDT/USDC, a po każdym doładowaniu na e-mail przychodzi faktura PDF, co porządkuje księgowość szwajcarskich podmiotów rozliczających się we frankach.

Do prac integracyjnych poproś o tryb sandbox dla konta deweloperskiego. Zwraca on symulowane numery i kody, dzięki czemu całą ścieżkę API weryfikacji SMS można przetestować bez wydawania środków z portfela. Prawdziwych aktywacji używaj wyłącznie dla własnych produktów i kont, zgodnie z regulaminami poszczególnych usług i Acceptable Use Policy OTP Route. Strona rozwiązanie do testów QA pokazuje, jak zespoły włączają to do kontroli przed wydaniem.

Najczęstsze pytania

Jakiego identyfikatora kraju używa API dla Szwajcarii?

Szwajcaria to ch. Szwajcarskie żądania niosą tę dwuliterową wartość wszędzie tam, gdzie oczekiwany jest kraj, także w treści aktywacji.

Czy mogę sprawdzić szwajcarski proces logowania bez szwajcarskiej karty SIM?

Tak. Numer +41 do testów z OTP Gateway odbiera kod, który następnie odczytujesz w panelu lub przez API.

Czy przy zapisie szwajcarskiego numeru komórkowego zachować 0?

Nie. Zero to krajowy prefiks; zapisuj postać E.164 zaczynającą się od +41, po której następuje dziewięć cyfr.

W jakim języku będzie szwajcarski SMS weryfikacyjny?

To zależy od nadawcy: niemiecki, francuski, włoski lub angielski są równie częste. Kod wyodrębniaj wzorcem cyfr, a nie opierając się na stałym brzmieniu.

Ile kosztuje szwajcarski kod SMS OTP?

Od $0.20 za kod, a dokładną cenę dla danej usługi zwraca GET /api/v1/prices jeszcze przed zamówieniem.

Co dzieje się z moimi pieniędzmi, jeśli kod nie dotrze?

Wracają automatycznie do portfela, gdy okno się zamknie albo gdy anulujesz aktywację.

Czy Liechtenstein jest objęty szwajcarską trasą?

Nie, Liechtenstein ma własny kod kraju +423 i własną stronę na liście krajów, więc zamawiaj go osobno.

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.