팀이 테스트 매트릭스에 몬테네그로를 추가하려는 이유는 무엇일까요?
몬테네그로는 아드리아해에 면한 작은 시장이지만 많은 로드맵에 등장합니다. 서부 발칸 지역에 진출하는 제품은 보통 세르비아, 보스니아 헤르체고비나, 크로아티아와 함께 출시하는데, 언어가 서로 매우 가까워 한 번의 현지화 작업으로 여러 나라를 커버할 수 있기 때문입니다. 여행, 예약, 차량 호출 앱은 해안 휴양 시즌을 중요하게 여기고, 해외에 몬테네그로 고객을 둔 회사는 +382 사용자가 가입 과정에서 무엇을 경험하는지 확인하고 싶어 합니다.
몬테네그로어가 공용어이지만 세르비아어, 보스니아어, 알바니아어, 크로아티아어도 공식적으로 사용되며, 문자는 라틴 문자와 키릴 문자가 모두 나타날 수 있습니다. 몬테네그로 인증 번호가 있으면 실제 사용자가 접하기 전에 QA에서 전화번호 단계가 올바르게 동작하는지 확인할 수 있습니다.
+382 휴대폰 번호는 어떻게 표기하고, 어떻게 저장해야 할까요?
국내에서 몬테네그로 번호에는 트렁크 접두사 0이 붙으며, 휴대폰 번호는 06x 뒤에 여섯 자리가 더 이어지는 형식으로 다이얼합니다. 0 뒤의 국내 번호는 여덟 자리입니다. E.164 형식으로 만들려면 0을 빼고 국가 번호를 앞에 붙이면 되므로, 국내 번호 06x xxx xxx는 +3826x xxx xxx(공백 없이 저장)가 됩니다.
자체 시스템을 위한 실무 규칙은 다음과 같습니다.
- 0이 있든 없든 입력을 받아들이고, 저장하기 전에 정규화합니다.
- 표준 형식인
+382…문자열만 저장하고, 표시용 서식은 화면 가장자리에서 적용합니다. - 번호 대역은 재배정될 수 있고 사용자가 통신사를 옮길 수도 있으므로, 휴대폰 접두사를 유효성 검사 기준으로 하드코딩하지 마세요.
몬테네그로 OTP 메시지는 어떤 언어로 올까요?
대부분의 글로벌 앱은 영어 또는 사용자가 앱에서 고른 언어로 코드를 보냅니다. 서비스가 해당 지역에 맞게 현지화한 경우에는 라틴 문자 몬테네그로어나 세르비아어가 오며, 드물게 키릴 문자도 오는데 이는 유니코드 SMS로 전송됩니다. 발신 측의 템플릿이 바뀌어도 통과 중인 테스트가 깨지지 않도록, 추출 로직은 고정된 문구가 아니라 숫자열을 찾아야 합니다.
`me` 라우트에서는 어떤 서비스를 이용할 수 있나요?
현재 스냅샷 기준으로 몬테네그로에는 1,400개가 넘는 서비스가 있습니다. 자주 쓰이는 서비스로는 서부 발칸 전역에서 널리 쓰이는 Viber를 비롯해 WhatsApp, Telegram, Instagram, Facebook, Google(Gmail & YouTube), TikTok, Snapchat, Signal, LinkedIn, Discord, Amazon, Airbnb, Uber 등이 있습니다.
특정 시점에 제공되는 서비스는 통신사 파트너에 따라 정해지고 하루 중에도 바뀌므로, 오래 캐시해 두지 말고 GET /api/v1/services에서 최신 목록을 가져오거나 대시보드에서 확인하세요.
SMS 인증 API로 몬테네그로 OTP를 받으려면 어떻게 하나요?
개발자 콘솔에서 Bearer 키(접두사 or_live_)를 만든 뒤 다음 순서로 진행합니다.
GET /api/v1/prices?country=me&service=<id>로 현재 가격을 확인합니다.{"service": "viber", "country": "me"}같은 본문과 함께POST /api/v1/activations로 주문합니다.- 웹훅으로
activation.sms_received이벤트를 받거나, 적당한 간격으로GET /api/v1/activations/{id}를 폴링합니다. - 사용하지 않는 주문은
POST /api/v1/activations/{id}/cancel로 취소합니다.
모든 전송에서 X-OTPRoute-Signature 헤더를 확인하세요. 엔드포인트 시크릿으로 타임스탬프, 점, 원본 본문을 이어 붙인 값에 HMAC-SHA256을 계산해 비교하고, 오래된 타임스탬프는 버립니다. 재전송된 요청이 한 번만 처리되도록 핸들러는 활성화 id를 기준으로 구성하세요. 자세한 내용은 HMAC 웹훅 가이드와 API 문서에 있으며, 계정당 키는 최대 10개, 웹훅 엔드포인트는 5개, 분당 요청은 300건까지 가능합니다.
대시보드에서는 어떻게 하고, 코드가 오지 않으면 어떻게 하나요?
개발자가 아니어도 대시보드에서 몬테네그로와 서비스를 고르고, 가격을 확인한 뒤 주문하면 테스트용 +382 번호를 받을 수 있으며, 코드는 그 번호 옆에 표시됩니다.
각 활성화는 20분간 유지됩니다. 코드가 도착한 경우에만 비용을 내며, 코드 없이 시간이 만료되거나 취소하면 전액이 지갑으로 돌아갑니다. 코드가 보이지 않으면 제한 시간을 끝까지 기다리고, 해당 서비스가 가상 번호를 허용하는지 확인한 다음, 빠르게 반복 주문하지 말고 나중에 다시 시도하거나 다른 서비스 경로로 시도하세요.
몬테네그로 번호를 계속 보유할 수 있나요? 결제는 어떻게 이루어지나요?
셀프서비스로 이용할 수 있는 장기 +382 회선은 없습니다. 전용 번호는 미국과 캐나다에서만 제공되며 월 $1.95부터 시작합니다. 몬테네그로의 지속 번호가 필요하면 [email protected]으로 이메일을 보내 문의할 수 있지만, 가능 여부는 현지 규정에 따라 달라집니다.
OTP Route는 구독 없이 선불 USD 지갑으로 운영됩니다. 카드 또는 USDT/USDC로 충전할 수 있고, 충전할 때마다 PDF 인보이스를 받습니다. 개발 계정에 샌드박스 모드를 요청하면 시뮬레이션 번호로 전체 과정을 테스트할 수 있습니다. 번호는 본인의 제품과 계정에만 사용하고, 각 서비스의 약관을 지키며, 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요.
자주 묻는 질문
몬테네그로 SIM 카드 없이 +382 코드를 받을 수 있나요?
네. OTP Gateway가 1회 인증용 몬테네그로 번호를 발급하며, 코드는 대시보드에 표시되거나 API를 통해 시스템으로 전달됩니다.
몬테네그로 번호를 맨 앞의 0과 함께 저장해야 하나요?
아니요. 0은 국내 트렁크 접두사이므로 +382로 시작하는 E.164 형식으로 저장하고, 필요할 때만 국내 표시용으로 0을 다시 붙이세요.
API에서 몬테네그로의 국가 id는 무엇인가요?
me이며, 가격 조회 쿼리와 활성화 요청 본문에 사용합니다.
몬테네그로 인증 번호는 비용이 얼마인가요?
코드당 $0.20부터 시작하며, 특정 몬테네그로 서비스의 가격은 가격 엔드포인트에서 반환되므로 주문 전에 스크립트로 확인할 수 있습니다.
Viber 등 다른 앱이 아무것도 보내지 않으면 +382 주문은 환불되나요?
SMS 없이 20분 제한 시간이 끝나거나 직접 취소하는 즉시 전액이 지갑으로 환불됩니다.
몬테네그로 번호로 키릴 문자 OTP 메시지도 테스트할 수 있나요?
테스트하는 서비스가 키릴 문자로 보내기로 한 경우에만 가능하며, 내용은 발신자가 정합니다. 어떤 문자 체계에서든 숫자를 추출하도록 파서를 만드세요.
CI 파이프라인 안에서도 몬테네그로 OTP 라우팅을 사용할 수 있나요?
네. 많은 팀이 테스트 러너에서 API로 주문합니다. 불안정한 재시도를 피하는 방법은 CI에서의 OTP 테스트를 참고하세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.