네팔 SMS OTP 코드 수신: +977 테스트를 위한 준비, 단계, 해결법

사전 점검: 네팔 번호를 요청하기 전에 무엇을 준비해야 하나요?

짧은 준비 과정을 거치면 나중에 헷갈리는 디버깅을 크게 줄일 수 있습니다. 첫 주문 전에 다음을 갖추세요.

1. 자격 증명. 개발자 콘솔에서 or_live_ 키를 생성해 Bearer 토큰으로 전송합니다. 로컬 개발, CI, 프로덕션 도구에 각각 별도의 키를 쓰면 교체가 수월합니다.
2. 국가 및 서비스 id. 네팔은 np입니다. 서비스 id는 GET /api/v1/services로 조회하세요.
3. 자금 또는 샌드박스. GET /api/v1/balance를 확인하거나, 개발 계정을 샌드박스로 전환해 달라고 요청해 시뮬레이션 번호와 코드로 무료로 연동을 테스트하세요.
4. 수신 방식 선택. 테스트 하네스를 작성하는 도중이 아니라 작성하기 전에 웹훅 엔드포인트와 폴링 중 하나를 정하세요.
5. 유니코드를 지원하는 수신함 보기. 네팔어 템플릿의 코드는 데바나가리 문자로 도착하므로, 로그에도 올바르게 표시되어야 합니다.

이 모델이 처음이라면 OTP 게이트웨이란 무엇인가에서 몇 분 만에 배경을 파악할 수 있습니다.

어떤 앱이 +977 회선으로 코드를 보낼 수 있나요?

현재 1,700개가 넘는 서비스를 네팔로 라우팅할 수 있습니다. 인기 서비스로는 Viber, WhatsApp, Facebook, Instagram, TikTok, Telegram, Google(Gmail & YouTube), Microsoft & Outlook, Discord, Signal, imo, Amazon, Claude 등이 있습니다.

이 목록은 스냅샷일 뿐 약속이 아닙니다. 가용성은 하루 중에도 바뀌므로, GET /api/v1/prices?country=np&service=<id>가 테스트에 필요한 정확한 조합의 실시간 가격과 가용성을 반환합니다.

단계별 안내: API로 네팔 SMS OTP 받기

준비 목록을 마쳤다면 네팔 OTP API 흐름은 많아야 다섯 번의 호출로 끝납니다.

1. np와 서비스의 실시간 가격을 확인합니다.
2. {"service": "<id>", "country": "np"} 본문과 함께 POST /api/v1/activations로 활성화를 만듭니다. 반환된 활성화 id를 보관하세요. 이후 모든 것의 키가 됩니다.
3. 테스트 중인 흐름에 +977 번호를 입력하고 SMS를 발송시킵니다.
4. activation.sms_received 웹훅으로 코드를 수집하거나, 호출 사이에 적당한 지연을 두고 GET /api/v1/activations/{id}를 폴링합니다.
5. 테스트가 일찍 중단되면 POST /api/v1/activations/{id}/cancel로 취소합니다.

웹훅 쪽에서는 요청을 신뢰하기 전에 X-OTPRoute-Signature를 검증하세요. <t>.<raw body>를 만들어 엔드포인트 시크릿으로 HMAC-SHA256 서명하고 v1과 비교하며, 오래된 타임스탬프는 거부합니다. 그런 다음 재전송된 이벤트가 문제를 일으키지 않도록 활성화 id 기준으로 upsert하세요. 전체 패턴은 웹훅 기반 OTP 캡처에 나와 있습니다.

코딩보다 클릭이 편하신가요? OTP Route 대시보드에서 네팔과 서비스를 고르고 표시된 가격을 수락하면 타이머와 함께 번호가 나타나며, 코드는 같은 화면에 표시됩니다.

네팔 휴대폰 번호 형식 점검

네팔 휴대폰 번호는 열 자리이고 9로 시작하며 보통 98 또는 97입니다. 국내에서 유선 전화는 트렁크 0과 지역 번호로 다이얼하지만, 그 0은 국제 형식에 들어가지 않습니다. 따라서 테스트 레코드는 +97798xxxxxxxx처럼 보여야 합니다.

검증 테스트에서 확인할 만한 항목은 다음과 같습니다.

• 사용자가 앞에 0을 붙여 입력하면 +977 뒤에서 그 0이 제거되는지.
• 접두사 없이 열 자리 휴대폰 번호를 입력해도 허용되어 E.164로 정규화되는지.
• 사용자가 연락처 카드에서 붙여 넣은 공백과 대시가 저장 전에 정리되는지.

SMS 내용도 점검할 가치가 있습니다. 네팔어는 데바나가리 문자로 쓰며, 데바나가리 메시지는 유니코드로 전송되어 일반 라틴 문자보다 세그먼트당 훨씬 적은 글자가 들어갑니다. 인증 템플릿을 현지화했다면, 주변 문구 때문에 코드가 분할 지점을 넘지 않고 한 세그먼트에 도착하는지 확인하세요. 많은 서비스가 영어 템플릿을 그대로 보내므로 두 경우를 모두 테스트하세요.

