케이맨 제도 인증 번호 사전 점검 체크리스트

사전 점검 체크리스트: +1 345 번호를 주문하기 전에 무엇을 준비해야 하나요?

이 목록을 한 번 훑어 두면 첫 케이맨 활성화는 대체로 무난하게 끝납니다.

• 계정과 보안. 이메일 주소와 6자리 이메일 코드(또는 Google 로그인)로 가입한 다음, 지갑에서 비용을 쓸 수 있는 모든 사람에게 TOTP 2단계 인증을 켜세요.
• 충전된 지갑. 선불 USD 지갑을 카드 또는 USDT/USDC로 충전하세요. 선택할 요금제도 월 요금도 없습니다.
• API 키. 개발자 콘솔에서 or_live_로 시작하는 키를 만들어 Bearer 헤더에 넣습니다. 계정당 키는 최대 10개까지 보유할 수 있습니다.
• 웹훅 엔드포인트. URL을 등록하고 핸들러가 읽을 수 있는 곳에 시크릿을 보관하세요. 계정당 엔드포인트는 최대 5개입니다.
• 전화번호 파싱 설정. 번호 라이브러리가 지역 번호 345를 케이맨 제도로 인식하고, 모든 +1 번호를 기본적으로 미국으로 처리하지 않는지 확인하세요.
• 예행연습이 필요하다면 샌드박스. 지원팀에 개발 계정을 샌드박스 모드로 전환해 달라고 요청하면, 시뮬레이션된 번호와 코드로 지갑 자금을 쓰지 않고 연동을 점검할 수 있습니다.

응답에서 볼 수 있는 모든 필드는 API 레퍼런스에 나와 있습니다.

`+1`을 미국으로 가정하는 코드가 케이맨 번호에서 걸리는 이유는 무엇인가요?

케이맨 제도는 북미 번호 체계(NANP)에 속해 있어서 미국, 캐나다, 그리고 많은 카리브해 지역과 국가 코드 1을 공유합니다. 케이맨 회선을 구분하는 것은 지역 번호 345입니다. 전체 번호는 국가 코드 뒤에 10자리이며, 현지에서는 (345) NXX-XXXX로 표기하고 E.164에서는 +1345 뒤에 7자리를 붙여 저장합니다.

엔지니어에게 실무적으로 중요한 점 세 가지입니다.

• 지역 감지는 지역 번호를 살펴야 합니다. +1 접두사만으로 국가를 추정하는 가입 폼은 케이맨 고객을 미국인으로 분류하고, 잘못된 시간대, 통화, 동의 문구를 고를 수 있습니다.
• NANP에서 맨 앞의 1은 장거리 트렁크 숫자 역할도 하므로, 사용자가 1 345...나 345...로 입력하기도 합니다. 저장하기 전에 세 가지 모두 E.164 문자열로 정규화하세요.
• 번호는 공백, 하이픈, 괄호 없이 저장하고, 표시할 때만 형식을 적용하세요.

공용어는 영어이므로 이 시장의 코드는 보통 영어로 도착합니다. 다만 정확한 문구는 경로가 아니라 메시지를 보내는 서비스가 정합니다.

케이맨 제도 인증 번호로 코드를 보낼 수 있는 서비스는 무엇인가요?

국가 ky의 라이브 스냅샷에는 현재 WhatsApp, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Amazon, Airbnb, Uber, Signal, Discord, ChatGPT (OpenAI), Netflix, eBay가 포함되어 있습니다. 롱테일까지 세면 이 경로는 600개 넘는 서비스를 지원하며, 목록은 하루 중에도 바뀝니다. 그래서 이용 가능 여부는 하드코딩하지 않고 항상 API에서 읽어야 합니다.

팀들이 테스트용 +1 345 번호를 필요로 하는 이유는 케이맨 제도가 주요 역외 금융 중심지이자 붐비는 관광지이기 때문입니다. 펀드 관리 회사, 보험사, 여행 플랫폼, 부동산 기업이 현지 고객을 온보딩하며, 제품 팀은 케이맨 주민이 경험하는 그대로 가입 흐름이 동작하는지 보고 싶어 합니다. 이런 패턴은 핀테크 온보딩 노트에서 더 깊이 다룹니다.

단계별 안내: 케이맨 제도 OTP API 호출 순서는 어떻게 되나요?

모든 호출은 Bearer 키와 함께 https://otproute.com/api/v1로 보내며, 분당 300건의 한도가 적용됩니다.

1. GET /api/v1/services를 한 번 호출하고 테스트 스위트에 필요한 서비스 ID를 캐시합니다.
2. GET /api/v1/prices?country=ky&service=<id>로 실시간 가격을 읽고 해당 조합이 현재 이용 가능한지 확인합니다.
3. {"service": "<id>", "country": "ky"} 같은 본문으로 POST /api/v1/activations를 보냅니다. 응답에는 활성화 ID와 +1 345 번호가 들어 있습니다.
4. 그 번호를 테스트 대상 앱에 입력하고 SMS 단계를 실행합니다.
5. 웹훅으로 activation.sms_received를 기다립니다. 먼저 X-OTPRoute-Signature 헤더를 확인하세요. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산해 v1과 비교하고, 오래된 타임스탬프는 거부합니다.
6. 웹훅이 없다면 코드가 나타나거나 창이 닫힐 때까지 적당한 간격으로 GET /api/v1/activations/{id}를 폴링합니다.
7. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel을 호출해 보류된 금액을 지갑으로 되돌립니다.

