스위스(+41) 인증 코드를 받는 개발자를 위한 경로

API의 어떤 요청으로 스위스 코드를 받을 수 있나요?

스위스 OTP API는 다른 모든 국가와 동일한 간단한 인터페이스를 사용하며, 국가 id는 ch입니다. Developer 콘솔에서 발급한 Bearer 키(접두사 or_live_)로 인증하며, 계정당 키는 최대 10개까지 보유할 수 있습니다.

1. GET /api/v1/services와 GET /api/v1/countries로 id를 확인하고 실행 간에 캐시해 두세요.
2. GET /api/v1/prices?country=ch&service=<id>를 확인합니다. 응답에는 현재 가격과 지금 경로가 열려 있는지 여부가 담겨 있습니다.
3. POST /api/v1/activations에 {"service": "whatsapp", "country": "ch"} 또는 테스트 대상 서비스를 지정해 보냅니다. 반환된 activation id를 보관하세요.
4. +41 번호를 자사 제품의 전화번호 입력란에 넣습니다.
5. GET /api/v1/activations/{id} 또는 웹훅으로 결과를 읽고, 중단할 때는 POST /api/v1/activations/{id}/cancel로 깔끔하게 취소합니다.

GET /api/v1/balance는 테스트 스위트의 준비 단계에 넣어 두는 것이 좋습니다. 요청 한도는 계정당 분당 300회로, 여러 작업이 여유 있는 간격으로 폴링해도 충분합니다. 엔드포인트 레퍼런스: 문서.

+41 활성화에는 폴링과 웹훅 중 무엇이 좋을까요?

간단한 스크립트라면 폴링이 편합니다. 하지만 테스트를 병렬로 실행하는 순간부터는 웹훅이 낫습니다. 취리히로 향하는 SMS가 오가는 동안 아무것도 대기하며 돌고 있을 필요가 없기 때문입니다.

OTP Route는 엔드포인트를 최대 다섯 개까지 등록할 수 있으며, 각각 activation.sms_received, activation.expired, activation.cancelled를 구독하세요. 신뢰하기 전에 모든 전달을 검증해야 합니다. X-OTPRoute-Signature의 t와 v1 부분을 꺼내 엔드포인트 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 계산하고, 상수 시간 비교를 하며, 허용 범위를 벗어난 타임스탬프는 거부합니다. 재전송된 전달이 무해한 no-op이 되도록 처리 키는 activation id로 잡으세요.

서명 검증을 더 깊이 다룬 글은 HMAC으로 OTP 웹훅 보호하기를 참고하세요.

스위스 번호는 데이터베이스에 어떤 형태로 저장해야 하나요?

스위스 국내에서는 번호가 트렁크 접두사 0으로 시작하며, 휴대전화는 079 123 45 67처럼 표기합니다. 국제 형식에서는 이 0이 사라지고 E.164 형태는 국가 코드 뒤에 아홉 자리가 붙은 +41 79 123 45 67이 됩니다. 휴대전화 대역은 07x 블록에 있습니다. 표준 +41… 문자열만 저장하고 표시할 때만 서식을 적용하세요. 그렇지 않으면 한쪽은 079, 다른 쪽은 +4179로 적혀 중복 제거와 조회가 깨집니다.

또 하나의 스위스 특이점은 언어입니다. 독일어, 프랑스어, 이탈리아어, 로만슈어가 모두 공용어라서, 발신자의 로케일 처리에 따라 인증 SMS가 앞의 세 언어 중 어느 것으로든 올 수 있고, 많은 앱은 그냥 영어로 대체합니다. 제품이 지역별로 현지화된다면 실제 +41 코드는 올바른 템플릿이 작동하는지 저렴하게 확인하는 방법입니다.

스위스 시장에 핀테크나 전자상거래 제품을 출시하기 전, 제네바나 바젤에서 비즈니스 계정을 관리하는 담당자를 지원할 때, 또는 자체 국가 코드 +423을 쓰는 리히텐슈타인까지 걸치는 국경 간 흐름을 검증할 때 팀들이 이곳에서 테스트합니다.

스위스 인증 번호로 확인할 수 있는 서비스

ch의 현재 스냅샷에는 Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, WhatsApp, Telegram, Signal, Uber, Airbnb, Amazon, eBay, Netflix, Discord, ChatGPT (OpenAI), Claude 등이 올라 있습니다. 전체적으로 스위스는 OTP Gateway에서 1,700개가 넘는 서비스를 제공합니다.

