통가 프로젝트에는 Gateway 번호와 장기 회선 중 무엇이 맞을까요?
작업의 성격부터 보세요. 가입 테스트, 현지화 점검, 지원 사례 재현처럼 SMS 코드 한 건이 도착하는 것만 확인하면 된다면 OTP Gateway가 맞는 제품입니다. 인증 한 번을 위한 +676 번호를 받고, 코드가 대시보드와 시스템에 도착하면 활성화가 종료됩니다.
반대로 다시 로그인하거나, 복구 코드를 받거나, 지원 회선을 운영하기 위해 몇 달 동안 계정에 묶여 있을 번호가 필요하다면 Dedicated Virtual Number의 영역입니다. 이 번호는 미국과 캐나다에서만 월 $1.95부터 제공되며, 브라우저에서 수신 및 발신 SMS와 통화를 지원합니다.
OTP Route에는 통가용 셀프서비스 장기 회선이 없습니다. 필요한 팀은 [email protected]으로 문의할 수 있으나, 제공 여부는 현지 규정에 따라 달라지며 어려울 수도 있습니다. 장단점은 임시 번호 vs 전용 번호에서 더 자세히 다룹니다.
통가 번호로 가입 흐름을 테스트하는 이유는 무엇일까요?
통가에는 뉴질랜드, 호주, 미국에 많이 거주하는 큰 해외 동포 사회가 있고, 가족들은 메시징 앱과 송금 서비스를 통해 이들 나라에서 연락을 유지합니다. 송금 도구, 커뮤니티 플랫폼, 여행 서비스처럼 태평양 지역 커뮤니티를 대상으로 하는 제품은 +64 번호만큼 +676 번호도 자신 있게 받아들여야 합니다.
그래서 통가는 QA에서 유용한 경계 사례가 됩니다. 통가어와 영어가 모두 공용어이고 국제 앱의 인증 문자는 대부분 영어로 오기 때문에, 흥미로운 버그는 메시지 문구보다 번호 처리에서 나오는 경향이 있습니다. 태평양 송금 경로를 위한 핀테크 온보딩을 구축하는 팀이 회귀 스위트에 통가 케이스를 추가하는 것도 바로 이런 이유 때문입니다.
+676 번호를 검증기는 어떻게 다뤄야 하나요?
통가의 국내 번호는 대부분의 개발자가 떠올리는 유럽이나 미국 번호보다 훨씬 짧고, 국제 형식에서 국내 접두번호는 없습니다. 최소 길이를 고정한 검증 코드가 이런 번호를 거부하는 가장 흔한 원인입니다.
- 모든 번호를 E.164로 저장하세요.
+676뒤에 가입자 번호이며, 절대 패딩하지 마세요. - 다른 나라에서 복사한 정규식 대신 최신 전화번호 라이브러리를 사용하세요.
- SMS 발송기가 번호가 너무 짧아 보이는 수신자를 조용히 떨어뜨리지 않는지 확인하세요.
- 앞으로 리팩터링에서 같은 버그가 다시 생기지 않도록 픽스처 세트에 통가 인증 번호를 넣어 두세요.
Gateway에서 +676 번호를 한 번 주문해 보면, 통신사가 실제로 전달한 SMS로 전체 경로가 동작하는지 저렴하게 확인할 수 있습니다.
통가 경로는 어떤 서비스를 지원하나요?
통가 경로에는 현재 600개가 넘는 서비스가 등록되어 있습니다. 최신 스냅샷에서 인기 있는 서비스는 Facebook, TikTok, Viber, WhatsApp, Instagram, Telegram, Google (Gmail & YouTube), Snapchat, Microsoft & Outlook, Amazon 등입니다.
경로 간 용량이 이동하므로 목록은 하루 중에도 바뀝니다. 참고용으로만 보고, 주문하기 전에 대시보드나 가격 엔드포인트로 실시간 가용 여부를 확인하세요.
통가 OTP API는 어떻게 호출하나요?
개발자 콘솔에서 발급받은 or_live_로 시작하는 Bearer 키로 https://otproute.com/api/v1에 인증합니다. 통가의 국가 id는 to입니다.
GET /api/v1/prices?country=to&service=<id>로 가격과 재고를 확인한 뒤, POST /api/v1/activations에 {"service": "viber", "country": "to"} 같은 본문을 보내 주문합니다. 응답에는 활성화 id와 +676 번호가 들어 있습니다.
통가 SMS OTP 코드를 자동으로 받으려면 activation.sms_received와 activation.expired용 웹훅을 등록하세요. 각 요청에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 다시 계산해 상수 시간으로 비교하고, 오래된 타임스탬프는 거부하세요. 작은 작업에는 GET /api/v1/activations/{id} 폴링도 괜찮고, POST /api/v1/activations/{id}/cancel로 필요 없는 주문을 해제할 수 있습니다. 한도는 계정당 분당 300건, 키 10개, 웹훅 엔드포인트 5개입니다. 요청과 응답의 자세한 내용은 개발자 문서를 참고하세요.
통가 코드가 느리거나 오지 않을 때는 어떻게 하나요?
작은 섬나라 시장에서는 경로가 얇은 것이 정상이므로, 필요해지기 전에 재시도 정책을 만들어 두세요.
- 20분의 제한 시간이 끝날 때까지 기다리세요. SMS가 도착하지 않으면 전액이 환불됩니다.
- 테스트 중인 서비스가 가상 번호를 받는지 확인하세요. 일부는 받지 않으며, 어떤 경로로도 바뀌지 않습니다.
- 새 주문을 연달아 넣지 말고 잠시 기다린 뒤 다시 시도하세요.
- 테스트가 태평양 지역 번호 전반에 관한 것이라면 피지나 사모아 같은 인근 경로를 시도해 보세요.
모든 주문은 대상 서비스의 약관과 OTP Route의 이용 정책(Acceptable Use Policy)을 지켜야 합니다.
결제와 샌드박스 테스트는 어떻게 동작하나요?
OTP Route는 하나의 선불 USD 지갑으로 쓴 만큼 결제하는 방식이라 월 이용료도 선택할 요금제도 없습니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하며, 충전마다 PDF 인보이스가 이메일로 발송됩니다. 아직 흐름을 만드는 개발자는 개발 계정에 샌드박스 모드를 요청할 수 있으며, 시뮬레이션된 번호와 코드가 반환되어 지갑을 건드리지 않고 OTP 라우팅 로직과 웹훅 핸들러를 테스트할 수 있습니다. 현재 코드당 가격은 가격 페이지에 있습니다.
자주 묻는 질문
통가에 있지 않아도 통가 인증 코드를 받을 수 있나요?
네. OTP Gateway에서 +676 번호를 주문하면 팀이 어디에 있든 코드가 대시보드에 표시되고 웹훅으로 전송됩니다.
SMS 인증 API에서 통가의 국가 id는 무엇인가요?
id는 to이며 GET /api/v1/prices와 POST /api/v1/activations에서 사용합니다.
우리 폼이 올바른 통가 번호를 거부하는 이유는 무엇인가요?
보통 더 긴 번호를 기준으로 작성한 최소 길이 검사 때문입니다. 유지 관리되는 전화번호 라이브러리로 검증하고 번호는 E.164로 저장하세요.
계속 보유할 수 있는 장기 +676 번호가 있나요?
셀프서비스로는 없습니다. 장기 Dedicated Number는 미국과 캐나다에서만 제공되며, 통가는 [email protected]으로 문의하세요.
통가 코드가 도착하지 않으면 제 돈은 어떻게 되나요?
20분의 제한 시간이 SMS 없이 끝나거나 직접 취소하면 전액이 자동으로 지갑에 돌아갑니다.
CI에서 우리 앱의 통가 온보딩을 테스트할 수 있나요?
네. 환경마다 API 키를 쓰고, 폴링하거나 웹훅을 수신하세요. 파이프라인을 만드는 동안에는 개발 계정을 샌드박스로 전환하면 됩니다.
통가 인증 문자는 어떤 언어로 오나요?
대부분의 국제 앱은 영어로 보내지만, 서비스와 계정의 언어 설정에 따라 다릅니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.