퀴라소(+599) SMS 코드 수신을 위한 사전 점검 체크리스트

+599 번호를 주문하기 전 체크리스트에는 무엇이 있어야 하나요?

섬 시장은 약간의 준비가 도움이 됩니다. 경로의 가용 상태가 하루 중에도 바뀌므로 서두른 테스트는 시간만 낭비하기 때문입니다. 첫 요청 전에 다음을 확인하세요.

• Developer 콘솔의 API 키: 키는 or_live_로 시작하며 계정당 최대 10개까지 보유할 수 있으므로 CI와 스테이징에 각각 따로 주세요.
• 충전된 USD 지갑: 연동만 시험하려면 요청해서 샌드박스로 전환한 개발 계정을 사용해도 됩니다.
• 올바른 ID: API에서 퀴라소는 cw이며, 서비스 ID는 GET /api/v1/services에서 가져옵니다.
• 시크릿을 저장해 둔 웹훅 엔드포인트 또는 적절한 간격의 폴링 루프: 계정당 최대 5개의 엔드포인트가 허용됩니다.
• +599 번호 저장 규칙(아래에서 설명): 테스트 데이터가 운영 데이터와 일치하도록 합니다.
• 빈 경우에 대한 계획: 코드 없이 유효 시간이 끝났을 때 테스트가 어떻게 동작할지 정해 두세요.

퀴라소 인증 번호 경로는 어떤 서비스를 지원하나요?

퀴라소의 실시간 스냅샷에는 400개가 넘는 서비스가 나옵니다. 인기 서비스로는 Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal, Netflix, Uber, Airbnb가 있습니다. 호스피탈리티와 방문객 대상 제품이 섬의 디지털 가입 상당수를 이끌기 때문에, 퀴라소 팀들은 여행과 메신저 서비스를 가장 먼저 찾는 경향이 있습니다.

이 목록은 약속이 아니라 출발점으로 보세요. 재고는 하루 중에도 달라지며, 그래서 API는 가격을 조회할 때마다 가용 상태를 함께 반환합니다.

단계별 안내: 퀴라소 OTP API 호출하기

모든 호출은 Bearer 키로 https://otproute.com/api/v1에 보내며, 분당 300건의 한도 안에서 이루어집니다.

1. GET /api/v1/prices?country=cw&service=<id>를 읽어 경로가 열려 있는지 확인하고 해당 조합의 현재 가격을 확인합니다.
2. {"service": "telegram", "country": "cw"} 또는 필요한 서비스 ID를 담아 POST /api/v1/activations로 주문을 만듭니다. 응답에는 activation id와 +599 번호가 담겨 있습니다.
3. 테스트 중인 가입 또는 로그인 화면에 그 번호를 입력합니다.
4. 웹훅으로 activation.sms_received를 기다리거나, 여유 있는 간격으로 GET /api/v1/activations/{id}를 폴링합니다.
5. 테스트를 중단하면 POST /api/v1/activations/{id}/cancel을 호출해 지갑에 바로 환급받습니다.

웹훅을 신뢰하기 전에 X-OTPRoute-Signature 헤더를 확인하세요. 엔드포인트 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 계산하고 타임스탬프가 오래된 요청은 거부합니다. 더 자세한 설명은 웹훅 서명 가이드에 있습니다.

+599 번호는 어떻게 저장하고 정규화해야 하나요?

퀴라소는 +599 국가 코드를 보네르, 신트외스타티위스, 사바와 공유하며, 퀴라소 가입자 번호는 이 코드 뒤에 9가 붙습니다. 이 맨 앞의 9는 트렁크 접두사가 아니라 번호의 일부이므로, 이를 지우는 정규화 로직은 레코드를 망가뜨립니다. E.164 전체 문자열(+5999 뒤에 나머지 숫자)을 공백 없이 저장하고, 서식은 표시할 때만 적용하세요.

또한 전화번호 입력 위젯이 퀴라소를 독립 항목으로 보여 주는지, 오래된 라이브러리처럼 네덜란드령 안틸레스라는 일반 항목에 합쳐 놓지 않았는지 확인할 가치가 있습니다.

언어는 파피아멘토어, 네덜란드어, 영어가 모두 공용어이며, 대부분의 글로벌 서비스는 영어로 코드를 보내거나 계정에 설정된 언어를 따릅니다. 제품이 네덜란드어나 파피아멘토어로 현지화된다면, 대체 문구가 아니라 실제 템플릿을 볼 수 있도록 언어별로 최소 한 번씩 실행해 보세요. 팀들은 보통 네덜란드령 카리브해 출시, 해외에서 예약하는 방문객 대상 서비스, 섬에서의 지역 운영 때문에 이곳에서 테스트합니다.

