엔지니어는 아루바의 +297 번호 체계에 대해 무엇을 알아야 하나요?
아루바는 네덜란드 왕국을 구성하는 자치국으로, 네덜란드의 +31 대역과 구별되는 고유 국가 코드 +297을 가지고 있습니다. 가입자 번호는 일곱 자리이고 트렁크 접두사가 없으므로, 현지인이 양식에 적는 번호가 이미 전체 국내 유효 번호입니다.
이런 단순함에는 고전적인 검증 버그가 숨어 있습니다. 많은 가입 양식이 더 큰 시장만 테스트한 탓에 최소 여덟 자리나 열 자리를 강제하며, 그러면 아루바 사용자는 코드가 전송되기도 전에 오류를 만납니다. 몇 가지 규칙으로 깔끔하게 유지할 수 있습니다.
- 모든 번호를 E.164로 저장하세요. 예:
+2975XXXXXX, 공백이나 문장 부호 없이. - 입력 시 공백, 하이픈, 앞의
00을 제거하고, 사용자가 국가 메뉴에서 아루바를 골랐다면+297을 앞에 붙이세요. 0을 절대 추가하지 마세요. 아루바에는 복원할 트렁크 숫자가 없습니다.- 길이는 직접 쓴 검사 대신 관리되는 전화번호 라이브러리가 판단하게 하세요.
실제 테스트용 +297 번호는 양식, 데이터베이스 열, SMS 발신기가 모두 이 일곱 자리 형태에 합의하는지 증명하는 가장 빠른 방법입니다.
팀이 굳이 아루바 번호로 QA를 하는 이유는 무엇인가요?
이 섬은 관광으로 먹고살기 때문에 가장 관심이 큰 제품은 예약 엔진, 렌탈과 차량 호출 앱, 호스피탈리티 소프트웨어, 여행 핀테크, 로열티 프로그램입니다. 네덜란드령 카리브해로 확장하는 팀은 아루바, 퀴라소, 신트마르턴을 함께 출시하며 세 곳의 국가 번호를 모두 아우르는 하나의 회귀 스위트를 원하는 경우가 많습니다.
언어도 중요합니다. 공용어는 네덜란드어와 파피아멘토어이고, 상점과 호텔에서는 영어와 스페인어도 어디서나 들립니다. 글로벌 서비스는 보통 코드를 영어나 계정 언어로 보내므로, 파서는 고정 문장을 매칭하는 대신 패턴으로 숫자를 추출해야 합니다. 인터페이스에 네덜란드어나 파피아멘토어 문자열이 있다면, 아루바 인증용 번호로 QA가 전화번호 필드 라벨부터 코드 입력 화면까지 현지화된 여정 전체를 확인할 수 있습니다.
어떤 서비스가 +297 번호로 코드를 전달할 수 있나요?
아루바의 실시간 스냅샷에는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, Uber, Airbnb, Signal, LinkedIn 같은 인기 경로가 나열되어 있습니다. OTP Gateway는 이 국가에 대해 모두 600개가 넘는 서비스를 제공합니다.
운영 파트너가 재고를 순환시키면서 가용성이 하루 동안 바뀌므로, OTP Route는 정적 표 대신 실시간으로 이를 제공합니다. 픽스처에 서비스 목록을 하드코딩하지 말고 매 실행 전에 카탈로그를 조회하세요.
아루바 OTP API 요청은 처음부터 끝까지 어떻게 흐르나요?
or_live_로 시작하는 Bearer 키로 인증합니다. 개발자 콘솔에서는 키를 최대 10개, 웹훅 엔드포인트를 5개까지 가질 수 있으며 분당 300건 요청이 상한입니다. 기본 URL은 https://otproute.com/api/v1입니다.
GET /api/v1/countries와GET /api/v1/services를 한 번 호출해 id를 캐시합니다. 아루바는aw입니다.GET /api/v1/prices?country=aw&service=airbnb로 현재 가격을 읽어, 작업이 진행하기 전에 비용을 기록할 수 있게 합니다.{"service": "airbnb", "country": "aw"}JSON 본문으로POST /api/v1/activations를 호출해 주문을 만듭니다. 응답에 활성화 id와 테스트 중인 앱에 입력할 +297 번호가 들어 있습니다.- 웹훅 리스너가 그 주문의
activation.sms_received를 잡도록 하세요. 공개 엔드포인트가 없는 작업은 대신 몇 초마다GET /api/v1/activations/{id}를 확인하면 됩니다. - 테스트가 중단되면
POST /api/v1/activations/{id}/cancel로 주문을 해제합니다.
모든 웹훅에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 붙습니다. 엔드포인트 시크릿으로 <t>.<raw body>에 대한 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프의 요청은 버리세요. 웹훅 수집 가이드가 전체 핸들러를 안내하고, API 문서에 이 SMS 인증 API의 모든 필드가 나와 있습니다.
코드를 쓰지 않는 사람도 아루바 번호를 주문할 수 있나요?
네. 지원 담당자와 프로덕트 매니저는 브라우저에서 똑같이 할 수 있습니다.
- 로그인해서 대시보드의 OTP Gateway 페이지를 엽니다.
- 국가로 아루바를 선택하고 확인하려는 서비스를 고릅니다.
- 표시된 가격을 확인한 뒤 나타나는 +297 번호를 복사합니다.
- 앱에 입력하고 코드를 요청하면, SMS가 도착했을 때 주문 카드에 표시됩니다.
번호 하나는 서비스 하나의 인증 코드 한 건만 처리하므로, 별개의 확인마다 새 주문을 시작하세요.
아루바 번호로 코드가 도착하지 않으면 어떻게 되나요?
모든 주문은 20분 동안 열려 있습니다. 그 시간 안에 SMS가 도착하지 않거나 먼저 취소하면 전체 금액이 저절로 지갑에 돌아가며, 코드가 실제로 도착할 때만 비용을 냅니다. 전송 속도는 서비스와 경로에 따라 다르므로 1분 만에 포기하지 말고 시간 창이 유지되게 두세요.
경로가 계속 비어 있다면 다음을 해 보세요.
- 재고가 순환된 뒤 나중에 다시 시도하거나, 같은 흐름에 대해 다른 서비스 경로를 써 보세요.
- 서비스가 가상 번호를 거부하는지 확인하세요. 일부는 거부하며, 환불이 존재하는 이유가 바로 이것입니다.
- CI에서 짧은 루프로 재주문하지 말고 재시도 간격을 두세요.
더 많은 아이디어는 실패한 OTP 전송 줄이기 글에 있습니다.
장기 +297 회선이 있나요? 요금은 어떻게 청구되나요?
아루바에는 셀프 서비스 방식의 장기 번호가 없습니다. Dedicated Number는 미국과 캐나다 전용 제품으로 월 $1.95부터입니다. 운영에 정말 아루바 회선이 필요하다면 [email protected]으로 이메일을 보내세요. 팀이 현지 규정이 허용하는 범위를 확인해 드리지만 마련할 수 있다는 약속은 없습니다.
나머지는 월 요금도 선택할 요금제도 없는 하나의 선불 USD 지갑으로 운영됩니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하며, 충전마다 PDF 인보이스가 이메일로 발송됩니다. 개발하는 동안에는 요청 시 개발 계정을 샌드박스로 전환해, 시뮬레이션된 번호와 코드로 지갑 자금을 건드리지 않고 OTP 라우팅 로직을 실행해 볼 수 있습니다. 현재 요금은 요금 페이지에 있습니다. 이 서비스는 본인의 제품과 계정에만 사용하고, 각 앱의 약관을 지키며, OTP Route의 이용 정책(Acceptable Use Policy)이 적용된다는 점을 유념하세요.
자주 묻는 질문
섬의 SIM 없이도 호텔 앱의 아루바 가입을 테스트할 수 있나요?
네. OTP Gateway에서 아루바 번호를 주문해 앱에 입력하고, 대시보드나 웹훅에서 코드를 확인하세요.
OTP Route API에서 아루바의 국가 id는 무엇인가요?
모든 요청에 aw를 사용하세요. 예: GET /api/v1/prices?country=aw&service=whatsapp.
아루바 번호에 맨 앞 0을 붙여야 하나요?
아니요. 아루바에는 트렁크 접두사가 없으므로 저장 형식은 +297 뒤에 일곱 자리를 붙인 것입니다.
아루바 SMS OTP를 받으려면 비용이 얼마나 드나요?
아루바 경로는 코드당 $0.20부터이며, 서비스별 금액은 실시간으로 정해집니다. 정확한 금액은 GET /api/v1/prices가 반환하며 확정 전에 대시보드에 표시됩니다.
+297 번호 하나로 다음 주에 두 번째 로그인 코드를 받을 수 있나요?
아니요. Gateway 번호는 인증 코드 한 건만 처리합니다. 나중에 다시 로그인해야 하는 계정에는 미국 또는 캐나다의 Dedicated Number가 더 적합합니다.
OTP Route로 플랫폼에 계정을 대량으로 만들 수 있나요?
아니요. 이 서비스는 본인의 인증 흐름을 테스트하고 정당한 계정을 운영하기 위한 것이며, 각 플랫폼의 약관과 이용 정책(Acceptable Use Policy)이 적용됩니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.