서명 검증은 HMAC 웹훅 가이드에서 한 줄씩 설명합니다.

대시보드를 선호하는 동료를 위한 단계별 안내

지원팀 직원과 계정 매니저는 API를 전혀 건드릴 필요가 없습니다.

1. 대시보드에서 OTP Gateway 페이지를 엽니다.
2. 국가로 케이맨 제도를 고른 다음, 인증하려는 서비스를 선택합니다.
3. 주문 전에 표시된 가격을 확인하고 확정합니다.
4. 번호를 앱에 복사하고 코드를 요청한 다음 활성화 페이지를 열어 두세요. SMS가 도착하면 그곳에 나타납니다.

20분의 창과 환불은 API를 쓸 때와 똑같이 적용됩니다.

문제 해결: +1 345 번호로 코드가 오지 않으면 어떻게 하나요?

아무 소식이 없는 활성화에는 요금이 부과되지 않습니다. 20분이 지나기 전에 SMS가 오지 않거나 취소하면 결제 금액 전액이 저절로 지갑으로 돌아갑니다. 다시 주문하기 전에 다음을 확인하세요.

• 창이 끝날 때까지 기다리세요. 전달 시간은 서비스와 경로에 따라 다르므로, 늦은 코드가 반드시 실패한 코드는 아닙니다.
• 서비스 정책을 확인하세요. 일부 서비스는 가상 번호를 아예 거부하며, 환불은 바로 그런 상황을 위한 것입니다.
• 나중에 다시 시도하거나 경로를 바꾸세요. 재고는 하루 중에도 바뀌므로, 한 시간 뒤의 두 번째 시도나 인근 카리브해 국가에서는 결과가 다를 수 있습니다.
• 짧은 간격의 반복을 피하세요. 몇 초마다 취소하고 다시 주문하는 스크립트는 요청 한도만 소모하고 도움이 되는 경우가 드뭅니다.

더 많은 진단 방법은 전송 실패 대응 가이드에 있습니다. 번호는 자사 제품이나 자사 비즈니스 계정에만 사용하고, 모든 서비스의 약관을 따르며, OTP Route 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요.

케이맨 회선을 장기간 유지할 수 있나요? 결제는 어떻게 처리되나요?

케이맨 제도에는 셀프서비스로 쓸 수 있는 장기 번호가 없습니다. +1 국가 코드를 공유한다고 해서 달라지지 않습니다. 전용 번호는 미국과 캐나다 전용 상품이며 월 $1.95부터 시작하고, 수신 SMS, 발신 SMS, 브라우저 통화를 지원합니다. 팀에 고정 345 회선이 필요하다면 [email protected]으로 이메일을 보내 주세요. 이용 가능 여부는 현지 규정에 따라 다르며 보장되지 않습니다.

그 밖의 모든 것은 하나의 선불 USD 지갑으로 운영됩니다. 카드 또는 USDT/USDC로 충전할 때마다 PDF 인보이스가 이메일로 발송되며, 종량제 방식은 요금 페이지에서 설명합니다.

자주 묻는 질문

현지 SIM 없이 우리 앱의 케이맨 제도 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 +1 345 번호를 주문해 앱에 입력하고, 대시보드나 API로 코드를 읽으세요. 코드당 $0.20부터이며 코드가 도착했을 때만 요금이 부과됩니다.

API에서 케이맨 제도의 국가 ID는 무엇인가요?

ID는 ky입니다. GET /api/v1/prices 또는 POST /api/v1/activations를 호출할 때 country 값으로 전달하세요.

케이맨 전화번호는 데이터베이스에 어떻게 저장해야 하나요?

E.164 형식으로 저장하세요. +1345 뒤에 7자리 가입자 번호를 붙이고 공백이나 구두점은 쓰지 않습니다. 지역은 +1 접두사가 아니라 345 지역 번호로 감지하세요.

+1 345 번호도 전용 번호(Dedicated Numbers)에서는 미국 번호로 취급되나요?

아니요. 전용 번호는 미국과 캐나다에서만 판매되므로, 케이맨 회선은 코드 한 건용 OTP Gateway 활성화로만 이용할 수 있습니다.

SMS가 끝내 오지 않으면 내 돈은 어떻게 되나요?

활성화는 20분 동안 열려 있습니다. 그 시간 안에 코드가 오지 않거나 먼저 취소하면 결제 금액 전액이 자동으로 지갑에 환불됩니다.

지갑 자금을 쓰지 않고 CI에서 케이맨 OTP 테스트를 실행할 수 있나요?

지원팀에 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 시뮬레이션된 번호와 코드가 반환되므로 파이프라인에서 활성화와 웹훅 전체 흐름을 비용 없이 실행할 수 있습니다.

OTP Route는 케이맨 제도의 서비스를 몇 개나 지원하나요?

최신 스냅샷 기준으로 600개 넘게 지원합니다. 재고는 하루 중에도 바뀌므로 실시간 가용성은 GET /api/v1/services와 가격 엔드포인트로 조회하세요.

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