코모로(+269) 인증번호 수신 체크리스트

현지 SIM 없이도 코모로 SMS 코드를 받을 수 있나요?

가능합니다. 테스터가 코드 하나를 읽자고 모로니로 SIM 카드를 보내는 일은 느리고 반복하기도 어려우며, 출시 일정이 전화기를 가진 사람에게 묶이게 됩니다. OTP Route에서는 원하는 서비스용 +269 번호를 요청하고, 테스트 중인 앱에서 코드를 발생시킨 다음, 소프트웨어로 수신하면 됩니다. 대시보드를 클릭하며 살펴보는 프로덕트 매니저에게도, 브라우저를 전혀 쓰지 않는 CI 작업에도 같은 경로가 적용됩니다.

이 페이지의 나머지는 체크리스트, 정확한 단계, 메시지가 오지 않을 때의 해결 방법 순서로 구성되어 있습니다.

+269 번호를 주문하기 전 사전 점검 체크리스트

프로젝트마다 한 번씩 이 항목들을 확인하면 실패하는 시도의 대부분은 미리 사라집니다.

• API 키: Developer 콘솔에서 만든 or_live_로 시작하는 키입니다. 키는 최대 10개까지 보유할 수 있으므로 CI에는 전용 키를 주고 독립적으로 폐기할 수 있게 하세요.
• 웹훅 엔드포인트(계정당 최대 5개): X-OTPRoute-Signature 헤더를 검증하는 엔드포인트, 공개 URL을 노출할 수 없다면 폴링 루프를 사용합니다.
• 지갑 잔액: USD 기준 잔액이며, 비용을 쓰지 않고 연동만 시험하려면 샌드박스 계정을 사용합니다.
• 정규화 로직: 코드에서 코모로 번호를 E.164 형식으로 저장해야 합니다(자세한 내용은 아래에 있습니다).
• 대상 서비스가 가상 번호를 허용하는지 확인: 일부 플랫폼은 가상 번호를 거부하는데, 이는 해당 서비스의 정책이며 환불 규칙은 바로 이런 경우를 위해 있습니다.
• 요청 한도 관리: API는 계정당 분당 300건을 허용하므로, 상태 엔드포인트를 계속 두드리지 말고 적절한 간격으로 폴링하세요.

지금 코모로 경로로 코드를 보내는 앱에는 어떤 것이 있나요?

코모로의 실시간 스냅샷에는 800개가 넘는 서비스가 나옵니다. 인기 있는 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, ChatGPT (OpenAI), Claude, Amazon, Discord, LinkedIn, Signal, Viber가 있습니다.

재고는 하루 중에도 변하기 때문에 API는 고정된 카탈로그가 아니라 실시간 가용 상태를 반환합니다. 이 목록은 출발점으로 보고, 테스트 실행이 특정 조합에 의존하기 전에 GET /api/v1/countries와 GET /api/v1/services로 확인하세요.

단계별로 보는 코모로 OTP API 순서

기본 URL은 https://otproute.com/api/v1이며 모든 요청에 Authorization: Bearer <key>를 포함합니다.

1. GET /api/v1/prices?country=km&service=<id>로 현재 가격을 조회합니다. km은 코모로의 국가 ID이고 서비스 ID는 서비스 목록에서 가져옵니다.
2. 본문 {"service": "<id>", "country": "km"}과 함께 POST /api/v1/activations로 활성화를 만듭니다. 응답으로 +269 번호와 activation id를 받습니다.
3. 테스트 중인 가입 또는 로그인 양식에 그 번호를 입력합니다.
4. 웹훅으로 activation.sms_received를 기다리거나, 몇 초마다 GET /api/v1/activations/{id}를 호출합니다.
5. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel을 호출해 잔액에 걸린 금액을 해제합니다.

서명을 검증하려면 엔드포인트 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 계산해 v1 값과 비교하고, 타임스탬프가 오래된 요청은 거부하세요. 전체 레퍼런스는 API 문서에서 볼 수 있습니다.

코드 없이 같은 작업을 하는 방법

지원 담당자와 에이전시 계정 매니저는 브라우저에서 모든 작업을 할 수 있습니다. 로그인해서 OTP Gateway를 열고, 코모로를 선택하고, 서비스를 고른 뒤, 확정하기 전에 표시된 가격을 확인하세요. 번호가 바로 나타나므로 앱에 붙여 넣고 페이지를 열어 둔 채로 기다립니다. SMS가 도착하면 활성화 옆에 코드가 표시되며, 그대로 복사해 인증 입력란에 넣을 수 있습니다.