코드를 작성하지 않는 사람은 대시보드에서 어떻게 하나요?

지원 담당자와 프로덕트 매니저도 스크립트 없이 같은 일을 할 수 있습니다.

1. 이메일과 6자리 코드 또는 Google 로그인으로 계정을 만들고 TOTP 2단계 인증을 켭니다.
2. 지갑을 충전합니다.
3. OTP Gateway를 열어 서비스를 고른 다음 퀴라소를 선택합니다. 확정하기 전에 가격이 표시됩니다.
4. +599 번호를 앱에 복사해 넣고 코드가 나타날 때까지 활성화 카드를 지켜봅니다.

API와 같은 20분 유효 시간과 환불 규칙이 적용됩니다.

문제 해결: 퀴라소 코드가 오지 않았어요

응답 없는 활성화는 가끔 있는 일이며, 유효 시간이 끝나거나 취소하면 금액이 지갑으로 돌아오기 때문에 비용은 들지 않습니다.

• 유효 시간을 끝까지 두세요. 일부 서비스는 재전송이 느립니다. 2분 만에 취소하면 아직 올 수도 있는 코드를 버리게 됩니다.
• 대상 서비스의 가상 번호 정책을 확인하세요. 일부는 거부하며, 환불 규칙은 그 때문에 있습니다.
• 나중에 다시 시도하거나 다른 국가 경로를 써 보세요. 테스트가 반드시 퀴라소 번호에 의존하지 않는 경우에 해당합니다.
• 짧은 간격으로 재주문하지 마세요. 시도 사이에 간격을 두어 테스트 하나를 위해 활성화를 병렬로 쌓지 않도록 하세요.

팀들이 이런 재시도를 자동화 스위트에 어떻게 넣는지는 QA 테스트 솔루션 페이지에서 볼 수 있습니다.

퀴라소 프로젝트의 장기 회선, 지갑, 요금

퀴라소에는 셀프서비스 장기 번호가 없습니다. 몇 달 동안 유지할 회선이 필요하다면 [email protected]으로 이메일을 보내세요. 팀이 현지 규정이 허용하는 범위를 확인해 드리지만 보장되는 것은 없습니다. 전용 회선은 미국과 캐나다 전용 상품으로 월 $1.95부터 시작하며, 가상 번호 페이지에 설명되어 있습니다.

퀴라소 활성화는 월 요금이나 선택할 요금제 없이 선불 USD 지갑 하나에서 차감됩니다. 충전은 카드 결제와 USDT/USDC 모두 가능하며, 충전할 때마다 퀴라소 프로젝트의 회계 장부용 PDF 인보이스가 이메일로 발송됩니다. 현재 요금은 요금 페이지에 있습니다. OTP Route는 자사 제품과 합법적인 계정에만 사용하고, 각 서비스의 약관을 따르며, OTP Route 이용 정책(Acceptable Use Policy)이 적용된다는 점을 유념하세요.

자주 묻는 질문

현지 SIM을 사지 않고 퀴라소 가입 절차를 테스트할 수 있나요?

네. 테스트 대상 서비스용 +599 번호를 OTP Gateway에서 주문해 대시보드나 API로 코드를 읽으면 되며, 섬에 SIM이나 휴대폰이 없어도 됩니다.

OTP Route는 퀴라소에 어떤 국가 ID를 사용하나요?

퀴라소는 cw입니다. 모든 가격 조회와 주문에서 cw를 GET /api/v1/services에 나온 서비스 ID와 함께 사용하세요.

+599 뒤의 9는 지워야 하는 트렁크 접두사인가요?

아니요. 퀴라소에서 9는 가입자 번호의 일부이므로 저장하는 E.164 값에 그대로 유지하세요.

코드 없이 퀴라소 활성화가 만료되면 요금이 청구되나요?

아니요. 20분 안에 SMS가 오지 않거나 먼저 취소하면 결제 금액 전액이 자동으로 지갑에 돌아옵니다.

다음 달에 다시 로그인하기 위해 퀴라소 번호를 유지할 수 있나요?

셀프서비스로는 불가능합니다. 장기 전용 번호는 미국과 캐나다에서만 판매되며, 퀴라소는 지원팀에 이메일로 문의할 수 있지만 제공 가능하다는 약속은 없습니다.

지갑 잔액을 쓰기 전에 연동을 어떻게 구축하나요?

지원팀을 통해 개발 계정의 샌드박스 모드를 요청하세요. 시뮬레이션 번호와 코드가 반환되므로 API와 웹훅 경로 전체를 처음부터 끝까지 실행해 볼 수 있습니다.

서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.