팀들은 왜 모나코 번호로 테스트하나요?
모나코는 작지만 프라이빗 뱅킹, 호스피탈리티, 요트 서비스, 국제 행사 분야의 기업에게는 규모에 비해 존재감이 큽니다. 그곳의 고객은 제품이 +377 번호를 불평 없이 받아주기를 기대하는데, 놀랄 만큼 많은 양식이 리비에라 근처에 사는 사람이면 누구나 프랑스 +33 회선이 있다고 가정합니다.
이런 가정은 실제 지원 티켓을 만듭니다. 모나코에서 일하는 많은 사람들은 국경 건너 프랑스에 살며 프랑스 번호를 쓰고, 주민들은 모나코 번호를 가지고 있어서 한 고객층에 두 국가 번호가 섞여 있습니다. 테스트용 +377 번호로 주문하는 모나코 인증번호를 쓰면 QA 엔지니어가 국가 선택기, 검증 규칙, SMS 템플릿이 이 공국을 프랑스의 교외가 아니라 독립된 국가로 다루는지 증명할 수 있습니다.
양식은 +377 번호를 어떻게 저장하고 검증해야 하나요?
모나코는 프랑스와 별개의 자체 국가 호출 번호를 가지며, 국내 번호는 대부분의 유럽 국가보다 짧습니다. 국제 형식에는 국내 접두 번호가 없으며 번호는 +377 바로 뒤에 가입자 번호가 이어집니다.
엔지니어를 위한 몇 가지 실무 규칙은 다음과 같습니다.
- 번호는 E.164(
+377…)로 보관하고, 보기 좋은 묶음 표시는 화면에 보여 줄 때만 적용하세요. - 프랑스식 다이얼에 익숙한 사용자는 습관적으로 앞에 0을 입력하기도 합니다. 검증을 실패시키지 말고 정규화 단계에서 제거하세요.
- +33 접두사와 모나코 우편 주소만으로 국가를 추정하지 마세요. 전화 국가와 청구 국가는 독립된 필드로 유지하세요.
- 직접 작성한 길이 검사 대신 유지 관리되는 전화번호 라이브러리를 쓰세요. 프랑스 길이를 하드코딩하면 올바른 모나코 번호를 거부합니다.
공용어는 프랑스어이므로 인증 문자는 보통 프랑스어로 도착하지만, 이탈리아어와 영어도 현지에서 널리 쓰이고 계정 로케일이 영어로 설정되어 있으면 영어로 보내는 앱도 많습니다. 온보딩이 현지화되어 있다면 둘 다 테스트하세요.
모나코 경로에서 인증할 수 있는 서비스는 무엇인가요?
현재 모나코 경로에서는 1,300개가 넘는 서비스를 이용할 수 있습니다. 오늘 스냅샷에서 인기 있는 항목으로는 Instagram, Airbnb, Telegram, Claude, WhatsApp, Facebook, Google (Gmail & YouTube), Uber, Netflix, eBay, LinkedIn, X (Twitter) 등이 있습니다.
커버리지는 고정되어 있지 않습니다. 통신사 파트너가 하루 중에도 용량을 돌려 쓰기 때문에, 아침에 보이던 서비스가 오후에는 일시 중단될 수 있습니다. 제대로 된 OTP 라우팅은 캐시된 목록에 의존하지 않고 주문 시점의 가용성을 읽으며, SMS 인증 API는 가격 엔드포인트로 바로 그것을 제공합니다.
모나코 OTP API 호출 순서는 어떻게 되나요?
요청은 https://otproute.com/api/v1로 보내며 Developer 콘솔에서 생성한 or_live_로 시작하는 Bearer 키로 인증합니다. 모나코의 국가 ID는 mc입니다.
- 이름을 ID에 매핑하기 위해
GET /api/v1/services와GET /api/v1/countries를 가끔 호출합니다. - 주문하기 전에
GET /api/v1/prices?country=mc&service=<id>를 호출합니다. 실시간 가격과 해당 조합을 처리할 수 있는지 응답합니다. - 예를 들어
{"service": "airbnb", "country": "mc"}로POST /api/v1/activations를 호출해 주문을 만듭니다. 반환된 activation id를 보관하세요. - 앱에 +377 번호를 입력하고 웹훅에서
activation.sms_received를 기다리거나GET /api/v1/activations/{id}를 폴링합니다. - 정리 단계에서는 아직 대기 중인 항목에
POST /api/v1/activations/{id}/cancel을 호출합니다.
각 웹훅의 X-OTPRoute-Signature 헤더는 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 다시 계산해 검증하고, 오래된 타임스탬프는 거부하세요. 계정마다 웹훅 엔드포인트 5개를 등록하고 분당 최대 300건의 요청을 보낼 수 있어 모나코 병렬 실행에도 여유가 있습니다. 연동 가이드가 오류 처리를 포함해 같은 단계를 안내합니다.
운영 직원을 위한 코딩 없는 방법이 있나요?
API를 만지고 싶지 않은 사람을 위해 대시보드가 같은 경로를 제공합니다. OTP Gateway에서 모나코를 고르고 서비스를 선택한 뒤 표시된 가격을 확인하고 확정하세요. +377 번호가 활성화 카드에 표시되며, 로그인 또는 가입 화면에 붙여 넣으면 SMS가 도착했을 때 그 카드에 코드가 나타납니다.
시간은 20분입니다. 제때 코드가 도착하지 않거나 주문을 취소하면 지원 요청 없이 전액이 지갑으로 환불됩니다.
모나코 코드가 도착하지 않으면 어떻게 하나요?
작은 시장은 경로가 적기 때문에 큰 나라보다 인내심과 대체 계획이 더 중요합니다.
- 취소하기 전에 주문에 전체 시간을 주세요.
- 서비스가 해당 작업에 가상 번호를 받아주는지 확인하세요. 아예 거부하는 곳도 있습니다.
- 반복 주문 대신 잠시 후 다시 시도하세요. 연달아 주문하면 서비스 측에서 속도 제한이 걸릴 수 있습니다.
- 테스트에 리비에라 지역 번호만 필요하다면 그 순간에는 프랑스 경로나 이탈리아 경로의 용량이 더 넉넉할 수 있습니다.
모든 테스트는 서비스의 약관 안에서 진행하세요. OTP Route는 자사 제품과 정당한 비즈니스 계정을 검증하기 위한 것이며, Acceptable Use Policy가 적용됩니다.
모나코 번호를 장기간 보유할 수 있나요? 요금은 어떻게 처리되나요?
셀프서비스 장기 +377 회선은 없습니다. 갱신되는 동안 보유하며 수신 SMS, 발신 SMS, 브라우저 통화를 지원하는 Dedicated Virtual Numbers는 미국과 캐나다 전용 상품으로 월 $1.95부터입니다. 모나코 회선이 필요하다면 [email protected]으로 이메일을 보내 주세요. 팀이 현지 규정상 가능한 것이 있는지 알려 드리지만 어떤 약속도 하지 않습니다.
모나코 주문도 다른 모든 주문과 같은 선불 USD 지갑에서 차감되며 월 요금이나 고를 요금제가 없습니다. 카드나 USDT/USDC로 충전하고 충전마다 이메일로 PDF 인보이스를 받으세요. 연동 작업 중에는 요청 시 개발용 계정을 샌드박스로 전환해 시뮬레이션된 번호와 코드로 무료로 종단 간 테스트를 할 수 있습니다. 자세한 내용은 요금 페이지에 있습니다.
자주 묻는 질문
모나코 전화번호는 프랑스 번호와 같은가요?
아니요. 모나코는 자체 +377 코드를 쓰므로 검증 로직은 프랑스의 +33과 별개로 다뤄야 합니다.
OTP Route API에서 모나코의 국가 ID는 무엇인가요?
가격 조회와 활성화 요청 본문에 mc를 사용하세요.
유럽 출시를 테스트하기 위한 +377 번호를 받을 수 있나요?
네. OTP Gateway는 단일 인증용 일회용 +377 번호를 발급하며, 대시보드나 API에서 주문할 수 있습니다.
모나코 코드를 받을 수 있는 시간은 얼마나 되나요?
각 활성화는 20분 동안 열려 있으며, 아무것도 도착하지 않으면 요금이 자동으로 환불됩니다.
모나코 번호에도 국내 접두 번호가 있나요?
국제 형식에는 없습니다. 사용자가 입력한 앞자리 0은 제거하고 번호를 +377에 가입자 번호를 붙인 형태로 저장하세요.
모나코 서비스의 인증 SMS는 어떤 언어로 오나요?
대개 프랑스어지만 앱과 계정 언어 설정에 따라 다르므로 영어나 이탈리아어 문자도 가능합니다.
실제 자금을 쓰지 않고 모나코 테스트를 실행할 수 있나요?
개발용 계정에 샌드박스 모드를 요청하세요. 연동 테스트용으로 시뮬레이션된 번호와 코드가 반환됩니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.