문제 상황: 남수단 출시를 앞두고 팀에 현지 SIM이 없습니다
이미 동아프리카에 서비스 중인 제품이 국가 선택 목록에 남수단을 추가한다고 상상해 보세요. QA는 +211 번호가 검증을 통과하고, 코드를 받고, 사용자가 올바른 화면에 도달하는지 확인해야 합니다. 팀원 중 주바에 있는 사람은 없고, 국제 로밍은 준비하는 데 시간이 걸리며, 테스트 계정을 위해 동료의 개인 휴대전화를 빌리는 습관은 고쳐야 합니다.
원격 남수단 인증 번호는 이 문제의 좁은 부분, 즉 스크립트나 브라우저에서 요청하는 즉시 +211 회선으로 실제 코드를 한 건 받는 일을 해결합니다. 더 넓은 작업 흐름은 QA 테스트 페이지에서 다룹니다.
OTP Route는 +211 번호로 무엇을 제공하나요?
OTP Gateway는 한 번의 인증을 위한 남수단 번호를 배정합니다. 서비스와 국가를 고르고 앱에서 번호를 사용하면, 코드가 대시보드와 시스템으로 전달됩니다. activation은 20분간 열려 있으며 SMS가 도착한 경우에만 결제됩니다.
현재 스냅샷에서 남수단은 900개 넘는 서비스를 보여 주며, WhatsApp, Facebook, imo, Telegram, Instagram, TikTok, Snapchat, Viber, Signal, Google(Gmail & YouTube), X(Twitter), Uber가 포함됩니다. 재고는 하루 중 바뀌므로 이를 참고용으로 보고, 실행 전에 실시간 목록을 조회하세요.
남수단 OTP API는 코드에서 어떻게 동작하나요?
클라이언트를 https://otproute.com/api/v1로 지정하고 Developer console의 Bearer 키(or_live_…)를 사용합니다. 국가 ID는 ss입니다.
GET /api/v1/prices?country=ss&service=<id>는 해당 조합의 오늘 가격을 반환합니다.POST /api/v1/activations에{"service": "imo", "country": "ss"}를 보내면 번호가 예약됩니다.GET /api/v1/activations/{id}로 코드를 폴링할 수 있고,POST /api/v1/activations/{id}/cancel로 일찍 해제합니다.
병렬 스위트에서는 폴링보다 웹훅이 낫습니다. activation.sms_received와 activation.expired를 구독하고, X-OTPRoute-Signature(엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256)를 검증하며, 오래된 타임스탬프는 버리고, 핸들러를 activation id 기준으로 멱등하게 만드세요. 특히 파이프라인은 CI 파이프라인의 SMS OTP 테스트에 설명된 방식의 이점을 얻습니다. 계정당 키는 10개, 웹훅 엔드포인트는 5개까지 가질 수 있고, 처리량은 분당 300건 요청으로 제한됩니다.
개발자가 없나요? 대시보드를 쓰세요
- 로그인하고 OTP Gateway를 엽니다.
- 남수단을 선택한 다음 테스트하는 서비스를 선택합니다.
- 표시된 가격을 확인하고 확정한 뒤 +211 번호를 복사합니다.
- 앱에 입력하고 같은 페이지에서 코드가 오기를 기다립니다.
- 테스트가 취소되면 activation을 취소하세요. 금액은 지갑으로 돌아갑니다.
번호 형식, 언어, 현지 맥락
남수단은 2011년 독립 이후 고유한 국가 코드 +211을 받았기 때문에, 오래된 연락처 데이터나 일부 레거시 검증 라이브러리는 여전히 이상하게 동작할 수 있습니다. 휴대전화 번호는 국가 코드 뒤에 9자리입니다. 현지 다이얼용으로 쓸 때는 보통 앞에 0이 붙는데, E.164로 변환할 때 이를 제거하고 +211에 9자리를 이어서 저장하세요.
공용어는 영어이고 주바 아랍어도 널리 쓰이므로, 인증 문자는 앱의 로케일에 따라 영어 또는 아랍어로 도착할 수 있습니다. 두 템플릿과 아랍어 문구의 오른쪽에서 왼쪽 렌더링을 함께 테스트하는 것이 합리적입니다. 인도주의·물류 운영, 지역 비즈니스 계정, 해외에서 +211 번호를 유지하는 디아스포라 사용자를 위해 이곳에서 테스트하는 팀도 있습니다.
코드가 도착하지 않으면 어떻게 하나요?
- 재시도하기 전에 20분 시간 창이 끝날 때까지 기다립니다.
- 서비스가 가상 번호를 허용하는지 확인합니다. 일부는 거부합니다.
- 짧은 간격으로 반복 주문하지 말고, 나중에 다시 시도하거나 다른 서비스 경로로 바꿔 보세요.
- 웹훅 엔드포인트가 유효한 서명을 거부하고 있지 않은지 확인합니다.
만료되거나 취소된 activation은 스스로 환불되므로 별도로 청구할 것이 없습니다. 추가 아이디어는 OTP 전달 실패 줄이기에 있습니다.
장기 회선, 지갑, 샌드박스
OTP Route에는 남수단의 셀프서비스 장기 번호가 없습니다. 월 $1.95부터 시작하는 Dedicated Number는 미국과 캐나다에서만 제공됩니다. 지속적인 +211 회선이 필요하면 [email protected]으로 연락하세요. 마련할 수 있는지는 현지 규정에 달려 있습니다.
결제는 월 요금이 없는 선불 USD 지갑으로 합니다. 카드 또는 USDT/USDC로 충전하고, 충전할 때마다 PDF 인보이스를 받으며, 실시간 요금은 요금 안내 페이지에서 확인합니다. 개발용으로는 요청 시 샌드박스 모드를 활성화해 시뮬레이션된 번호와 코드를 받을 수 있어, 실제 비용을 쓰기 전에 통합을 검증할 수 있습니다.
자주 묻는 질문
남수단에 있지 않아도 남수단 SMS OTP를 받을 수 있나요?
예. OTP Gateway가 원격으로 +211 번호를 제공하며, 코드는 대시보드와 API에 나타납니다.
남수단의 API 국가 ID는 무엇인가요?
activation을 만들거나 가격을 요청할 때 ss를 사용하세요.
+211 번호를 앞의 0과 함께 저장해야 하나요?
아니요. 현지용 0을 제거하고 E.164 형식인 +211 뒤에 9자리를 붙여 저장하세요.
남수단 번호로 몇 개의 서비스가 작동하나요?
실시간 목록에는 현재 900개 넘는 서비스가 있으나, 가용성은 하루 중 변합니다.
CI 파이프라인에서 내 앱의 남수단 가입 흐름을 테스트할 수 있나요?
예. 작업에서 국가 ss로 activation을 만들고, 서명된 웹훅으로 activation.sms_received를 받아 같은 테스트 단계에서 코드를 제출하세요. 샌드박스 계정을 쓰면 지갑 자금을 쓰지 않고 이를 연습할 수 있습니다.
activation을 취소하면 어떻게 되나요?
20분 시간 창이 코드 없이 만료될 때와 마찬가지로, 전액이 자동으로 지갑에 반환됩니다.
테스트용 +211 번호는 어떤 용도로든 허용되나요?
아니요. 본인의 정당한 제품을 테스트하거나 운영하는 데만 사용하고, 각 서비스의 약관을 따르며, OTP Route Acceptable Use Policy를 지키세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.