신트마르턴(+1 721) 인증 테스트를 위한 사전 점검 체크리스트

시작하기 전에: +1 721 테스트에서 확인할 것

신트마르턴은 북미 번호 체계(NANP) 안에 있으며, 이 점이 작은 규모에 비해 많은 테스트 스위트를 헷갈리게 합니다. 먼저 이 목록을 확인하세요.

• 지역 감지. +1 721로 시작하는 번호는 미국이 아니라 신트마르턴 번호입니다. 전화번호 라이브러리가 이를 지역 SX로 매핑하는지 확인하세요.
• 형식. E.164는 +1721에 7자리를 붙인 형태이며, 현지에서는 (721)과 7자리 번호로 씁니다. 입력에서 공백, 괄호, 대시를 제거하세요.
• 국가 목록. 국가 선택기에 신트마르턴이 섬의 프랑스령인 +590을 쓰는 생마르탱과 별도로 나타나는지 확인하세요.
• 문구와 언어. 네덜란드어와 영어가 공용어이며 일상 언어는 영어여서, 코드는 보통 영어로 옵니다.
• 서비스 가용 여부. 테스트하는 앱이 이 경로의 실시간 목록에 있는지 확인하세요.

신트마르턴 번호로 코드를 받을 수 있는 서비스는 무엇인가요?

현재 스냅샷에는 WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), Airbnb, Uber, Amazon, Netflix, Telegram, TikTok, Snapchat, eBay, Microsoft & Outlook이 포함되어 있어, 관광 중심의 섬을 위해 흐름을 점검하는 여행·숙박 팀에 적합합니다. 이 경로는 전체적으로 200개가 넘는 서비스를 지원합니다.

큰 시장보다 카탈로그가 좁고 자주 바뀝니다. 실행 전에 GET /api/v1/countries와 GET /api/v1/services를 조회하세요. 서비스가 없으면 퀴라소나 앵귈라 같은 인근 카리브해 경로가 시나리오에 맞는지 확인해 볼 만합니다.

단계별 안내: API로 +1 721 번호 주문하기

1. 개발자 콘솔에서 키(or_live_로 시작)를 생성하고 Bearer 토큰으로 https://otproute.com/api/v1에 보냅니다.
2. 가격을 읽습니다: GET /api/v1/prices?country=sx&service=airbnb.
3. 주문합니다: POST /api/v1/activations에 {"service": "airbnb", "country": "sx"}.
4. 반환된 번호를 앱의 인증 화면에 입력합니다.
5. activation.sms_received 웹훅에서 코드를 받거나 GET /api/v1/activations/{id}를 폴링합니다.
6. X-OTPRoute-Signature(엔드포인트 시크릿으로 계산한 <t>.<raw body>의 HMAC-SHA256)를 검증하고 오래된 타임스탬프는 거부합니다.

규모가 작은 카리브해 경로에서는 계정 한도에 걸리는 일이 드물지만, 한도는 키 10개, 웹훅 엔드포인트 5개, 분당 300건입니다. CI 패턴은 CI 파이프라인에서의 OTP 테스트와 문서를 참고하세요.

단계별 안내: 개발자가 아닌 사람을 위한 대시보드 방법

지원 담당자와 마케터도 코드 없이 같은 일을 할 수 있습니다. 로그인해서 신트마르턴과 서비스를 고르고 주문을 누르세요. 번호를 앱에 복사한 뒤 대시보드를 열어 두면, 코드가 도착하는 대로 그곳에 나타납니다. 가격은 확정 전에 표시됩니다.

이 방법은 일회성 점검에 편리합니다. 예를 들어 릴리스 후에도 호텔 파트너 직원 계정이 신트마르턴 번호로 인증되는지 확인할 때, 엔지니어링 팀에 스크립트를 부탁하지 않아도 됩니다.

신트마르턴 코드가 오지 않을 때의 문제 해결

활성화마다 20분의 창이 있습니다. 그 시간 안에 아무것도 오지 않거나 POST /api/v1/activations/{id}/cancel로 취소하면 전액이 자동으로 지갑에 환불됩니다.

• 시도를 실패로 보기 전에 창에 시간을 주세요.
• 서비스가 가상 번호를 허용하는지 확인하세요. 거부하는 서비스도 있습니다.
• 반복해서 재주문하지 말고 나중에 다시 시도하거나 다른 서비스 경로를 쓰세요.
• 앱이 발송 전에 번호를 거부했다면 지역 감지를 살펴보세요. 모든 +1 번호가 미국이나 캐나다라고 가정하는 검증기는 여기서 오작동합니다.

+1 721이면 전용 번호를 쓸 수 있다는 뜻인가요?

아닙니다. +1 접두어를 공유한다고 해서 신트마르턴이 전용 번호(Dedicated Numbers) 프로그램에 포함되는 것은 아닙니다. 장기 회선은 미국과 캐나다에서만 셀프서비스로 판매하며, 월 $1.95부터 시작하고 수신 SMS, 웹훅 전달, 브라우저 통화를 제공합니다. 자세한 내용은 가상 번호에 있습니다. 신트마르턴에는 셀프서비스 장기 회선이 없습니다. [email protected]으로 문의할 수는 있지만, 가능 여부는 현지 규정에 달려 있습니다.

결제와 샌드박스

OTP Route는 월 이용료 없는 선불 USD 지갑 하나를 사용합니다. 카드나 USDT/USDC로 충전하며, 충전할 때마다 이메일로 PDF 인보이스가 옵니다. 개발 계정은 요청 시 샌드박스로 전환해 시뮬레이션 번호와 코드로 연동을 테스트할 수 있습니다.

번호는 본인의 제품과 정당한 비즈니스 계정에만 사용하고, 각 서비스의 약관을 따르며, 이용 정책(Acceptable Use Policy) 범위 안에서 사용하세요.

자주 묻는 질문

+1 721 번호는 미국 번호로 취급되나요?

아닙니다. 북미 번호 체계 안에서 신트마르턴의 지역 번호이며, 검증기는 이를 지역 SX로 분류해야 합니다.

OTP Route는 신트마르턴에 어떤 국가 id를 쓰나요?

id는 sx이며, POST /api/v1/activations 같은 호출에서 사용합니다.

현지 SIM 없이 내 예약 앱의 신트마르턴 가입을 테스트할 수 있나요?

네. 해당 서비스용 임시 +1 721 번호를 주문해 입력하고, 대시보드나 API로 코드를 확인하세요.

신트마르턴의 서비스 목록이 다른 나라보다 짧은 이유는 무엇인가요?

작은 경로의 커버리지는 자주 바뀝니다. API나 대시보드에서 실시간 목록을 확인하고, 필요하면 인근 경로를 고려하세요.

신트마르턴 번호로 코드가 오지 않으면 요금을 내나요?

아니요. SMS 없이 20분 창이 끝나거나 취소하면 전액이 지갑으로 돌아갑니다.

신트마르턴 인증 번호는 얼마인가요?

요금은 $0.20/코드부터이며 서비스에 따라 다릅니다. 주문 전에 API가 정확한 금액을 반환합니다.

섬의 프랑스령도 같은 경로로 지원되나요?

아니요. 생마르탱은 별도의 번호 구역인 +590을 쓰므로 테스트에서 다른 국가로 취급하세요.

앱의 전화번호 입력란은 (721)과 7자리로 입력한 번호를 받아야 하나요?

네. 현지 형식을 받아들인 다음 저장하거나 보내기 전에 +1721과 7자리로 정규화하세요.

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