릴리스에 +501 코드가 필요한데 벨리즈 SIM을 가진 사람이 없습니다
흔히 겪는 상황입니다. 중미 출시 일정이 잡혀 있고 QA 계획에 벨리즈가 올라 있는데, 벨리즈 휴대폰을 가진 사람은 고객뿐입니다. 동료의 개인 번호를 빌리는 것은 곤란하고, 테스트 주기마다 반복하기도 어렵습니다.
OTP Route는 그 문제 중 핵심 부분을 해결합니다. OTP Gateway는 선택한 서비스에서 코드 한 번을 받을 수 있는 +501 번호를 발급하고, 받은 코드를 돌려줍니다. 자사 가입 및 로그인 화면을 점검하는 팀을 위해 만든 OTP 라우팅이며, QA 테스트 워크플로에 자연스럽게 들어맞습니다.
벨리즈 전화번호에서 실수하기 쉬운 부분은 무엇인가요?
벨리즈 번호는 짧습니다. 국가 코드 +501 뒤에 7자리 국내 번호가 오고 트렁크 접두사가 없어서, 국내 형식과 E.164 형식은 앞의 +501 유무만 다릅니다. 맨 앞 0이나 10자리 국내 번호를 전제로 만든 검증기는 올바른 벨리즈 입력을 거부하기 쉬우므로, 전용 테스트 케이스를 두는 것이 좋습니다.
번호는 +501과 7자리 숫자로 저장하고, 저장 전에 서식 문자를 제거하며, 현지식 그룹 표시는 UI에서만 적용하세요. 공용어는 영어이고 스페인어와 벨리즈 크리올어도 널리 쓰입니다. 인증 문자는 보통 영어로 도착하지만 스페인어 템플릿일 수도 있으므로 숫자 패턴으로 코드를 추출하세요.
벨리즈는 중미에서 영어를 공용어로 쓰는 유일한 나라이기도 해서, 한 흐름을 영어와 스페인어로 현지화하는 팀에게 좋은 점검 지점이 됩니다.
API로 벨리즈 인증 번호를 받으려면 어떻게 하나요?
https://otproute.com/api/v1로 보내는 모든 호출은 개발자 콘솔에서 만든 or_live_로 시작하는 Bearer 키로 인증합니다.
GET /api/v1/services와GET /api/v1/countries로 카탈로그를 조회합니다. 벨리즈는bz입니다.GET /api/v1/prices?country=bz&service=<id>로 실시간 가격과 재고를 확인합니다.POST /api/v1/activations에{"service": "whatsapp", "country": "bz"}를 보내 주문합니다.- 반환된 +501 번호를 앱에 입력합니다.
- 서명된 웹훅의
activation.sms_received를 기다리거나GET /api/v1/activations/{id}를 폴링합니다. 중간에 취소하려면POST /api/v1/activations/{id}/cancel을 호출하세요.
웹훅 요청에는 X-OTPRoute-Signature 헤더가 포함됩니다. <t>.<raw body>에 대한 HMAC-SHA256을 검증하고 오래된 타임스탬프는 거부하세요. 요청과 응답의 세부 내용은 개발자 문서에서 확인할 수 있습니다.
어떤 앱이 +501 번호로 코드를 보낼 수 있나요?
현재 벨리즈 경로에서는 900개가 넘는 서비스를 이용할 수 있습니다. 요청이 많은 서비스로는 WhatsApp, Facebook, Google (Gmail & YouTube), Airbnb, Instagram, TikTok, Telegram, Uber, Amazon, eBay, Microsoft & Outlook, Signal, Snapchat 등이 있습니다.
사용 가능 여부는 하루 동안 계속 바뀌므로 이 목록은 스냅샷으로만 보시고, 지금 이용 가능한 항목은 가격 엔드포인트나 대시보드에서 확인하세요.
코딩보다 클릭이 편하다면 대시보드를 사용하세요
지원 담당자와 프로덕트 매니저는 API가 전혀 필요 없습니다. 로그인하여 서비스를 고르고 벨리즈를 선택한 뒤 가격을 확인하고 주문하면 됩니다. +501 번호가 화면에 표시되며, 점검 중인 앱에 붙여 넣으면 코드가 도착했을 때 주문 옆에 나타납니다. 취소 버튼으로 주문을 일찍 종료하면 금액이 환불됩니다.
코드가 늦거나 오지 않으면 어떻게 하나요?
도착 시간은 서비스와 경로에 따라 달라지며, 사용자가 조정할 수 있는 부분이 아닙니다. 코드가 도착하지 않았다면 다음을 확인하세요.
- 주문을 그대로 두세요. 활성화 시간은 20분이며, 만료되거나 취소된 주문은 전액 환불됩니다.
- 잠시 후 다시 시도하거나, 테스트가 허용한다면 다른 서비스 경로를 사용해 보세요.
- 해당 단계에서 서비스가 가상 번호를 받는지 확인하세요. 일부 서비스는 거부하며, 이 경우에는 환불이 적용됩니다.
- 주문 엔드포인트를 반복 호출하지 마세요. 자동화 작업에서는 재시도 간격을 두어야 합니다.
+501 회선을 장기간 유지할 수 있나요? 결제는 어떻게 이루어지나요?
벨리즈에는 셀프 서비스 장기 번호가 없습니다. 월 $1.95부터 시작하는 Dedicated Numbers는 미국과 캐나다에서만 제공됩니다. 팀에 오래 쓸 벨리즈 회선이 필요하면 [email protected]으로 문의하시되, 제공 여부는 현지 규정에 따른다는 점을 알아 두세요. 임시 번호와 전용 번호 비교에서 각각 언제 적합한지 설명합니다.
결제는 선불 USD 지갑으로 사용한 만큼만 내며 월 요금은 없습니다. 카드 또는 USDT/USDC로 충전하고, 충전할 때마다 PDF 인보이스를 이메일로 받습니다. 개발 계정을 샌드박스로 전환해 달라고 지원팀에 요청하면 API가 모의 +501 번호와 코드를 반환하므로, CI에서 전체 경로를 무료로 검증할 수 있습니다. 이메일과 6자리 코드 또는 Google로 가입할 수 있습니다.
자주 묻는 질문
벨리즈에 있지 않아도 벨리즈 SMS OTP 코드를 받을 수 있나요?
네. +501 번호는 OTP Gateway에서 발급되며, 팀이 어디에 있든 대시보드나 API에서 코드를 확인할 수 있습니다.
벨리즈 전화번호는 몇 자리인가요?
국내 번호는 트렁크 접두사 없이 7자리이며, 국제 표기로는 +501 뒤에 그 7자리를 붙입니다.
OTP Route API에서 벨리즈의 국가 id는 무엇인가요?
POST /api/v1/activations 같은 호출에서 bz를 사용하세요.
벨리즈 코드가 오지 않으면 내 돈은 어떻게 되나요?
아무것도 차감되지 않습니다. SMS 없이 20분 활성화 시간이 끝나거나 직접 취소하면 전액이 지갑으로 환불됩니다.
매주 로그인하는 계정에 벨리즈 인증 번호를 써도 되나요?
권장하지 않습니다. OTP Gateway 번호 하나는 코드 한 번에만 사용되기 때문입니다. 반복 로그인에는 미국 또는 캐나다 Dedicated Number가 셀프 서비스 방식의 선택지입니다.
+501 번호로 인증할 수 있는 대상에 제한이 있나요?
네. 본인의 정당한 제품과 계정에만 사용하고, 각 서비스의 약관을 따르며, OTP Route의 이용 정책(Acceptable Use Policy)이 적용된다는 점에 유의하세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.