일회성 인증인가, 지속 번호인가: 바누아투 프로젝트에는 무엇이 맞나요?
바누아투 작업의 대부분은 아래 첫 번째 범주에 속합니다.
- 코드 하나: 가입을 완료하거나, +678 입력이 검증기를 통과하는지 증명하거나, 온보딩 SMS가 태평양 경로에 도달하는지 확인하는 용도입니다. OTP Gateway가 그 용도입니다.
- 계속 동작하는 번호: 반복되는 로그인이나 지원 데스크에 필요합니다. OTP Route는 이런 Dedicated Numbers를 미국과 캐나다에서만 셀프서비스로 월 $1.95부터 판매합니다.
바누아투에는 셀프서비스 장기 번호가 없습니다. 실제로 필요한 팀은 [email protected]으로 이메일을 보낼 수 있지만, 가능한 범위는 현지 규정이 정하며 미리 약속되는 것은 없습니다.
지금 +678 번호에서 동작하는 서비스는 무엇인가요?
바누아투는 규모가 작은 경로로, 100개가 넘는 서비스가 나열되어 있습니다. 실시간 스냅샷에는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Amazon, LinkedIn, AliExpress, Coinbase, Bumble, GitLab이 포함됩니다.
이 나라의 커버리지는 자주 바뀌므로, 어제의 목록을 가정하지 말고 실행 전마다 GET /api/v1/countries와 GET /api/v1/services(또는 대시보드 선택기)를 확인하세요. +678에서 서비스를 이용할 수 없다면 피지나 뉴칼레도니아 같은 인접 태평양 경로에서 비슷한 테스트가 가능한지 확인해 볼 만합니다.
팀은 왜 테스트용 +678 번호가 필요한가요?
바누아투는 태평양 섬 사용자를 위해 만든 앱, 방문객과 현지 사업자의 예약을 받는 여행·숙박 플랫폼, 바누아투와 호주, 뉴질랜드를 오가며 사는 가족과 노동자가 쓰는 서비스에 중요합니다. 이런 사용자층 중 누구라도 +678 번호로 가입할 수 있다면, 인증 단계는 그런 번호로 테스트되어야 합니다.
비슬라마어, 영어, 프랑스어가 모두 공용어입니다. 글로벌 서비스는 보통 계정이나 기기 로케일에 따라 영어나 프랑스어로 코드를 보내므로, 자체 템플릿이 제공하는 언어에서 올바르게 읽히는지 확인하고 SMS 세그먼트 길이를 가늠할 때 악센트가 있는 프랑스어 문자를 염두에 두세요.
바누아투 전화번호는 어떻게 형식화하고 저장하나요?
바누아투 번호는 트렁크 접두사 없이 7자리이므로, E.164 형식은 +678 뒤에 가입자 번호가 곧바로 붙습니다. 제거할 것은 없지만, 더 긴 국내 형식을 기대하는 검증기는 짧은 번호에서 걸리고, 일부 양식 라이브러리는 +678 없이 입력한 7자리 번호로 잘못된 국가를 추측합니다. 표준 E.164 문자열 하나만 저장하고, 국가 코드를 명시적으로 요구하거나 추론하며, 검증 테스트에 +678 픽스처를 포함하세요.
바누아투 OTP API를 호출 단위로 따라가 보기
개발자 콘솔에서 Bearer 키(or_live_로 시작)를 생성하고 https://otproute.com/api/v1로 요청을 보내세요.
GET /api/v1/prices?country=vu&service=gitlab은 해당 조합의 실시간 가격을 반환합니다.{"service": "gitlab", "country": "vu"}와 함께POST /api/v1/activations를 호출하면 번호가 예약되고 활성화 id가 반환됩니다.GET /api/v1/activations/{id}는 상태와, 도착하면 코드를 알려 줍니다. 대안으로 웹훅 엔드포인트가activation.sms_received를 받습니다.- 바누아투 테스트를 중단하면
POST /api/v1/activations/{id}/cancel이 번호를 일찍 반납합니다.
서명된 웹훅에는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature가 포함됩니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 검증하고 오래된 타임스탬프는 버리세요. 코드에서 대체 경로를 고르는 방법은 국가별 OTP 라우팅 글에서 설명합니다. 계정당 키 10개, 웹훅 엔드포인트 5개, 분당 300건 요청을 쓸 수 있으며 자세한 내용은 개발자 문서에 있습니다.
바누아투 인증 번호를 대시보드로 이용하기
모든 팀원이 코드를 쓰는 것은 아닙니다. 대시보드에서는 바누아투를 선택하고, 서비스를 선택하고, 가격을 확인한 뒤 주문하세요. 그다음 대상 앱에 +678 번호를 입력하고 SMS를 요청합니다. 코드는 주문 카드에 표시됩니다. 이 모든 일은 20분의 시간 창 안에서 이루어지며, 그 후 번호는 해제됩니다.
바누아투에서 아직 코드가 오지 않나요? 무엇을 시도해야 하나요?
먼저 20분을 끝까지 기다리세요. 주문이 계속 비어 있다면 서비스가 가상 번호를 받지 않거나 해당 시점에 경로가 한가할 수 있습니다. 나중에 다시 시도하거나 다른 서비스 경로로 전환하고, 빠른 반복문으로 재주문하지 마세요. SMS 없이 시간 창이 닫히거나 취소하면 전체 금액이 자동으로 지갑에 돌아갑니다.
지갑은 월 요금 없이 USD로 선불 충전하며, 카드 또는 USDT/USDC로 충전할 때마다 PDF 인보이스를 받습니다. 개발 계정에 요청 시 제공되는 샌드박스 모드로 시뮬레이션된 코드를 써서 흐름을 연습할 수 있습니다. 언제나처럼 각 서비스의 약관과 당사의 허용 가능 사용 정책을 따르세요. 현재 요금은 요금에서 확인하세요.
자주 묻는 질문
해외에서 바누아투 번호로 테스트 계정을 인증할 수 있나요?
네. +678 번호는 온라인으로 주문하고 코드는 대시보드에 표시되거나 API로 전달되므로 현지 SIM이 필요 없습니다.
바누아투의 API 요청에는 어떤 국가 코드를 넣나요?
country 필드에 vu를 사용하고, gitlab이나 whatsapp 같은 서비스 id와 함께 보내세요.
바누아투도 0 같은 트렁크 접두사를 쓰나요?
아니요. 번호는 트렁크 접두사 없이 다이얼하는 7자리이며, 국제 형식으로는 +678 뒤에 그 자릿수를 붙여 씁니다.
바누아투는 큰 나라보다 서비스가 적게 나열되는 이유는 무엇인가요?
작은 경로는 커버리지가 좁고 자주 바뀝니다. API나 대시보드의 실시간 목록을 확인하고, 서비스가 없으면 피지 같은 인근 경로를 고려하세요.
코드가 오지 않으면 요금이 청구되나요?
아니요. 수신되지 않았거나 취소한 활성화는 자동으로 지갑에 환불됩니다.
팀이 지원 전화용으로 바누아투 번호를 계속 보유할 수 있나요?
셀프서비스 장기 바누아투 회선은 없습니다. Dedicated Numbers는 미국과 캐나다에서만 판매되며, 그 밖의 요청은 [email protected]으로 보내세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.