자메이카 SMS 인증 코드: 체크리스트, 단계, 해결 방법

첫 자메이카 활성화 전에 무엇을 확인해야 하나요?

자메이카는 북미 번호 체계(NANP)에 속해 있어서 대부분의 국가와는 확인할 사항이 조금 다릅니다.

• 검증기가 미국이나 캐나다가 아닌 +1 번호도 받아들이는지. 많은 가입 양식이 모든 +1 번호를 미국 번호로 암묵적으로 가정합니다.
• 국가 선택기에 자메이카가 별도로 표시되는지. +1을 하나의 지역으로 취급하면 안 됩니다.
• 개발자 콘솔에 or_live_ API 키가 있고, 시크릿이 있는 웹훅 엔드포인트가 배포되어 있거나 테스트 하네스가 폴링하도록 설정되어 있는지.
• 지갑에 자금이 충전되어 있는지. 또는 예행연습을 위해 샌드박스 모드를 켰는지.
• GET /api/v1/services에서 서비스 ID를 알고 있는지. 자메이카의 국가 ID는 jm입니다.

앞의 두 가지를 잘못 두면 라우팅 문제처럼 보이지만 실제로는 전적으로 자사 코드에 있는 오류가 생깁니다.

+1 자메이카 번호에 특별한 처리가 필요한 이유는 무엇인가요?

자메이카 번호는 지역 번호 876과 비교적 새로운 658을 사용하고 그 뒤에 7자리 가입자 번호가 붙으므로, 전체 E.164 형식은 +1과 10자리입니다. 국내에서는 장거리 통화 시 앞에 1을 누르는데, 저장하기 전에 이를 제거해야 합니다.

엔지니어에게 중요한 점은 +1만으로는 국가를 알 수 없다는 것입니다. 지역 감지는 지역 번호를 기준으로 해야 하며, 통화, 시간대, SMS 템플릿을 국가 코드로 선택하는 로직도 같은 주의가 필요합니다. 표준 E.164 문자열을 저장하고, 감지한 지역은 별도 필드에 보관하며, 876과 658 입력을 모두 테스트하세요.

공용어는 영어이고 인증 문자는 거의 항상 영어로 도착하지만, 일상 대화에서는 자메이카 패트와(Patois)가 자주 쓰입니다. 카리브해 출시, 미국·영국·캐나다의 디아스포라를 대상으로 하는 송금 및 핀테크 흐름, 관광·숙박 제품을 위해 이곳에서 테스트하는 팀이 많습니다. 시장별로 경로를 고르는 방법은 OTP 국가 라우팅 글에서 다룹니다.

자메이카 SMS 인증 API의 단계는 어떻게 되나요?

1. 기본 URL https://otproute.com/api/v1에 GET /api/v1/prices?country=jm&service=<id>를 호출해 실시간 가격을 확인합니다.
2. 주문: {"service": "<id>", "country": "jm"} 본문으로 POST /api/v1/activations를 호출합니다. 활성화 ID와 번호를 기록하세요.
3. 테스트 중인 앱에 번호를 제출합니다.
4. 웹훅의 activation.sms_received 이벤트로 코드를 받거나 GET /api/v1/activations/{id}를 폴링합니다.
5. 자메이카 시도를 일찍 포기하려면 POST /api/v1/activations/{id}/cancel을 보내 보류를 해제합니다.

어떤 이벤트든 처리하기 전에, 엔드포인트 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 다시 계산해 X-OTPRoute-Signature의 v1 값과 비교하고, 너무 오래된 타임스탬프는 거부하세요. activation.expired와 activation.cancelled도 활성화 ID 기준으로 처리해, 재시도가 이중 처리로 이어지지 않게 하세요. 용량 계획 시 참고로, 한 계정은 키 10개와 웹훅 엔드포인트 5개를 가질 수 있으며 전체 합산 한도는 분당 요청 300건입니다.

자메이카 경로에서는 어떤 앱이 코드를 받을 수 있나요?

자메이카에는 현재 900개가 넘는 서비스가 등록되어 있습니다. 자주 쓰이는 서비스는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Snapchat, Amazon, Uber, Netflix, Airbnb, ChatGPT (OpenAI)입니다.

서비스별 이용 가능 여부는 하루 중에도 달라지므로, 목록을 코드에 고정하지 말고 매 실행 시작 시 가격 엔드포인트를 조회하세요.

