개발자와 QA 팀을 위한 모리타니 인증 코드

모리타니를 테스트하기 전에 팀이 알아야 할 점은?

모리타니는 마그레브와 서아프리카가 만나는 곳에 있고, 언어 구성에도 이것이 반영되어 있습니다. 아랍어가 공용어이며 일상에서 대부분 사용하는 말은 하사니야 아랍어이고, 비즈니스·은행·행정에서는 여전히 프랑스어가 흔히 쓰입니다. 풀라르어, 소닌케어, 월로프어도 인정된 국가 언어입니다.

제품 팀에게 이런 언어 구성은 실질적인 영향을 줍니다.

• 인터페이스에 오른쪽에서 왼쪽으로 쓰는 아랍어 레이아웃과 프랑스어 레이아웃이 모두 필요할 수 있으며, 인증 화면은 각각에서 동작해야 합니다.
• 사용자가 기기 언어를 아랍어와 프랑스어 사이에서 바꿀 수 있고, 이는 많은 SMS 템플릿의 문구를 바꿉니다.
• 누악쇼트와 누아디부의 고객은 대부분 모바일 우선이어서 전화번호 인증이 제품과의 첫 실질적 접점인 경우가 많습니다.

모리타니 인증 번호를 쓰면 현지 지인이 보내 준 스크린샷에 의존하지 않고 이런 상태를 직접 확인해 볼 수 있습니다.

+222 번호는 어떤 형식으로 정규화하나요?

모리타니는 여덟 자리 국내 번호와 트렁크 접두어 없는 폐쇄형 번호 체계를 사용하므로 제거할 앞자리 0이 없습니다. E.164 형식은 +222 뒤에 그 여덟 자리를 붙이면 됩니다.

그래도 정규화는 신중하게 하는 것이 좋습니다. 사용자는 공백, 대시, 국제 접두어 00222가 붙은 번호를 붙여 넣고, 일부 폼은 다른 나라의 습관대로 0을 자동으로 넣기도 합니다. 구분 기호를 제거하고 00222를 +222로 바꾸며, 여덟 자리 국내 번호가 아니면 거부하고 표준 문자열 하나로 저장하세요. 검증 라이브러리가 트렁크 0을 쓰는 이웃 나라 기준으로 설정되어 있다면, 출시 전에 테스트용 +222 번호로 시험해 보세요.

OTP Route는 모리타니 인증 코드를 처리할 수 있나요?

처리할 수 있습니다. 모리타니의 OTP Gateway 카탈로그는 현재 1,000개 넘는 서비스를 지원하며, 인기 라우트로는 WhatsApp, Telegram, imo, Facebook, Instagram, TikTok, Snapchat, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Signal, Viber, ChatGPT (OpenAI)가 있습니다.

재고와 OTP 라우팅은 하루 중 바뀌므로 이 목록은 스냅샷으로 보세요. 특정 시점에 특정 서비스가 가능한지에 대한 확정적인 답은 가격 엔드포인트나 대시보드에서 얻을 수 있습니다.

어떤 모리타니 OTP API 호출로 +222 코드를 받나요?

SMS 인증 API는 단순한 REST와 JSON입니다. https://otproute.com/api/v1로 보내는 모든 요청은 or_live_로 시작하는 Bearer 키로 인증합니다. 키는 개발자 콘솔에서 계정당 최대 10개까지 만들 수 있습니다. 모리타니의 국가 ID는 mr입니다.

먼저 GET /api/v1/balance를 확인하면 지갑이 비었을 때 작업이 바로 실패합니다. 그런 다음 GET /api/v1/prices?country=mr&service=<id>로 실시간 가격을 조회하고, {"service": "whatsapp", "country": "mr"} 같은 본문으로 POST /api/v1/activations를 호출해 주문하세요. 응답에는 액티베이션 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입니다. 이를 검증하고 오래된 타임스탬프는 버리세요. 연동 가이드와 API 문서에서 두 방식을 자세히 다룹니다.

코드 없이 쓸 수 있는 대시보드 경로가 있나요?

