팀에 +258 SIM이 없을 때 모잠비크 가입 흐름 테스트하기

모잠비크 출시가 전화번호 인증에서 막혔습니다. 어디서부터 시작해야 할까요?

흔한 상황입니다. 앱은 번역이 끝났고 결제 화면도 준비됐는데, 마지막 남은 티켓에는 모잠비크 고객이 실제로 가입을 마칠 수 있는지 누군가 확인해야 한다고 적혀 있습니다. +258 SIM을 가진 사람이 없고, 로밍은 준비하는 데 시간이 걸리며, 동료의 개인 휴대폰은 테스트 픽스처가 아닙니다.

OTP Gateway는 이런 의존성을 없애 줍니다. 특정 서비스용으로 +258 번호를 요청해 테스트 중인 화면에서 한 번 사용하면, 들어온 코드가 돌아옵니다. QA 및 테스트 자동화, 출시 체크리스트, 그리고 누구의 휴대폰도 빌리지 않고 고객 제보를 재현해야 하는 지원팀에 적합합니다.

+258 번호는 어떻게 생겼고, 어떻게 저장해야 할까요?

모잠비크의 국가 코드는 +258이며 국내 번호는 아홉 자리이고 제거할 트렁크 0이 없으므로, 국내 형식과 국제 형식의 차이는 국가 코드뿐입니다. 휴대폰 번호는 8로 시작합니다. 실무적으로는 다음과 같습니다.

• E.164 형식인 +258 뒤에 아홉 자리를 붙인 값을 저장하고, 표시용 서식은 별도로 적용합니다.
• 다른 시장의 습관대로 앞에 0을 붙인 입력은 거부하거나, 검증 전에 조용히 제거하세요.
• 현지에서만 전화를 거는 사용자라도 국가 코드는 유지하세요. SMS 발신자와 웹훅 소비자 모두 필요로 합니다.

공용어는 포르투갈어이므로 서비스와 계정 로케일에 따라 메시지가 포르투갈어나 영어로 올 수 있습니다. 자체 템플릿이 포르투갈어라면 ç, ã 같은 악센트 문자가 어떻게 표시되는지 확인하세요. 비ASCII 텍스트는 SMS 인코딩을 바꾸어 메시지를 더 많은 조각으로 나눌 수 있습니다.

어떤 서비스가 모잠비크 인증 번호로 코드를 보낼 수 있나요?

전체 서비스 기준으로 모잠비크의 스냅샷에는 1,600개가 넘는 서비스가 있습니다. 자주 요청되는 서비스로는 WhatsApp, Telegram, Facebook, Instagram, Google(Gmail & YouTube), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, Netflix, Airbnb, Discord, Claude 등이 있습니다.

가용성은 고정이 아니라 실시간입니다. 같은 서비스도 어느 시간에는 재고가 충분하다가 나중에는 부족해질 수 있습니다. 테스트 계획에 목록을 하드코딩하지 말고 주문 전마다 API나 대시보드에서 읽어 오세요.

모잠비크 OTP API 흐름은 처음부터 끝까지 어떻게 동작하나요?

개발자에게 연동은 https://otproute.com/api/v1에 대한 짧은 일련의 호출이며, or_live_로 시작하는 Bearer 키로 서명합니다.

1. GET /api/v1/countries와 GET /api/v1/services에서 모잠비크 id(mz)와 서비스 id를 확인합니다.
2. GET /api/v1/prices?country=mz&service=<id>로 실시간 가격과 번호 보유 여부를 확인합니다.
3. {"service": "telegram", "country": "mz"}와 함께 POST /api/v1/activations를 보내고, 반환된 활성화 id와 번호를 보관합니다.
4. activation.sms_received가 엔드포인트에 도착하면 코드를 수집하거나, 몇 초마다 GET /api/v1/activations/{id}를 조회합니다.
5. 테스트를 중단하면 POST /api/v1/activations/{id}/cancel을 호출합니다.

웹훅 요청에는 엔드포인트 시크릿으로 서명한 <t>.<raw body>의 HMAC-SHA256인 X-OTPRoute-Signature 헤더(t=<unix>,v1=<hex>)가 포함됩니다. 이를 검증하고 오래된 타임스탬프는 거부하며, 핸들러는 활성화 id 기준으로 멱등하게 만드세요. 키는 개발자 콘솔에서 관리하며(최대 10개, 웹훅 엔드포인트 5개), 요청 제한은 분당 300건입니다. OTP API 연동 가이드에서 오류 처리를 포함한 동일한 SMS 인증 API 흐름을 볼 수 있습니다.