팀이 네팔 시장을 위해 개발하고 테스트하는 이유

네팔은 규모에 비해 더 많은 제품에 중요합니다. 네팔 노동자의 상당수가 해외에 살기 때문에, 걸프 지역과 말레이시아 등 송금 경로를 다루는 송금, 지갑, 메시징 제품은 여전히 +977 번호를 가진 사용자를 인증해야 하는 경우가 많습니다. Viber와 WhatsApp 같은 메시징 앱은 현지 일상 소통의 일부입니다.

팀이 테스트용 +977 번호를 주문하는 경우는 다음과 같습니다.

• 네팔 사용자를 위한 가입 흐름을 출시하면서 국가 선택기에 올바른 입력 마스크와 함께 나타나는지 증명해야 할 때.
• 온보딩과 복구 화면의 네팔어 문자열을 점검할 때.
• 로그인 코드가 오지 않았다는 해외 거주 고객의 제보를 재현할 때.

앱 팀이 이런 국가 커버리지를 어떻게 구성하는지는 모바일 앱 인증 페이지에서 볼 수 있습니다.

문제 해결: 코드가 도착하지 않았을 때

코드가 오지 않는 데에는 몇 가지 흔한 원인이 있으며, 해결책이 곧바로 다시 주문하는 것인 경우는 드뭅니다.

• 먼저 인내심. 활성화에 20분을 모두 주세요. 대기열에 있던 문자도 늦게 도착하는 경우가 있습니다.
• 가상 번호 정책. 일부 서비스는 가상 번호를 거부합니다. 그런 경우 활성화는 그냥 만료되고 환불이 지갑에 들어옵니다.
• 라우트 선택. 한 곳만 몰아치지 말고 나중에 시도하거나 같은 서비스의 다른 라우트를 이용하세요.
• 요청 속도 관리. 촘촘한 루프로 재주문하면 분당 300건 한도를 소진하고 도움이 되는 경우도 드뭅니다.
• 자체 앱. SMS 요청이 실제로 발송되었는지 로그의 나가는 요청에서 확인하세요.

activation.expired 이벤트는 아무것도 오지 않았고 아무것도 청구되지 않았다는 깔끔한 신호입니다.

장기 회선과 네팔 라우트 결제

OTP Route는 셀프서비스 네팔 장기 번호를 제공하지 않습니다. 전용 번호는 미국과 캐나다에서만 월 $1.95부터 제공됩니다. 팀에 지속적인 +977 회선이 필요하다면 [email protected]으로 문의하세요. 마련할 수 있는지는 현지 규정에 따라 달라지며 어떤 것도 보장되지 않습니다.

결제는 하나의 선불 USD 지갑에서 쓴 만큼 지불하는 방식이며, 카드 또는 USDT나 USDC로 충전하고, 충전할 때마다 PDF 인보이스가 이메일로 발송되며 월 요금은 없습니다. 요금이 표시되는 방식은 요금제에서, 이메일 코드 또는 Google로 계정을 만들려면 가입에서 확인하세요.

자주 묻는 질문

네팔 SIM 카드 없이 네팔 OTP를 받을 수 있나요?

네. OTP Gateway가 1회 인증용 +977 번호를 발급하며, 코드는 대시보드나 API에서 읽을 수 있습니다.

API는 네팔의 국가 코드로 무엇을 요구하나요?

가격 및 활성화 요청에서 국가로 np를 보내세요.

네팔 번호를 저장할 때 앞의 0을 유지해야 하나요?

아니요. 트렁크 0을 빼고 +977 뒤에 번호를 붙인 E.164 형식으로 저장하세요.

네팔어 코드가 대시보드에 올바르게 표시되나요?

메시지는 수신된 그대로 표시됩니다. 코드를 안정적으로 추출할 수 있도록 자체 로그와 테스트 단언문이 데바나가리 텍스트를 처리하는지 확인하세요.

네팔 코드가 끝내 오지 않으면 내 돈은 어떻게 되나요?

아무것도 청구되지 않습니다. 20분 동안 SMS가 오지 않은 활성화나 직접 취소한 활성화는 별도 요청 없이 지갑으로 전액 환불됩니다.

나중에 로그인할 때 같은 +977 번호를 다시 쓸 수 있나요?

아니요. 각 OTP Gateway 번호는 코드 하나를 위한 것입니다. 나중에 다시 로그인해야 하는 계정에는 전용 번호가 적합하지만 미국과 캐나다에서만 제공됩니다.

네팔 인증 번호에 이용 규칙이 있나요?

네. 각 서비스의 약관과 이용 정책(Acceptable Use Policy)을 지키고, 본인의 합법적인 제품과 계정을 테스트하거나 운영하는 용도로만 번호를 사용하세요.

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