일회용 번호일까, 장기 회선일까? 인증 테스트를 위한 +1 787 경로 선택

푸에르토리코 프로젝트에는 OTP Gateway와 Dedicated Number 중 무엇이 맞나요?

먼저 번호가 얼마나 오래 유지되어야 하는지부터 정하세요. OTP Gateway는 정확히 코드 한 건을 위한 +1 787 번호를 발급하므로 가입 테스트, 현지화 점검, 한 번 인증하고 끝나는 CI 작업에 적합합니다. Dedicated Number는 계속 보유하는 회선으로, 다음 주에 다시 로그인해야 하는 스테이징 계정이나 공용 지원 수신함에 맞습니다.

푸에르토리코는 사실상 선택이 정해져 있습니다. 푸에르토리코는 미국령이지만 번호가 셀프서비스 Dedicated Number 재고에 포함되지 않습니다. 해당 제품은 미국과 캐나다만 대상이며 월 $1.95부터입니다. 반복 계정에 미국 본토 회선을 써도 괜찮다면 가상 번호 페이지에서 옵션을 확인하세요. 푸에르토리코 장기 회선이 꼭 필요하면 [email protected]으로 문의하세요. 가능 여부는 현지 규정에 따라 다르며 보장되지 않습니다.

활성화를 만들고 읽는 푸에르토리코 OTP API 호출은 무엇인가요?

API는 https://otproute.com/api/v1에 있으며 or_live_ 접두사의 Bearer 키를 요구합니다. 푸에르토리코의 국가 ID는 pr입니다.

1. GET /api/v1/services와 GET /api/v1/countries로 ID를 가져와 배포 단위로 캐시합니다.
2. 요청 가격을 확인합니다. GET /api/v1/prices?country=pr&service=<id>는 현재 가격을 반환하고 경로가 열려 있는지 보여 줍니다.
3. POST /api/v1/activations로 주문합니다. 본문은 {"service": "<id>", "country": "pr"}입니다.
4. 반환된 번호를 테스트 중인 플로우에 입력합니다.
5. 웹훅의 activation.sms_received로 코드를 받거나 GET /api/v1/activations/{id}를 폴링합니다.
6. 작업이 일찍 끝나면 POST /api/v1/activations/{id}/cancel로 취소합니다.

웹훅 호출에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프는 거부하고, 이미 처리한 활성화 ID의 반복 이벤트는 무시하세요. 계정당 키 10개, 웹훅 엔드포인트 5개, 분당 요청 300건이 제공됩니다. 더 자세한 내용은 OTP API 연동 가이드를 참고하세요.

+1 787과 +1 939 번호는 폼에서 왜 까다로운가요?

푸에르토리코는 북미 번호 계획(NANP)에 속하므로 번호가 일반 미국 번호와 비슷합니다. 국가 코드 1, 세 자리 지역 번호(787 또는 중첩 지역 번호 939), 일곱 자리로 이루어지며 E.164로는 +1787 또는 +1939 뒤에 일곱 자리를 붙여 씁니다.

이 유사성이 실제 버그를 만듭니다. 어떤 앱은 푸에르토리코를 ISO 코드 PR의 별도 국가로 두고, 어떤 앱은 미국에 합치며, 주소 양식은 PR을 주(state) 값으로 기대하기도 합니다. 국가 선택기, 전화번호 검증기, 주소 필드가 서로 일치하는지, 푸에르토리코를 선택한 사용자에게 +1 번호가 유효하지 않다고 알리지 않는지 확인하세요. 번호는 E.164로 저장하고 지역은 앞의 +1이 아니라 지역 번호로 판단하세요.

푸에르토리코 SMS OTP 코드를 받을 수 있는 서비스는 무엇인가요?

푸에르토리코 경로는 현재 900개 이상의 서비스를 지원합니다. 인기 발신 서비스는 WhatsApp, Uber, Google(Gmail 및 YouTube), Facebook, Instagram, TikTok, X(Twitter), Amazon, ChatGPT (OpenAI), Microsoft 및 Outlook, LinkedIn, Discord, Airbnb, Netflix, Telegram 등입니다. 가용성은 하루 중에도 변하므로 어떤 목록보다 주문 시점의 API 응답을 믿으세요.

코드 없이 쓰려면 대시보드에서 OTP Gateway를 열고 푸에르토리코와 서비스를 선택한 뒤 표시된 가격을 확인하고 주문하세요. 푸에르토리코 인증 번호가 카운트다운과 함께 나타나고, SMS가 도착하면 그 옆에 코드가 표시됩니다.

20분 안에 코드가 표시되지 않으면 어떻게 하나요?

