API 또는 대시보드로 뉴질랜드 SMS OTP 코드 받기

임시 +64 번호와 장기 회선 중 어느 쪽이 필요할까요?

먼저 알맞은 제품을 고르면 나중에 다시 작업할 일이 줄어듭니다.

OTP Gateway는 테스트나 온보딩 단계에서 코드가 딱 한 번 필요할 때 적합합니다. 새 QA 계정 생성, 뉴질랜드 가입 화면 스모크 테스트, 현지 고객의 흐름이 끝까지 동작하는지 확인하는 경우가 그렇습니다. 번호를 받고, 코드를 한 번 받으면 세션이 종료됩니다.

Dedicated Number는 같은 계정이 몇 주 뒤에 다시 로그인해야 하거나 팀이 복구용 번호를 공유해야 할 때 선택합니다. 이런 장기 회선은 미국과 캐나다에서만 제공되며 월 $1.95부터 시작하고, 수신 SMS는 number.sms_received 이벤트로 전달됩니다.

뉴질랜드에는 셀프서비스 장기 번호가 없습니다. 꼭 필요한 경우 [email protected]으로 문의해 주세요. 현지 규정에 따라 어려울 수도 있습니다. 북미 회선의 통화, 발신 SMS, 갱신 조건은 가상 번호 페이지에서 확인하실 수 있습니다.

제품 팀은 왜 뉴질랜드에서 가입 테스트를 할까요?

뉴질랜드는 영어 앱의 소프트 런칭 시장으로 자주 선택됩니다. 규모가 작은 사용자층, 익숙한 언어, 빠른 시간대 덕분에 본격 출시 전에 실제 온보딩을 관찰하기 좋습니다. 그래서 +64 인증 단계는 새 시장이 처음 거치는 실제 운영 경로가 되는 경우가 많고, 별도의 테스트 케이스를 둘 가치가 있습니다.

다음 사항을 점검해 보세요.

• 언어. 영어, 마오리어(te reo Māori), 뉴질랜드 수어가 공용어입니다. 대부분의 서비스는 영어로 코드를 보내지만, 자체 템플릿에 장음 부호가 붙은 마오리어 단어(ā, ō, ū)를 쓰면 GSM-7 범위를 벗어나 SMS가 UCS-2로 전환되고 세그먼트당 글자 수가 줄어듭니다.
• 날짜 경계. 뉴질랜드는 새 날짜를 가장 먼저 맞이하는 지역 중 하나라서, 날짜 기준으로 만료나 호출 제한을 처리하는 로직이 현지 사용자에게는 다르게 동작할 수 있습니다.
• 시장 적합성. 현지 번호로 인증한 QA 계정은 뉴질랜드 사용자가 거칠 국가별 로직을 그대로 점검합니다.

이런 점검을 바탕으로 한 릴리스 게이트 패턴은 QA 테스트 문서를 참고하세요.

+64 휴대폰 번호는 어떻게 저장하고 정규화해야 하나요?

뉴질랜드는 국내 접두번호로 0을 사용합니다. 국내 표기가 021 123 4567인 휴대폰 번호는 E.164에서 +64211234567이 됩니다. 앞의 0을 빼고 +64를 붙이면 됩니다. 0을 뗀 뒤 휴대폰 대역은 2로 시작하고 자릿수는 일정하지 않으므로 자릿수를 하나로 고정하지 마세요.

스키마를 설계할 때의 실무 규칙은 다음과 같습니다.

• 표준 E.164 문자열 하나만 저장하고, 표시 형식은 화면에 그릴 때만 적용합니다.
• 공백, 하이픈, 국내 0이 섞인 입력도 받아들인 뒤 검증된 전화번호 파싱 라이브러리로 정규화합니다.
• 국내 표기와 국제 표기를 모두 테스트 픽스처에 넣고, 사용자가 +64 뒤에 0을 그대로 붙여 넣은 번호도 포함하세요.

OTP Route에서 뉴질랜드 번호로 코드를 보내는 앱은 무엇인가요?

+64 경로에서는 800개가 넘는 서비스를 지원합니다. 현재 기준으로 자주 쓰이는 서비스는 Google (Gmail & YouTube), WhatsApp, Telegram, Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord, Snapchat, LinkedIn, Uber, Netflix 등입니다.

가용 여부는 실시간으로 바뀌므로 목록을 몇 주씩 캐시하지 말고 실행을 시작할 때마다 GET /api/v1/countries와 GET /api/v1/services를 조회하세요. 특정 서비스의 +64 경로가 부족하면 이웃한 호주 경로가 영어권 비교 테스트의 일반적인 대안입니다.