가용성은 하루 동안에도 계속 바뀌므로 이 목록은 출발점으로만 보고, 실행 시점에 실시간 데이터를 조회하세요. 가격을 먼저 확인하고 경로가 닫혀 있으면 테스트를 건너뜀으로 표시하는 하네스가, 맹목적으로 재시도하는 하네스보다 훨씬 깔끔한 리포트를 만듭니다.

스위스 활성화가 계속 비어 있을 때의 문제 해결

+41 번호로 아무것도 오지 않는다면, 코드를 건드리기 전에 다음을 차례로 확인하세요.

• 20분의 전체 시간을 기다려 보세요. 일부 플랫폼은 발신 메시지를 대기열에 쌓아 둡니다.
• 해당 서비스가 가상 번호를 거부하는지 확인하세요. 거부하는 서비스가 여럿 있으며, 바로 이런 경우를 위해 자동 환불이 존재합니다.
• 잠시 쉬었다가 다시 시도하거나, 짧은 간격으로 반복 주문하지 말고 다른 서비스 경로를 사용하세요.
• 쓰지 않는 활성화는 취소해서 금액이 즉시 돌아오게 하세요.

같은 앱이 국가 경로에 따라 다르게 동작할 수 있는 이유는 OTP 국가별 라우팅 글에서 설명합니다.

스위스 장기 번호도 있나요?

셀프 서비스 상품으로는 없습니다. 스위스에는 OTP Gateway를 통한 일회용 번호만 제공됩니다.

갱신하는 동안 계속 보유할 수 있는 전용 가상 번호(Dedicated Virtual Numbers)는 미국과 캐나다에 한정되며 월 $1.95부터 시작합니다. 지속적인 스위스 회선이 꼭 필요하다면 [email protected]으로 사용 사례를 적어 문의하세요. 현지 규정에 따라 달라지므로 미리 약속드릴 수는 없습니다.

스위스 OTP 라우팅의 지갑, 인보이스, 샌드박스

단일 선불 USD 지갑에서 사용한 만큼만 지불합니다. 월 요금이나 선택할 요금제는 없습니다. 카드 또는 USDT/USDC로 충전하며, 충전할 때마다 PDF 인보이스가 이메일로 발송되어 프랑 기준으로 정산하는 스위스 법인의 회계 처리가 깔끔해집니다.

연동 작업에는 개발 계정에 샌드박스 모드를 요청하세요. 시뮬레이션된 번호와 코드가 반환되므로 지갑 잔액을 쓰지 않고 SMS 인증 API의 전체 경로를 테스트할 수 있습니다. 실제 활성화는 각 서비스의 약관과 OTP Route의 Acceptable Use Policy 범위 안에서 자사 제품과 계정에만 사용하세요. QA 테스트 솔루션 페이지에서 팀들이 이를 릴리스 점검에 녹여 넣는 방법을 볼 수 있습니다.

자주 묻는 질문

스위스 API는 어떤 국가 id를 사용하나요?

스위스는 ch입니다. 활성화 본문을 포함해 국가 값이 필요한 모든 곳에서 스위스 요청은 이 두 글자 값을 사용합니다.

스위스 SIM 없이도 스위스 로그인 흐름을 확인할 수 있나요?

네. OTP Gateway의 테스트용 +41 번호가 코드를 수신하고, 그 코드를 대시보드나 API에서 읽을 수 있습니다.

스위스 휴대전화 번호를 저장할 때 0을 남겨야 하나요?

아니요. 0은 국내 트렁크 접두사입니다. +41로 시작하고 아홉 자리가 이어지는 E.164 형식으로 저장하세요.

스위스 인증 SMS는 어떤 언어로 오나요?

발신자에 따라 다릅니다. 독일어, 프랑스어, 이탈리아어, 영어가 모두 흔합니다. 고정된 문구 대신 숫자 패턴으로 코드를 추출하세요.

스위스 SMS OTP 요금은 얼마인가요?

코드당 $0.20부터이며, 주문하기 전에 GET /api/v1/prices가 서비스별 정확한 가격을 반환합니다.

코드가 오지 않으면 제 돈은 어떻게 되나요?

시간이 만료되거나 활성화를 취소하면 자동으로 지갑에 환불됩니다.

리히텐슈타인도 스위스 경로에 포함되나요?

아니요. 리히텐슈타인은 자체 국가 코드 +423과 국가 목록의 별도 페이지가 있으므로 따로 주문하셔야 합니다.

서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.