각 활성화는 20분간 유지되며, 코드가 도착한 경우에만 요금을 냅니다. 유효 시간이 비어 있는 채로 끝나거나 직접 취소하면 전액이 지갑으로 자동 환불됩니다.

푸에르토리코 코드가 도착하지 않는다면 다음을 확인하세요.

• 테스트를 실패로 처리하기 전에 활성화에 주어진 시간을 모두 기다리세요.
• 잠시 후 다시 시도하거나 다른 서비스 경로를 선택하세요.
• 서비스가 가상 번호를 허용하는지 확인하세요. 일부는 거부하며, 환불은 그런 경우를 위한 것입니다.
• 새 주문을 짧은 간격으로 반복하지 말고, 시도 사이에 지수 백오프를 두세요.

더 폭넓은 패턴은 OTP 전송 실패 줄이기를 읽어 보세요.

팀은 왜 푸에르토리코용 스페인어와 영어 플로우를 모두 검증하나요?

스페인어와 영어가 모두 공용어이며, 주민 대부분이 일상에서 쓰는 언어는 스페인어입니다. 그래서 푸에르토리코는 이중 언어 온보딩을 점검하기에 실용적인 곳입니다. 앱을 스페인어로 설정했을 때 인증 SMS가 스페인어로 오는지, 코드 입력 화면이 악센트가 있는 문구를 처리하는지, 사용자가 플로우 도중 언어를 바꾸면 올바른 템플릿이 발송되는지 확인할 수 있습니다. 섬은 미국 달러를 쓰고 많은 미국 기업이 이미 서비스하고 있어, 미국 출시를 확장하는 결제 앱, 배달 플랫폼, 마켓플레이스, 은행은 테스트용 +1 787 번호가 필요한 경우가 많습니다. 이 점검은 직접 관리하는 계정에서 수행하고, 모든 서비스의 약관을 따르며, OTP Route의 이용 정책(Acceptable Use Policy)을 지키세요. 자동화하려면 CI/CD 테스트를 참고하세요.

푸에르토리코 테스트에서 지갑과 샌드박스는 어떻게 동작하나요?

구독은 없습니다. 선불 USD 지갑 하나로 모든 주문 비용을 충당하며, 월 요금이나 선택해야 할 요금제도 없습니다. 카드 또는 USDT/USDC로 충전할 수 있고, 충전과 번호 구매마다 PDF 인보이스가 이메일로 도착합니다. 정식 사용 전에 개발 계정을 샌드박스로 전환해 달라고 요청하면 모의 번호와 코드가 반환되므로, 비용을 쓰지 않고 OTP 라우팅 전체 흐름을 미리 연습할 수 있습니다. 준비가 되면 이메일과 6자리 코드 또는 Google 로그인으로 계정을 만들고 팀에 TOTP 2단계 인증을 켜세요.

자주 묻는 질문

현지 SIM 카드 없이 푸에르토리코 가입 플로우를 테스트할 수 있나요?

네. OTP Gateway에서 +1 787 번호를 주문해 앱에 입력하고, 대시보드나 SMS 인증 API와 웹훅으로 코드를 받으세요.

API에서 푸에르토리코는 미국으로 취급되나요?

아니요. 푸에르토리코에는 별도의 국가 ID pr이 있으며, 가격 조회와 활성화 요청에서 미국 ID 대신 이를 사용합니다.

+1 787 Dedicated Number를 구매할 수 있나요?

대시보드에서는 불가능합니다. 셀프서비스 Dedicated Number는 미국과 캐나다만 지원하며, 푸에르토리코 회선은 [email protected]으로 문의하세요.

인증 SMS는 스페인어로 오나요?

발신 서비스와 앱의 언어 설정에 따라 다릅니다. 제품이 두 언어를 모두 지원한다면 스페인어와 영어 로케일을 모두 테스트하세요.

푸에르토리코 번호에서 어떤 지역 번호를 볼 수 있나요?

푸에르토리코는 787과 939를 사용합니다. 어느 쪽을 받든 E.164로 저장해 기록의 일관성을 유지하세요.

푸에르토리코 인증 코드는 얼마인가요?

코드당 $0.20부터입니다. 서비스별 정확한 가격은 GET /api/v1/prices와 대시보드에서 확인하며, 코드가 도착하지 않으면 청구되지 않습니다.

병렬 테스트는 몇 개까지 실행할 수 있나요?

계정당 분당 300건의 요청과 키 10개가 허용됩니다. 대부분의 한도가 폴링에 쓰이므로 웹훅을 쓰면 병렬 작업에 더 여유가 생깁니다.

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