누가, 왜 말라가시 번호로 테스트하거나 운영하나요?
마다가스카르는 프랑스어를 쓰는 시장이며 말라가시어가 국어이고, 두 언어 모두 공용어입니다. 이런 이중 언어 환경 덕분에 아프리카 사용자에게 프랑스어 문구를 제공하는 제품의 점검 지점으로 유용합니다. 파리에서는 잘 읽히는 가입 화면도 +261 번호 형식이나 모바일 우선 브라우저에서는 깨질 수 있기 때문입니다.
마다가스카르 인증 번호가 필요한 팀은 대체로 다음과 같습니다.
- 안타나나리보에서 메시징·소셜 플랫폼의 비즈니스 계정을 운영하며 직원의 개인 휴대폰을 계정에서 분리하려는 프랑스어권 지원·BPO 운영 팀.
- 인도양과 프랑스어권 아프리카로 확장하면서 마케팅을 시작하기 전에 온보딩이 동작하는지 확인해야 하는 제품 팀.
- 고객이 해외에 살지만 이미 가지고 있는 말라가시 번호로 가입하는 디아스포라 대상 앱.
모든 경우에 목표는 같습니다. 목(mock)을 믿는 대신 실제 +261 경로로 실제 메시지가 도착하는 것을 확인하는 것입니다.
데이터베이스에서 +261 번호는 어떤 모양인가요?
국내에서 말라가시 휴대폰 번호는 국내 접두번호 0과 10자리로 적으며 보통 03으로 시작합니다. 국제 형식에서는 그 0이 사라지고 +261 뒤에 9자리가 붙습니다.
사용자 테이블에 적용할 실무 규칙은 다음과 같습니다.
- E.164로 변환할 때 국내 접두번호 0을 제거하세요.
+2610…은 언제나 잘못된 형식입니다. - 사용자가 공백으로 묶어 입력하는 익숙한 형식을 허용하되, 숫자와 맨 앞의 플러스 기호 외에는 모두 제거하세요.
- 휴대폰의 경우 국내 번호가 정확히 9자리 남는지 확인하세요.
글로벌 앱의 메시지는 보통 계정 언어에 따라 프랑스어나 영어로 오며, 말라가시어 문자는 드뭅니다. 암호를 추출할 때는 번역된 단어가 아니라 숫자를 매칭하세요.
마다가스카르 경로에서는 어떤 서비스가 동작하나요?
현재 1,000개가 넘는 서비스가 마다가스카르 번호로 코드를 전달할 수 있습니다. 자주 쓰이는 서비스는 WhatsApp, Facebook, Telegram, Google (Gmail & YouTube), TikTok, Instagram, Microsoft & Outlook, LinkedIn, Viber, imo, Signal, ChatGPT (OpenAI) 등입니다.
이 구성은 하루 중에도 바뀌므로, 어제 목록이 그대로일 것이라고 가정하지 말고 테스트 실행 전에 GET /api/v1/services에서 실시간으로 읽으세요.
+261 코드를 내 시스템으로 가져오려면 어떻게 하나요?
https://otproute.com/api/v1의 REST API는 or_live_로 시작하는 Bearer 키를 사용합니다. 계정당 키 10개와 웹훅 엔드포인트 5개를 보유할 수 있으며, 상한은 분당 요청 300건입니다.
마다가스카르의 국가 id는 mg입니다. 깔끔한 순서는 다음과 같습니다.
GET /api/v1/prices?country=mg&service=telegram으로 가격을 가져옵니다.POST /api/v1/activations에{"service": "telegram", "country": "mg"}를 보내 활성화를 생성합니다.- 반환된 번호를 테스트 중인 제품에 입력합니다.
- 엔드포인트로
activation.sms_received를 받거나, 폴링을 선호하면GET /api/v1/activations/{id}를 호출합니다. - 시나리오를 중단하면
POST /api/v1/activations/{id}/cancel로 종료하고 보류 금액을 환불받습니다.
신뢰하기 전에 모든 웹훅을 검증하세요. X-OTPRoute-Signature 헤더에는 t=<unix>,v1=<hex>가 들어 있고, v1은 엔드포인트 시크릿으로 계산한 <t>.<raw body>의 HMAC-SHA256과 같아야 합니다. 타임스탬프가 오래된 요청은 거부하고, 반복 전달이 문제를 일으키지 않도록 활성화 id를 키로 기록하세요. 전체 핸들러는 웹훅 캡처 가이드에서 확인할 수 있습니다.
비개발 직원을 위한 대시보드 경로가 있나요?
있습니다. 운영 책임자는 로그인해서 OTP Gateway를 열고, 마다가스카르와 서비스를 선택하고, 표시된 가격을 확인한 뒤 주문하면 됩니다. +261 번호는 활성화 카드에 나타나고 수신된 문자도 같은 카드에 표시됩니다. 터미널도, 키 관리도 필요 없으며, 20분 창은 API와 똑같이 동작합니다.
마다가스카르 코드가 오지 않았습니다. 이제 어떻게 하나요?
대부분의 실패는 설정이 아니라 발신 서비스에서 비롯됩니다. 에스컬레이션하기 전에 다음을 확인하세요.
- 활성화에 20분 전체를 주세요. 재전송이 늦게 올 수 있습니다.
- 서비스가 가상 번호를 받아들이는지 확인하세요. 일부는 거부하며, 응답 없는 활성화가 스스로 환불되는 이유가 이것입니다.
- 잠시 후에 다시 시도하거나, 같은 플로우를 검증하는 다른 서비스 경로로 바꾸세요.
- 새 주문을 짧은 간격으로 연달아 보내지 마세요. 전달 성공률은 오르지 않고 속도 제한만 낭비됩니다.
창이 닫히기 전에 SMS가 오지 않거나 취소하면, 티켓 없이도 전액이 지갑으로 돌아옵니다.
장기 회선과 사용 요금 결제
OTP Route에는 마다가스카르 셀프서비스 장기 번호가 없습니다. 당사의 Dedicated Numbers(전용 번호)는 미국과 캐나다만 지원하며 월 $1.95부터입니다. 오래 쓸 +261 회선이 필요하면 [email protected]으로 이메일을 보내세요. 현지 규정상 가능한지 팀이 알려 드리며, 약속은 아닙니다. 어떤 상품이 어떤 용도에 맞는지는 임시 번호 vs 전용 번호 글에서 설명합니다.
결제는 하나의 선불 USD 지갑으로 이루어집니다. 구독도 선택할 등급도 없으며, 카드 또는 USDT/USDC로 충전하고 충전마다 PDF 인보이스를 이메일로 받습니다. 조합별 현재 요금은 요금제 페이지에서 볼 수 있습니다. 개발자는 샌드박스 모드도 요청할 수 있으며, 모의 번호와 코드가 제공되어 실제 비용을 쓰기 전에 연동을 검증할 수 있습니다.
자주 묻는 질문
현지 SIM 없이 내 앱의 말라가시 가입 플로우를 확인할 수 있나요?
네. OTP Gateway에서 서비스용 +261 번호를 주문하면 코드가 대시보드에 나타나거나 웹훅으로 전달됩니다. 도착한 경우에만 비용을 냅니다.
OTP Route는 마다가스카르에 어떤 국가 id를 사용하나요?
id는 mg이며 POST /api/v1/activations 같은 호출에서 사용합니다.
말라가시 휴대폰 번호를 저장할 때 앞의 0을 유지해야 하나요?
아니요. 국내 접두번호 0은 빼고 +261과 9자리를 저장하세요. 공백 포맷은 표시용으로만 적용하세요.
암호 문자는 어떤 언어로 오나요?
발신자와 계정 설정에 따라 다릅니다. 보통 프랑스어와 영어이므로 고정된 문구가 아니라 숫자 코드를 파싱하세요.
테스트용 +261 번호를 나중에 다시 쓸 수 있나요?
각 활성화는 20분 안에 코드 한 건을 받도록 만들어졌습니다. 시간이 지나도 다시 로그인해야 하는 계정에는 다른 방식이 필요하며, 셀프서비스 장기 번호는 미국과 캐나다에만 있습니다.
사용 규칙이 있나요?
네. 각 서비스의 약관과 OTP Route 이용 정책(Acceptable Use Policy)을 지키고, 번호는 자사 제품을 테스트하거나 실제 비즈니스 계정을 운영하는 데만 사용하세요. 실제 개인 또는 사업체당 계정은 하나입니다.
마다가스카르 OTP 라우팅에 별도 계약이 필요한가요?
아니요. 같은 지갑과 SMS 인증 API가 모든 국가에서 동작하며, 이메일 코드나 Google 로그인으로 가입할 수 있습니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.