네. 로그인해서 OTP Gateway를 열고 모리타니와 서비스를 선택한 뒤 화면의 가격을 확인하고 확정하세요. +222 번호가 20분 타이머와 함께 나타나며, 앱이 SMS를 보내면 같은 화면에 코드가 표시됩니다. 비즈니스 계정을 한 번 인증하면 되고 연동은 필요 없는 지원 담당자나 그로스 매니저에게 적합합니다.

모리타니 SMS 코드가 오지 않는 이유는?

코드를 막는 요인은 여러 가지입니다. 서비스가 모리타니 트래픽을 느리게 라우팅하거나, 해당 플로우에서 가상 번호를 거부하거나, 번호가 이미 플랫폼에 의해 플래그 처리되었을 수 있습니다. 코드가 도착할 때만 요금을 내므로 빈 윈도우는 비용이 들지 않습니다. 20분이 지나거나 취소하면 돈이 지갑으로 돌아옵니다.

합리적인 복구 순서는 다음과 같습니다.

1. 1분 만에 취소하지 말고 윈도우가 끝나도록 둡니다.
2. 나중에 다시 시도하거나, 테스트가 허용한다면 다른 서비스 라우트를 써 봅니다.
3. 반복해서 계속 주문하지 마세요. 거의 도움이 되지 않고 요청 한도만 소모합니다.

특정 서비스의 +222 재고가 부족할 때는, 모리타니 번호에 의존하지 않는 일반 테스트라면 세네갈 같은 인근 라우트로 대신할 수 있습니다.

장기 회선, 결제, 샌드박스 접근은 어떻게 되나요?

모리타니에는 셀프서비스 장기 번호가 없습니다. 갱신되는 동안 계속 보유하는 Dedicated Numbers는 미국과 캐나다에서만 판매되며 월 $1.95부터 시작합니다($1.95/month). 비즈니스상 지속적인 +222 회선이 필요하다면 [email protected]으로 문의하세요. 가능 여부는 현지 규정에 따라 달라집니다.

결제는 요금제와 월 요금이 없는 선불 USD 지갑으로 이루어지며, 카드 또는 USDT/USDC로 충전하고 충전마다 PDF 인보이스가 이메일로 발송됩니다. 개발자는 개발 계정에 샌드박스 모드를 요청해 연동을 만드는 동안 시뮬레이션된 번호와 코드를 받을 수 있으며, 실제 테스트를 시작하기 전까지 지갑은 그대로 유지됩니다. 현재 요금은 요금 페이지에 있습니다.

자주 묻는 질문

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

네. +222 번호는 온라인으로 주문하고 코드는 대시보드에 나타나거나 API 클라이언트로 전달되므로, 팀은 어디서든 일할 수 있습니다.

모리타니 번호에도 트렁크 0이 있나요?

아니요. 국내 번호는 트렁크 접두어 없는 여덟 자리이므로 E.164 형식은 +222에 그 숫자를 붙인 것입니다.

인증 SMS는 어떤 언어로 오나요?

발신자와 계정 설정에 따라 다릅니다. 많은 서비스는 아랍어나 프랑스어, 일부 글로벌 플랫폼은 영어일 수 있으므로 숫자를 기준으로 코드를 추출하세요.

+222 액티베이션은 얼마나 오래 열려 있나요?

20분입니다. 그 시간 안에 코드가 도착하지 않으면 액티베이션이 만료되고 전액이 지갑으로 환불됩니다.

모리타니 OTP API를 가장 저렴하게 체험하는 방법은?

개발 계정에 샌드박스 모드를 요청해 시뮬레이션 데이터로 플로우를 테스트하세요. 실제 주문은 코드당 $0.20 이상이며 정확한 가격은 실시간으로 반환됩니다.

OTP Route로 한 서비스에서 계정을 많이 만들 수 있나요?

아니요. OTP Route는 자사 제품 테스트와 합법적인 비즈니스 계정 운영을 위한 것입니다. +222 번호의 모든 주문에는 서비스 자체의 약관과 OTP Route 이용 정책(Acceptable Use Policy)이 적용됩니다.

모리타니 전용 번호를 제공하나요?

셀프서비스로는 제공하지 않습니다. 장기 Dedicated Numbers는 미국과 캐나다만 대상이며, 모리타니는 [email protected]으로 문의할 수 있습니다.

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