+269 코드가 오지 않을 때의 문제 해결

반응이 없다면 보통 클라이언트 버그가 아니라 라우팅이나 수락 문제입니다. 다음 순서로 점검하세요.

• 유효 시간을 충분히 주세요. 활성화는 20분 동안 유지되며, 그 안에서 앱의 코드 재전송을 누르는 것은 괜찮습니다.
• 짧은 간격으로 재주문하지 마세요. 몇 초마다 새 활성화를 만들면 요청 한도만 소진되고 도움이 되는 경우는 드뭅니다.
• 나중에 다시 시도하거나 다른 경로를 써 보세요. 다른 서비스 조합이나 마다가스카르 같은 인근 국가가 그날은 다르게 동작할 수 있습니다.
• 수락 여부를 확인하세요. 앱이 가상 번호를 거부한다면 어떤 재시도로도 바뀌지 않습니다.

코드가 전달된 경우에만 요금을 냅니다. 유효 시간이 빈 채로 끝나거나 취소하면 전액이 자동으로 환급됩니다. 자세한 내용은 OTP 전송 실패 줄이기 가이드를 참고하세요.

+269 번호는 어떻게 저장하고, 코드는 어떤 언어로 오나요?

코모로 번호는 짧습니다. 국가 코드 +269 뒤에 7자리 국내 번호가 오고, 제거해야 할 트렁크 접두사는 없습니다. E.164 형식인 +269와 공백 없는 7자리로 저장하고, 다른 나라의 습관에서 따라온 맨 앞의 0이 붙은 입력은 거부하세요.

공용어는 코모로어, 프랑스어, 아랍어입니다. 글로벌 앱은 대체로 계정 로캘에 따라 영어나 프랑스어로 코드를 보내므로, 파서는 고정 문구가 아니라 숫자 열을 찾아야 합니다. 이곳에서 테스트하는 팀은 해외의 코모로 커뮤니티를 대상으로 서비스하거나, 프랑스어 현지화 QA를 하거나, 동아프리카와 인도양 지역 출시를 준비하는 경우입니다.

지갑, 샌드박스, 장기 회선

요금은 월 요금이나 선택할 요금제 없이 선불 USD 지갑 하나로 처리됩니다. 카드 또는 USDT/USDC로 충전하며, 충전할 때마다 PDF 인보이스가 이메일로 도착합니다. 현재 요금은 요금 페이지에 있습니다. 연동을 구축하는 동안 시뮬레이션 번호와 코드를 받을 수 있도록 개발 계정에 샌드박스 모드를 요청하세요.

OTP Route에는 코모로용 셀프서비스 장기 번호가 없습니다. 전용 번호(Dedicated Numbers)는 미국과 캐나다 전용 상품으로 월 $1.95부터 시작합니다. 지속적으로 쓸 +269 회선이 필요하다면 [email protected]으로 이메일을 보내세요. 현지 규정상 가능한지 팀이 알려 드리지만 가능하다고 약속하는 것은 아닙니다.

자주 묻는 질문

현지 SIM 없이 앱의 코모로 가입 절차를 테스트할 수 있나요?

네. OTP Gateway에서 +269 번호를 주문해 가입 양식에 입력하고, 대시보드나 웹훅에서 코드를 읽으세요.

OTP Route API에서 코모로의 국가 ID는 무엇인가요?

km입니다. 가격을 조회하거나 활성화를 만들 때 country 값으로 전달하세요.

코모로 인증번호 비용은 얼마인가요?

코모로 활성화는 $0.20/코드부터 시작하며, 선택한 서비스에 따라 금액이 달라집니다. 정확한 금액은 GET /api/v1/prices가 반환하고, 확정하기 전에 대시보드에도 표시됩니다.

코드가 끝내 오지 않으면 어떻게 되나요?

20분이 지나면 활성화가 만료되고 결제 금액 전액이 지갑으로 돌아옵니다. 그 전에 취소해도 같은 환불이 이루어집니다.

코모로 번호에서 맨 앞의 0을 제거해야 하나요?

코모로에는 트렁크 접두사가 없으므로 저장 형식은 +269 뒤에 7자리 번호를 붙인 것이 전부입니다.

알아 두어야 할 이용 정책이 있나요?

코모로 번호는 자사의 합법적인 계정과 제품을 테스트하거나 운영하는 데만 사용하고, 각 서비스의 약관을 따르며, OTP Route 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요. 준비가 되면 계정을 만드세요.

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