뉴질랜드 OTP API 호출 순서는 어떻게 되나요?

모든 +64 호출은 개발자 콘솔에서 발급받은 or_live_ Bearer 키로 https://otproute.com/api/v1에 보냅니다. 순서는 다음과 같습니다.

1. GET /api/v1/prices?country=nz&service=uber로 실시간 가격을 확인합니다.
2. POST /api/v1/activations에 본문 {"service": "uber", "country": "nz"}를 담아 활성화를 생성합니다.
3. GET /api/v1/activations/{id}를 폴링해 코드를 가져오거나, activation.sms_received 이벤트가 웹훅으로 오도록 합니다. activation.expired와 activation.cancelled는 정리 시점을 알려 줍니다.
4. 쓰지 않는 주문은 POST /api/v1/activations/{id}/cancel로 취소하고, 잔액은 GET /api/v1/balance로 확인합니다.

웹훅에서는 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산해 X-OTPRoute-Signature를 검증하고, 오래된 타임스탬프는 거부하며, 재전송이 와도 문제가 없도록 활성화 id 기준으로 멱등하게 처리하세요. 더 자세한 설명은 연동 가이드에 있으며, 제한은 계정당 분당 300건입니다.

개발자가 아니어도 뉴질랜드 인증 번호를 주문할 수 있나요?

물론입니다. 대시보드에서 뉴질랜드를 선택하고 서비스를 고른 뒤 표시된 가격을 확인하고 주문을 확정하세요. 주문 카드에 +64 번호가 나타나면 앱에 입력하고 SMS를 요청하세요. 코드가 도착하면 같은 카드에 표시됩니다. 모든 과정은 20분 안에 이루어져야 하므로 주문 전에 대상 앱을 미리 열어 두세요.

+64 코드가 도착하지 않으면 어떻게 하나요?

일부 발신자는 SMS를 늦게 보내거나 모아서 보내므로 먼저 20분을 모두 기다려 주세요. 그래도 비어 있다면 해당 서비스가 가상 번호를 거부하거나 그 경로가 혼잡할 수 있습니다. 새 주문을 연달아 넣지 말고 나중에 다시 시도하거나 다른 서비스 경로로 테스트하세요. 응답이 없던 주문과 직접 취소한 주문은 지갑으로 자동 환불됩니다. 결제는 선불 USD 지갑에서 사용한 만큼만 내는 방식이며, 카드나 USDT/USDC로 충전하고 충전마다 PDF 인보이스가 발급됩니다. 월 이용료는 없고, 요청하시면 리허설용 샌드박스 모드도 사용할 수 있습니다. OTP Route는 본인의 정당한 계정과 제품을 위한 서비스이며, 각 서비스의 약관과 당사의 이용 정책을 따라 주세요.

자주 묻는 질문

현지 SIM 없이 우리 앱의 뉴질랜드 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 +64 번호를 주문해 가입 양식에 입력하고, 대시보드나 API로 코드를 확인하면 됩니다.

뉴질랜드 휴대폰 번호를 저장할 때 0을 유지해야 하나요?

아니요. E.164에서는 국내 접두번호 0을 제거하므로 021 123 4567은 +64211234567로 저장합니다.

뉴질랜드의 API 국가 id는 무엇인가요?

nz입니다. 가격 조회와 활성화 요청 본문에서 사용합니다.

뉴질랜드 인증 코드는 얼마인가요?

코드당 $0.20부터 시작하며 서비스에 따라 다릅니다. 주문 전에 대시보드와 GET /api/v1/prices에서 정확한 금액을 확인할 수 있습니다.

뉴질랜드 번호를 몇 달 동안 빌릴 수 있나요?

셀프서비스 장기 +64 회선은 없습니다. Dedicated Number는 미국과 캐나다 전용 제품이며, 다른 국가는 [email protected]으로 문의하실 수 있습니다.

+64 코드를 받을 때 폴링과 웹훅 중 무엇이 더 좋은가요?

스크립트 하나라면 폴링이 더 간단하고, 테스트 작업이 많이 병렬로 돌 때는 서명된 웹훅이 확장성이 좋습니다. 두 방식 모두 같은 코드를 반환합니다.

모든 앱이 뉴질랜드 OTP Route 번호를 받아 줄까요?

그렇지는 않습니다. 일부 서비스는 가상 번호를 거부하며, 그래서 SMS가 오지 않은 주문은 자동으로 환불됩니다.

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