QA, 온보딩, 지역 운영을 위한 리투아니아(+370) 일회용 코드

빌뉴스에서는 서류상 온보딩이 잘 되는데, 실제 +370 번호로 어떻게 증명하나요?

리투아니아에는 핀테크와 전자화폐 회사가 많고, 많은 SaaS 제품이 첫 발트 시장으로 이곳을 택합니다. 그러다 보면 익숙한 고민이 생깁니다. 휴대폰 인증 단계를 자국 번호로 만들고 테스트했기 때문에, 리투아니아 고객에게 어떻게 동작하는지는 문의가 올 때까지 아무도 모릅니다.

현실적인 해결책은 +370 경로를 테스트 인프라로 취급하는 것입니다. OTP 라우팅을 이용하면 필요할 때 리투아니아 회선을 요청하고, 실제 가입 화면을 그 번호로 실행하고, 코드를 코드로 받아 올 수 있습니다. 컴플라이언스와 제품 팀은 플로우가 처음부터 끝까지 동작한다는 증거를 얻고, 엔지니어는 동료의 개인 휴대폰을 빌리지 않아도 됩니다. 더 넓은 패턴은 핀테크 온보딩 노트에서 다룹니다.

어떤 앱이 리투아니아 인증 번호로 코드를 보낼 수 있나요?

lt 카탈로그에는 현재 1,500개가 넘는 서비스가 있습니다. 자주 요청되는 서비스는 WhatsApp, Telegram, Viber, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, eBay, Discord, LinkedIn, Uber, Netflix, Airbnb, Signal 등입니다.

이 스냅샷은 2026년 10월 31일에 열려 있던 경로를 반영합니다. 재고는 하루 종일 움직이므로 스크립트에 서비스 목록을 고정하지 말고 가격 엔드포인트로 실시간 상태를 확인하세요. 일부 앱은 가상 번호를 아예 받지 않는다는 점도 염두에 두세요. 그런 경우 활성화는 그냥 만료되고 환불됩니다.

실제로 리투아니아 OTP API 플로우는 어떤 모습인가요?

이 SMS 인증 API는 평범한 REST입니다. 개발자 콘솔에서 키를 생성하고(계정당 최대 10개, 접두사 or_live_), Bearer 토큰으로 https://otproute.com/api/v1에 보내세요. 그다음은 다음과 같습니다.

1. GET /api/v1/countries와 GET /api/v1/services로 id를 확인합니다. 리투아니아는 lt입니다.
2. GET /api/v1/prices?country=lt&service=<id>로 지금 이 경로의 비용을 확인합니다.
3. POST /api/v1/activations에 {"service": "linkedin", "country": "lt"}를 보내고 활성화 id를 보관합니다.
4. 테스트 중인 폼에 +370 번호를 입력합니다.
5. 웹훅으로 activation.sms_received를 받습니다. GET /api/v1/activations/{id} 폴링 루프도 가능합니다.
6. 중단된 실행은 POST /api/v1/activations/{id}/cancel로 정리하고, 잔액은 GET /api/v1/balance로 확인합니다.

웹훅 엔드포인트는 최대 다섯 개까지 등록할 수 있어서 스테이징과 CI 수신기를 따로 두기에 좋습니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산해 X-OTPRoute-Signature를 검증하고, 타임스탬프가 오래된 전달은 거부하세요. 파이프라인 구성은 CI 파이프라인의 SMS OTP 테스트를 참고하세요.

+370 번호와 리투아니아어 SMS는 어떻게 처리해야 하나요?

리투아니아 휴대폰 번호는 +370 국가 코드 뒤에 8자리가 오고 보통 6으로 시작합니다. 현지에서는 앞에 국내 접두번호(예전에는 8)를 붙여 적는 일이 많아서, 가입 폼에는 같은 번호가 여러 모양으로 들어옵니다. 저장하기 전에 모두 E.164로 정규화하세요. 공백을 지우고, 국내 접두번호를 제거하고, +370과 8자리를 저장합니다.

리투아니아어가 공용어이며 현지 브랜드의 메시지는 리투아니아어로 올 수 있고, 글로벌 앱은 계정 로케일을 따릅니다. ą, č, ė, š, ž 같은 문자는 SMS를 유니코드 인코딩으로 바꿔 세그먼트당 길이를 줄이므로, 코드가 고정된 문자 위치에 있다고 가정하지 마세요. 패턴으로 숫자를 추출하면 어떤 언어에도 대응할 수 있습니다. 이곳에서 테스트하는 팀은 대개 발트 출시, EU 결제 제품, 현지화 점검, 해외 리투아니아 고객을 지원하는 데스크를 위해서입니다.