비개발자는 대시보드에서 같은 체크리스트를 어떻게 따라 하나요?

/signup에서 이메일 코드 또는 Google로 계정을 만들고, TOTP를 활성화한 뒤 충전하세요. 그다음 OTP Gateway를 열어 서비스와 자메이카를 선택하고 실시간 가격을 확인합니다. 번호를 앱에 붙여 넣으면 문자가 도착했을 때 코드가 대시보드에 나타납니다. 지원 담당자들은 이 방법으로 고객이 겪은 자메이카 번호 가입 문제를 재현하곤 합니다.

문제 해결: 자메이카 코드가 늦거나, 없거나, 거부되는 경우

• 입력 단계에서 거부되나요? 먼저 자사 양식을 확인하세요. 미국 전용 검증기가 흔한 원인입니다. 외부 앱 자체가 번호를 거부한다면 가상 번호를 허용하지 않는 것일 수 있습니다.
• 아직 아무것도 없나요? 취소하고 다시 주문하지 말고 20분 동안 활성화를 열어 두세요.
• 그래도 없나요? 나중에 다시 시도하거나 다른 서비스 경로를 사용해 보세요. 같은 주문을 반복문으로 계속 보내지 마세요.

창이 끝나기 전에 번호로 SMS가 도착하지 않으면 결제 금액 전액이 지갑으로 자동 환불됩니다. OTP 전달 실패 줄이기 가이드에 더 긴 체크리스트가 있습니다.

전용 회선, 지갑, 샌드박스는 자메이카에도 적용되나요?

+1 국가 코드를 공유한다고 해서 자메이카가 전용 번호 상품에 포함되는 것은 아닙니다. 전용 가상 번호(Dedicated Virtual Number)는 미국과 캐나다에서만 월 $1.95부터 판매되며, 셀프서비스 장기 자메이카 번호는 없습니다. 필요하다면 [email protected]으로 문의하세요. 현지 규정에 따라 결정되며 보장되지는 않습니다.

그 밖의 모든 것은 다른 곳과 같습니다. 선불 USD 지갑, 월 요금 없음, 카드 또는 USDT/USDC 충전, 충전마다 이메일로 PDF 인보이스가 발송됩니다. 요청하면 이용할 수 있는 샌드박스 모드는 통합 테스트용 시뮬레이션 번호와 코드를 반환합니다. 요금 방식은 /pricing을 참고하세요.

자주 묻는 질문

킹스턴에 있지 않아도 앱의 자메이카 전화번호 인증을 테스트할 수 있나요?

네. 팀이 어디에 있든 OTP Route에서 서비스용 +1 876 또는 +1 658 번호를 주문하고 대시보드나 API에서 코드를 읽으면 됩니다.

자메이카는 어떤 국가 ID를 보내야 하나요?

jm을 보내세요. 국가 코드는 +1이지만 API는 이 ID로 국가를 식별합니다.

자메이카 번호도 미국 번호로 취급되나요?

아니요. +1 코드를 공유하긴 하지만 고유한 지역 번호를 가진 별개의 국가이며, 많은 앱이 자메이카로 취급합니다.

자메이카 코드가 오지 않으면 돈은 어떻게 되나요?

20분 안에 SMS가 도착하지 않거나 취소하면 전액이 지갑으로 돌아갑니다.

OTP Route에서 자메이카 장기 번호를 구매할 수 있나요?

셀프서비스로는 불가능합니다. 장기 전용 번호는 미국과 캐나다만 지원하므로, 자메이카에 대해서는 지원팀에 이메일로 문의하세요.

비용을 들이지 않고 웹훅 흐름을 테스트할 방법이 있나요?

개발 계정에 샌드박스 모드를 요청하세요. 시뮬레이션된 번호와 코드가 반환되며, 핸들러 쪽은 웹훅 기반 OTP 수신 글에서 설명합니다.

테스트에 +1 자메이카 번호를 어떤 용도로 사용할 수 있나요?

자사 제품 테스트, QA 자동화, 합법적인 비즈니스 계정 운영입니다. 카리브해 경로도 OTP Route 허용 사용 정책(Acceptable Use Policy)뿐 아니라 각 앱의 자체 약관을 따라야 합니다.

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