부탄의 +975 인증 코드를 테스트 스위트에 연결하기

제품 팀이 부탄 번호를 원하는 이유는 무엇인가요?

부탄은 작은 시장이지만 생각보다 많은 로드맵에 등장합니다. 히말라야를 찾는 방문객을 위한 여행·숙박 예약 흐름, 해외에서 공부하거나 일하는 가족을 둔 부탄 가정이 쓰는 결제·송금 앱, 남아시아 전역에 동시에 출시하는 지역 앱 등이 그 예입니다. +975 가입이 실제로 완료되는지 입증해야 하는 QA 엔지니어는 본국 SIM으로는 그 일을 할 수 없습니다.

국어는 종카어이며, 영어는 학교, 정부, 비즈니스에서 널리 쓰입니다. 부탄 경로에서 보게 될 인증 문자는 대부분 짧은 영어 템플릿이지만, 제품이 종카어로 현지화된다면 출시 전에 자사 SMS 문구가 제대로 표시되는지 확인하세요.

운영 측면도 있습니다. 팀푸나 파로에서 프로젝트를 운영하는 여행사, NGO, 컨설팅 회사는 직원이 개인 휴대폰을 넘기지 않도록 공용 업무 도구를 부탄 번호로 등록하기도 합니다. 이런 일회성 확인에는 대개 게이트웨이 활성화 한 번이면 충분합니다.

어떤 앱이 +975 경로로 코드를 보낼 수 있나요?

현재 부탄의 실시간 목록은 1,700개가 넘는 서비스를 포함합니다. 자주 요청되는 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Viber, WeChat, Microsoft & Outlook, Amazon, Airbnb, Uber 등이 있습니다.

이 경로의 사용 가능 여부는 하루 중에도 바뀌므로 어떤 목록이든 스냅샷으로 보세요. 지난주에 있던 목록을 하드코딩하지 말고, 주문 전에 코드에서 GET /api/v1/services와 GET /api/v1/countries를 호출하세요.

국가 id `bt`의 호출 순서는 어떻게 되나요?

1. https://otproute.com/api/v1에서 개발자 콘솔로 만든 Bearer 키(접두사 or_live_)로 인증합니다.
2. GET /api/v1/prices?country=bt&service=<id>로 해당 조합의 실시간 가격을 확인합니다.
3. POST /api/v1/activations에 {"service": "<id>", "country": "bt"} 본문을 보내 주문합니다.
4. GET /api/v1/activations/{id}를 폴링하거나 activation.sms_received, activation.expired, activation.cancelled를 구독합니다.
5. 필요 없는 번호는 POST /api/v1/activations/{id}/cancel로 해제합니다.

웹훅 요청에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 "<t>.<raw body>"에 대한 HMAC-SHA256을 계산하고 오래된 타임스탬프는 버리세요. 웹훅 수신 가이드는 전체 핸들러를 안내하고, API 문서에는 모든 필드가 나와 있습니다.

계정 하나당 API 키는 최대 10개, 웹훅 엔드포인트는 최대 5개를 보유할 수 있고 분당 300건까지 요청할 수 있으므로, 이처럼 작은 시장을 대상으로 한 야간 회귀 테스트에는 충분합니다. 더 느린 주기라면 몇 초마다 확인하는 폴링 루프가 구성 요소를 가장 적게 유지하는 방법입니다.

+975 번호는 어떻게 저장해야 하나요?

하나의 표준 형식을 유지하세요. +975 뒤에 국내 번호 숫자를 붙이고 공백, 대시, 괄호는 넣지 않습니다. 부탄 휴대폰 번호는 8자리로, 많은 검증기가 가정하는 10자리 패턴보다 짧으므로 더 큰 시장에 맞춰 둔 길이 검사는 완화하세요. 사용자가 습관적으로 맨 앞에 0을 입력했다면 저장 전에 제거합니다. 입력 경계에서 정규화하면 중복 제거, 사기 방지 규칙, 지원팀 조회가 일관되게 유지됩니다.

