제품·QA 팀이 알아 둘 사모아 개요
사모아는 사모아어와 영어를 공용어로 쓰는 태평양의 독립 국가입니다. 뉴질랜드, 호주, 미국에 큰 사모아계 커뮤니티가 있어서, 송금·메신저·여행 앱은 이 나라들과 본국을 오가는 사용자를 고려해야 하는 경우가 많습니다.
알아 둘 특징이 두 가지 있습니다. 첫째, 사모아(+685)는 북미 번호 체계의 +1 684를 쓰는 미국령 사모아와 다른 나라입니다. 국가 선택기에서 둘을 혼동하면 코드가 엉뚱한 곳으로 갑니다. 둘째, 사모아는 2011년에 날짜 변경선의 서쪽으로 옮겼고 UTC보다 한참 앞선 시간대를 쓰므로, 만료 로직의 날짜 경계를 테스트하기에 좋은 사례입니다.
제품 팀에게 사모아는 단독 출시 시장이 되는 일이 드뭅니다. 보통 태평양 지역 확장의 일부이거나, 디아스포라 대상 앱의 요구 사항이거나, 아피아에 있는 파트너 기관의 비즈니스 계정을 인증해야 할 때 등장합니다. 어느 경우든 할 일은 같습니다. +685 사용자가 가입 절차를 끝까지 마칠 수 있음을 확인하는 것입니다.
+685 번호는 코드에서 어떻게 처리해야 하나요?
사모아의 국내 번호는 대부분의 시장에 비해 짧아서, 9~10자리 번호에 맞춰 만든 검증기가 실제 번호를 거부할 수 있습니다. 번호는 +685와 국내 번호 숫자를 구분 기호 없이 이어서 저장하고, 사용자가 습관적으로 붙인 0은 제거하세요. 웹훅 타임스탬프는 Unix 초 단위이므로 현지 시간이 아닌 UTC로 비교해야 합니다. 서버와 사모아 쪽 테스터가 서로 다른 날짜에 있어도 문제가 생기지 않습니다.
제품에서 한 프로필에 뉴질랜드 번호와 사모아 번호를 번갈아 쓸 수 있다면, 국가 코드를 바꿨을 때 이전 인증 상태가 초기화되는지 확인하는 테스트를 추가하세요. 한 번호로 보낸 코드가 다른 번호에 통하는 일이 없어야 합니다.
사모아 경로에서 어떤 서비스를 쓸 수 있나요?
사모아 카탈로그에는 현재 600개가 넘는 서비스가 올라 있습니다. 자주 요청되는 서비스로는 WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Viber, Signal, TikTok, Microsoft & Outlook, Amazon, Discord 등이 있습니다. 큰 시장보다 커버리지가 얇고 하루 중에도 변하므로, 실행 전마다 GET /api/v1/services와 GET /api/v1/countries를 확인하세요. 원하는 서비스가 없으면 피지나 통가 같은 인근 경로가 테스트에 맞을 수 있습니다.
카탈로그가 가벼운 만큼 테스트 하네스도 유연하게 만드는 편이 좋습니다. 실행 시점에 선호하는 서비스가 없으면 케이스를 실패가 아닌 건너뜀으로 처리하고 기록해 두어, 나중에 누군가 다시 시도할 수 있게 하세요.
API로 사모아 코드 요청하기
https://otproute.com/api/v1에 Bearer 키(or_live_…)로 접속해 GET /api/v1/prices?country=ws&service=<id>로 가격을 조회한 다음, POST /api/v1/activations에 {"service": "<id>", "country": "ws"}를 보냅니다. 활성화 id는 GET /api/v1/activations/{id}를 폴링하거나 activation.sms_received 이벤트를 수신해 추적합니다. 웹훅마다 X-OTPRoute-Signature HMAC을 검증하고, 오래된 타임스탬프는 거부하며, 같은 활성화에 대해 두 번 실행되어도 안전하도록 핸들러를 만드세요. 전체 구조는 연동 가이드에 나와 있습니다.
이 규모의 시장에서는 요청 한도가 넉넉합니다. 계정당 키 10개, 웹훅 엔드포인트 5개, 분당 300건까지 가능합니다. 폴링한다면 몇 초 간격이면 충분합니다.
대시보드에서 직접 하기
- 로그인한 뒤 OTP Gateway를 엽니다.
- 서비스를 고르고 사모아를 선택합니다.
- 실시간 가격을 확인하고 주문합니다.
- 테스트할 앱에 +685 번호를 입력하고 코드를 요청합니다.
- 화면에서 코드를 확인하거나, 더 필요 없으면 취소합니다.
+685 코드가 늦거나 오지 않을 때
포기하기 전에 활성화를 20분 동안 그대로 유지하세요. 일부 앱은 가상 번호를 아예 받지 않으며, 응답 없는 주문이 환불되는 이유가 바로 그것입니다. 경로가 계속 조용하면 나중에 다시 시도하거나 다른 서비스 경로를 선택하세요. 새 주문을 짧은 간격으로 반복해서 넣어도 대개 도움이 되지 않고 요청 한도만 소모합니다.
시도마다 활성화 id를 기록해 두면, 침묵의 원인이 특정 앱인지 경로 전체인지 구분할 수 있습니다.
장기 번호와 이용 요금
OTP Route는 셀프서비스 방식의 사모아 장기 번호를 판매하지 않습니다. 전용 번호(Dedicated Number)는 월 $1.95부터 시작하며 미국과 캐나다에서만 제공됩니다. 사모아 회선이 필요하면 [email protected]으로 문의하시되, 마련해 드릴 수 있다는 보장은 없습니다. 선불 USD 지갑은 카드와 USDT/USDC를 지원하고, 충전마다 PDF 인보이스를 보내며, 월 이용료가 없습니다. 개발 계정에서 샌드박스 모드를 요청하면 자금을 쓰지 않고 ws 흐름을 미리 시험해 볼 수 있습니다.
자주 묻는 질문
전화번호에서 사모아와 미국령 사모아는 같은가요?
아니요. 사모아는 +685, 미국령 사모아는 +1 684를 씁니다. 국가 선택기와 API에서 올바른 쪽을 고르세요.
사모아의 API 국가 id는 무엇인가요?
가격 조회와 활성화 요청 모두 ws를 사용합니다.
사모아 인증 코드는 얼마인가요?
$0.20/코드부터이며, 정확한 가격은 서비스에 따라 다르고 주문 전에 표시됩니다.
뉴질랜드나 호주에서 사모아 사용자의 가입 과정을 테스트할 수 있나요?
네. +685 번호가 SMS를 받고, OTP Route가 팀이 어디에 있든 그 내용을 보여 줍니다.
메시지가 오지 않으면 요금을 내야 하나요?
아니요. 만료되거나 취소된 활성화는 자동으로 지갑에 환불됩니다.
사모아 코드는 어떤 언어로 오나요?
보통 사모아어와 함께 공용어인 영어로 옵니다. 주변 문구가 아니라 숫자를 파싱하세요.
이 번호로 계정을 대량으로 만들어도 되나요?
안 됩니다. 각 서비스의 약관을 지켜야 하며, 이용 정책(Acceptable Use Policy)상 OTP Route는 본인의 정당한 제품과 계정을 테스트하고 운영하는 용도로만 쓸 수 있습니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.