운영 팀이 브라우저만으로 쓸 수 있는 방법이 있나요?

네, API를 건드릴 필요가 없습니다. 이메일 코드나 Google로 가입한 뒤 OTP Gateway를 열고, 앱을 선택하고, 국가를 리투아니아로 지정하고, 실시간 가격을 확인하세요. 주문을 확정하고 +370 번호를 앱에 복사하면 코드가 도착하는 즉시 대시보드에 나타납니다.

활성화는 20분 동안 유효합니다. 코드가 오지 않거나 그 전에 취소하면 지원 요청 없이도 전액이 지갑으로 돌아옵니다.

+370 번호로 코드가 오지 않는 이유와 해결 방법은 무엇인가요?

활성화가 조용하다면 원인은 대개 발신 쪽에 있습니다. 속도 제한, 사기 방지 규칙, 가상 회선에 대한 정책 등입니다. 합리적인 대응은 다음과 같습니다.

• 일부 앱은 SMS를 묶어서 보내므로 창이 끝날 때까지 기다리세요.
• 취소하고 잠시 후 다시 시도하거나, 제공되는 경우 같은 서비스의 다른 경로를 선택하세요.
• 테스트를 만들기 전에 앱이 가상 번호를 받아들이는지 확인하세요.
• 주문 엔드포인트를 연타하지 말고, 재시도 간격을 두고 분당 요청 300건 한도를 지키세요.

각 앱의 약관과 OTP Route의 이용 정책(Acceptable Use Policy)은 계속 적용됩니다.

리투아니아 번호를 장기 보유할 수 있나요? 결제는 어떻게 하나요?

셀프서비스 상품으로는 불가능합니다. Dedicated Numbers(전용 번호)는 미국과 캐나다에서만 판매되며 월 $1.95부터이고, 리투아니아에는 대시보드에 장기 회선이 없습니다. 프로젝트에 필요하다면 [email protected]으로 문의하세요. 현지 규정에 따라 달라지며 불가능할 수도 있습니다. 계속 로그인해야 하는 계정이라면 임시 번호 vs 전용 번호 글에서 장단점을 설명합니다.

결제는 선불 USD 지갑에서 사용한 만큼만 내는 방식이며, 카드 또는 USDT/USDC로 충전하고, 월 이용료는 없으며, 충전마다 PDF 인보이스가 발급됩니다. 비용을 쓰지 않고 연동 테스트를 하려면 요청 시 샌드박스 모드를 이용할 수 있습니다.

자주 묻는 질문

리투아니아에 살지 않아도 리투아니아 SMS OTP를 받을 수 있나요?

네. OTP Gateway가 어디서든 쓸 수 있는 +370 번호를 발급하고, 코드는 대시보드, 웹훅 또는 API 클라이언트로 전달됩니다.

API에서 리투아니아의 id는 무엇인가요?

가격 조회와 활성화 요청에서 국가 id로 lt를 사용하세요.

테스트용 +370 번호는 얼마인가요?

코드당 $0.20부터입니다. 정확한 금액은 앱에 따라 다르며 GET /api/v1/prices가 실시간으로 반환합니다.

+370 회선이 조용하면 지갑에서 그래도 차감되나요?

돌아옵니다. 20분 안에 아무것도 받지 못했거나 직접 취소한 활성화는 지갑으로 전액 환불됩니다.

리투아니아 번호를 국내 접두번호와 함께 저장해야 하나요?

아니요. 국내 접두번호는 제거하고 +370 뒤에 8자리 국내 번호를 붙여 저장하세요.

같은 리투아니아 번호로 다음 주에 두 번째 코드를 받을 수 있나요?

아니요. 일회용 번호는 코드 한 건용이며, 셀프서비스 장기 회선은 미국과 캐나다에만 있습니다.

CI 파이프라인에서 리투아니아 번호로 테스트할 수 있나요?

네. 작업에서 활성화 엔드포인트를 호출하고, 웹훅이나 폴링으로 코드를 받고, 일찍 끝난 실행은 취소하세요.

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