우크라이나 테스트에는 일회용 번호와 장기 회선 중 무엇이 필요한가요?
이 질문부터 시작하세요. 나머지 모든 것이 여기서 결정됩니다. 일회용 OTP Gateway 번호는 인증 코드 하나를 받고 닫힙니다. 장기 회선은 보유하면서 몇 달 뒤에 다시 로그인할 때도 쓸 수 있는 번호입니다.
우크라이나의 경우 답은 간단합니다. 셀프서비스로는 OTP Gateway를 쓰며, 셀프서비스 우크라이나 전용 번호는 없습니다. 장기 Dedicated Numbers는 미국과 캐나다에만 월 $1.95부터 제공되며, 계속 로그인해야 하는 스테이징 계정이나 팀 공용 복구 회선에 적합합니다. 지속적인 +380 회선이 꼭 필요하다면 [email protected]으로 이메일을 보내세요. 제공 여부는 현지 규정에 따라 달라지며 약속되지 않습니다.
따라서 실용적인 구분은 이렇습니다. 가입과 전화번호 단계 QA에는 +380 일회용 번호를 쓰고, 테스트 계정이 재인증을 견뎌야 한다면 미국이나 캐나다 회선이 테스트에 맞는지 검토하세요. 장단점은 임시 번호 vs 전용 번호 비교에서 설명합니다.
엔지니어링 팀은 왜 +380 번호로 테스트하나요?
우크라이나에는 규모가 큰 소프트웨어 엔지니어링 커뮤니티가 있으며, 많은 국제 제품 팀에 우크라이나인 개발자와 테스터가 포함되어 있습니다. 그 밖에도 몇 가지 상황이 반복적으로 나타납니다.
- 우크라이나어 QA: 우크라이나어가 국가 공식어이며, 온보딩을 현지화하는 팀은 키릴 문자 문구에 둘러싸인 실제 전화번호 단계를 확인하고 싶어 합니다.
- 디아스포라 사용자: +380 번호를 가진 사람들이 이제 폴란드, 독일 등 다른 유럽 국가에 살고 있으므로, 다른 곳에서 출시한 앱도 가입 시 우크라이나 번호를 만납니다.
- 메시징 중심 흐름: 우크라이나에서는 Telegram과 Viber가 널리 쓰이므로, 둘 중 하나와 연동하는 제품의 일반적인 테스트 대상이 됩니다.
인증 문자 자체는 서비스와 계정 설정에 따라 우크라이나어, 영어 또는 다른 언어로 올 수 있으므로, 고정된 단어를 매칭하지 말고 패턴으로 숫자를 추출하세요.
+380 번호는 어떻게 정규화해야 하나요?
국내에서 우크라이나 번호는 트렁크 0 뒤에 9자리를 붙여 0XX XXX XX XX 형태로 씁니다. 국제 형식에서는 0을 빼서 +380 뒤에 9자리 국내 번호가 옵니다. 국가 코드 자체가 0으로 끝나기 때문에 직접 작성한 일부 검증기가 혼동한다는 점에 유의하세요.
지침은 다음과 같습니다.
- E.164 문자열만 저장하고, 공백 서식이나 트렁크 0은 표시할 때 적용하세요.
- 사용자가 +380을 선택한 뒤
0…을 입력하면 맨 앞의 0을 정확히 하나만 제거하세요. - 트렁크 접두사를 떼지 않았다는 신호인
+3800…에 주의하세요. - 다른 곳에서 복사한 정규식 대신 관리되는 라이브러리로 길이를 검증하세요.
우크라이나 인증 번호는 어떤 서비스를 받을 수 있나요?
실시간 스냅샷에서 우크라이나는 1,500개가 넘는 서비스로 집계됩니다. 인기 서비스로는 Telegram, Viber, WhatsApp, Signal, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Discord, LinkedIn, Microsoft & Outlook, Uber, ChatGPT (OpenAI), Claude가 있습니다.
제공 항목은 하루 동안 바뀌므로 이 목록은 예시로 보고, 현재 이용 가능한 항목은 API가 알려 주도록 하세요.
우크라이나 OTP API 호출은 어떻게 맞물리나요?
+380 번호 요청은 개발자 콘솔에서 생성한 or_live_ Bearer 키로 서명해 https://otproute.com/api/v1로 보냅니다. 우크라이나의 국가 id는 ua입니다.
깔끔한 순서는 이렇습니다. GET /api/v1/services와 GET /api/v1/countries로 id를 조회하고, GET /api/v1/prices?country=ua&service=<id>로 비용과 가용성을 확인하며, GET /api/v1/balance로 잔액을 확인한 뒤, {"service": "viber", "country": "ua"}와 함께 POST /api/v1/activations를 보냅니다. 응답에는 +380 번호와 활성화 id가 담겨 있습니다.
전달 방식은 GET /api/v1/activations/{id} 폴링과 activation.sms_received, activation.expired, activation.cancelled를 구독한 웹훅 중에서 고르면 됩니다. 모든 웹훅에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함되며, 엔드포인트 시크릿으로 <t>.<raw body>에 대한 HMAC-SHA256으로 검증하고, 오래된 타임스탬프는 거부하며, 각 활성화 id는 한 번만 처리하세요. 계정당 키 10개, 엔드포인트 5개, 분당 300건 요청이 허용됩니다. 자세한 내용은 문서에 있습니다.
비개발자를 위한 대시보드 경로는 무엇인가요?
지원 및 그로스 담당자는 API를 건너뛸 수 있습니다. 대시보드에서 OTP Gateway를 열고 우크라이나와 서비스를 선택해 표시된 가격을 확인한 뒤 주문하세요. +380 번호를 앱에 입력하고 SMS를 요청하면, 도착하는 대로 활성화 페이지에 코드가 표시됩니다.
코드가 오지 않으면 어떻게 하나요? 결제는 어떻게 처리되나요?
활성화는 20분 동안 열려 있으며 코드가 도착한 경우에만 비용을 냅니다. 시간 창이 빈 채로 닫히거나 POST /api/v1/activations/{id}/cancel을 호출하면 전체 금액이 지갑으로 돌아갑니다.
코드가 없다면 시간 창이 끝날 때까지 기다린 뒤 나중에 또는 다른 서비스 경로로 다시 시도하세요. 서비스가 가상 번호를 거부하는지 확인하고, 반복 주문을 빠른 반복문으로 보내지 마세요.
자금은 월 요금이 없는 하나의 선불 USD 지갑에서 나갑니다. 충전은 카드와 USDT/USDC 모두 가능하며, 충전할 때마다 PDF 인보이스가 받은편지함에 도착합니다. 요청하면 개발 계정을 시뮬레이션된 번호와 코드를 쓰는 샌드박스 모드로 운영할 수 있어 CI 파이프라인을 구성할 때 유용합니다. OTP Route는 본인의 합법적인 제품과 계정을 위한 서비스이므로, 각 서비스의 약관과 허용 가능 사용 정책을 따르세요.
자주 묻는 질문
우크라이나 SIM 없이 우크라이나 SMS OTP 코드를 받을 수 있나요?
네. OTP Gateway에서 +380 번호를 주문하고 대시보드나 API로 코드를 확인하세요.
OTP Route는 우크라이나에 어떤 국가 id를 쓰나요?
가격 조회와 POST /api/v1/activations 본문에 ua를 사용하세요.
트렁크 0은 +380 번호의 일부인가요?
국내 다이얼링에서만 그렇습니다. E.164에서는 추가 0 없이 +380 뒤에 9자리를 붙여 저장하세요.
우크라이나 인증 번호는 얼마인가요?
요금은 코드당 $0.20부터 시작하며, 서비스별 정확한 실시간 금액은 API가 반환합니다.
나중에 로그인하려고 +380 번호를 계속 보유할 수 있나요?
셀프서비스 장기 우크라이나 회선은 없습니다. Dedicated Numbers는 미국과 캐나다 제품이며, 그 밖의 경우는 [email protected]으로 문의하세요.
Telegram이 코드를 보내지 않으면 손해를 보나요?
아니요. 20분의 시간 창 안에 코드가 오지 않으면 청구된 금액이 자동으로 지갑에 돌아갑니다.
CI에서 우크라이나어 온보딩을 종단 간으로 테스트할 수 있나요?
네, 테스트 스위트에서 API를 호출하면 되고, 샌드박스 계정으로 시뮬레이션된 코드로 먼저 흐름을 연습할 수 있습니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.