비개발자도 대시보드에서 +258 번호를 주문할 수 있나요?

네, API와 완전히 같은 OTP 라우팅을 사용합니다. 이메일과 6자리 코드(또는 Google)로 계정을 만든 뒤 자금을 충전하고 OTP Gateway를 열어 모잠비크와 서비스를 선택한 다음 표시된 가격을 확인하세요. 번호가 바로 나타나며, 앱에 붙여 넣으면 코드가 도착할 때 같은 페이지에 표시됩니다. 계정 자체에는 인증 앱을 이용한 2단계 로그인을 사용할 수 있습니다.

코드가 오지 않은 이유는 무엇이고, 다음에 무엇을 시도해야 할까요?

모든 활성화에는 20분의 제한 시간이 있습니다. SMS 없이 시간이 종료되거나 취소하면 전체 금액이 자동으로 지갑에 환불되며, 코드가 도착했을 때만 비용을 냅니다.

실행할 때마다 결과가 비어 있다면 다음을 시도해 보세요.

• 시간을 충분히 주세요. 코드가 얼마나 빨리 도착하는지는 서비스와 라우트에 따라 다릅니다.
• 해당 서비스가 가상 번호를 허용하는지 확인하세요. 아예 거부하는 서비스도 있습니다.
• 잠시 쉬었다가 다시 시도하거나, 테스트에 꼭 모잠비크 번호가 필요하지 않다면 다른 라우트를 고르세요.
• 주문 엔드포인트를 몰아치지 말고 시도 간격을 두며, 실패를 비교할 수 있도록 각 활성화 id를 기록하세요.

모잠비크의 영구 회선이 있나요? 요금은 어떻게 청구되나요?

모잠비크에는 셀프서비스로 이용할 수 있는 장기 번호가 없습니다. 전용 회선은 미국과 캐나다에서만 월 $1.95부터 판매됩니다. 모잠비크의 지속 회선이 필요한 팀은 [email protected]으로 이메일을 보내 문의할 수 있지만, 가능 여부는 현지 규정에 달려 있고 불가능할 수도 있습니다.

결제는 하나의 선불 USD 지갑으로 쓴 만큼 지불하며 구독은 없습니다. 카드와 USDT/USDC 스테이블코인 충전이 모두 가능하고, 각각 이메일로 PDF 인보이스가 발송됩니다. 개발과 디버깅을 위해 요청하면 개발 계정을 샌드박스로 옮길 수 있어, 비용 없이 시뮬레이션 번호와 코드로 연동 코드를 테스트할 수 있습니다. 요금이 표시되는 방식은 요금제를 참고하세요.

자주 묻는 질문

모잠비크 밖에서도 모잠비크 가입 흐름을 테스트할 수 있나요?

네. +258 번호는 OTP Gateway에서 제공되므로 팀이 어디서든 테스트를 실행하고 대시보드나 API로 코드를 읽을 수 있습니다.

모잠비크의 API 국가 id는 무엇인가요?

GET /api/v1/prices와 POST /api/v1/activations의 본문에 mz를 사용하세요.

모잠비크 번호에는 앞의 0이 필요한가요?

아니요. 모잠비크에는 국내 트렁크 접두사가 없으므로 저장 형식은 +258 뒤에 아홉 자리를 붙인 값입니다.

모잠비크 SMS OTP를 받는 데 비용이 얼마인가요?

코드당 $0.20부터 시작하며, 각 서비스의 정확한 가격은 API가 실시간으로 반환하고 주문 전에 대시보드에도 표시됩니다.

다음 주에도 +258 테스트 번호로 로그인할 수 있나요?

작동하지 않는다고 생각하는 편이 좋습니다. OTP Gateway 번호는 코드 한 건을 위한 것이며, 장기 전용 번호는 미국과 캐나다에서만 제공됩니다.

이 번호로 무엇을 인증할 수 있는지에 대한 규칙이 있나요?

네. 본인의 합법적인 제품과 계정을 테스트하고 운영하는 용도로만 사용하고, 각 서비스의 약관을 따르며, OTP Route의 이용 정책(Acceptable Use Policy)을 지키세요.

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