자동화 테스트용 픽스처를 작성할 때는 더 긴 해외 샘플과 함께 부탄 번호를 최소 하나 포함하세요. 그렇게 하면 팀푸의 실제 사용자가 양식이 거부되었다고 알려 오기 전까지는 드러나지 않는 길이 오류를 미리 잡을 수 있습니다.

부탄 코드가 오지 않으면 어떻게 하나요?

• 20분 활성화 시간이 끝나기를 기다리세요. 일부 발신자는 메시지를 대기열에 쌓아 둡니다.
• 대상 앱이 가상 번호를 받는지 확인하세요. 일부 앱은 거부합니다.
• 주문 엔드포인트를 반복 호출하지 말고, 잠시 후 다시 시도하거나 다른 서비스 경로를 선택하세요.

아무것도 수신하지 못한 번호에는 비용이 들지 않으며, 환불은 자동입니다. 더 많은 방법은 OTP 인증 실패 줄이기에 있습니다.

활성화 id를 자체 테스트 실행 id와 함께 기록해 두면, 코드가 누락되었을 때 추측하지 않고 몇 초 만에 추적할 수 있어 도움이 됩니다.

장기 회선, 결제, 샌드박스

OTP Route에는 부탄의 셀프 서비스 장기 번호가 없습니다. 전용 회선은 월 $1.95부터 시작하는 미국·캐나다 전용 상품입니다. 부탄 회선이 필요하면 [email protected]으로 이메일을 보내실 수 있으나, 가능 여부는 현지 규정에 따릅니다. 모든 결제는 월 요금 없는 선불 USD 지갑으로 이루어지며, 카드 또는 USDT/USDC로 충전하고 충전할 때마다 PDF 인보이스가 발급됩니다. 개발 계정은 샌드박스 모드를 요청해 모의 번호로 bt 전체 흐름을 미리 연습할 수 있습니다. 지갑 작동 방식은 요금제를 참고하세요.

자주 묻는 질문

현지 SIM 없이 내 앱의 부탄 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 서비스용 +975 번호를 주문하고, 앱에서 코드를 발생시킨 뒤 대시보드나 API에서 확인하세요.

API에서 부탄의 국가 id는 무엇인가요?

부탄은 bt입니다. 가격 조회 쿼리와 활성화 요청 본문에 이 값을 전달하세요.

부탄 인증 코드 하나는 얼마인가요?

부탄 코드는 $0.20 이상이며 서비스에 따라 요금이 다릅니다. 확정하기 전에 GET /api/v1/prices가 정확한 금액을 반환합니다.

부탄의 OTP 메시지는 보통 어떤 언어로 오나요?

대부분 영어입니다. 영어는 부탄의 비즈니스와 교육에서 흔히 쓰입니다. 국어는 종카어이므로, 종카어로 발송한다면 자체 현지화 템플릿을 테스트하세요.

+975 번호가 아무것도 받지 못하면 요금이 부과되나요?

아니요. 20분 안에 SMS가 도착하지 않거나 먼저 취소하면 전액이 지갑으로 자동 환불됩니다.

반복 로그인을 위해 부탄 번호를 계속 보유할 수 있나요?

셀프 서비스로는 불가능합니다. 장기 번호는 미국과 캐나다에서만 제공되며, 부탄에 대해서는 팀에 이메일로 문의하세요.

부탄 번호로 계정을 여러 개 만들어도 되나요?

아니요. OTP Route는 본인의 정당한 제품을 테스트하고 운영하는 용도로만 사용하고, 각 서비스의 약관을 따르며, 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요.

지갑에서는 어떤 결제 수단을 지원하나요?

카드와 USDT 또는 USDC 스테이블코인을 지원합니다. 사용한 만큼만 결제하며 선택할 요금제는 없습니다.

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