SIM 없이 음바바네의 +268 인증 흐름을 테스트하는 방법

해외에서 +268 가입을 테스트하기 어려운 이유는 무엇인가요?

에스와티니는 작은 시장이며, 바로 그 점이 분산된 팀에게는 문제입니다. 남부 아프리카 출시의 일환으로 제품이 이미 만지니나 음바바네의 고객에게 서비스되고 있을 수 있지만, QA 팀 누구도 현지 SIM을 갖고 있지 않고, 로밍은 자동화에 믿을 만하지 않으며, 현지 동료에게 채팅으로 코드를 전달해 달라고 부탁하는 방식은 몇 번 이상 반복하기 어렵습니다.

결과적으로 전화번호 입력란의 +268 경로는 처음부터 끝까지 실행되지 못한 채 방치되곤 합니다. 이 왕국을 위한 유효성 검사 규칙, 국가 선택기, SMS 템플릿이 검증 없이 배포되고, 첫 실제 사용자가 곧 테스트 케이스가 됩니다. OTP Route는 테스트에 코드 한 건을 받을 실제 에스와티니 인증번호를 제공하고, 그 코드를 여러분의 코드로 돌려주어 이 공백을 메워 줍니다.

에스와티니 경로에서 코드를 받을 수 있는 서비스는 무엇인가요?

OTP Gateway에는 현재 에스와티니에 900개가 넘는 서비스가 올라와 있습니다. 오늘 스냅샷에서 인기 있는 서비스로는 WhatsApp, Facebook, Google (Gmail & YouTube), Instagram, TikTok, Signal, Microsoft & Outlook, LinkedIn, Uber, Amazon, imo, Netflix, ChatGPT (OpenAI) 등이 있습니다.

특정 경로의 가용성은 통신사 파트너가 용량을 추가하거나 중단함에 따라 하루 중에도 바뀌므로, 이 목록은 출발점으로만 보세요. 실시간 답은 항상 GET /api/v1/services와 GET /api/v1/countries에서 나오며, 대시보드도 자금을 쓰기 전에 같은 정보를 보여 줍니다.

에스와티니 OTP API 흐름은 코드로 어떻게 동작하나요?

Developer 콘솔에서 Bearer 키(접두사 or_live_)를 만든 뒤 기본 URL https://otproute.com/api/v1을 호출합니다. 전형적인 테스트 단계는 다음과 같습니다.

1. GET /api/v1/prices?country=sz&service=whatsapp를 호출해 해당 조합의 실시간 가격을 확인합니다.
2. 서비스와 국가 sz를 지정한 JSON 본문으로 POST /api/v1/activations를 보냅니다. 응답에는 activation id와 +268 번호가 들어 있습니다.
3. 테스트가 구동 중인 가입 양식에 그 번호를 입력합니다.
4. activation.sms_received 웹훅을 기다리거나, 코드가 나타날 때까지 GET /api/v1/activations/{id}를 폴링합니다.
5. 시나리오를 중단했다면 POST /api/v1/activations/{id}/cancel을 호출해 지갑에 즉시 환불되게 합니다.

웹훅 요청에는 X-OTPRoute-Signature 헤더가 포함됩니다. 엔드포인트 시크릿으로 타임스탬프와 원본 본문의 HMAC-SHA256을 다시 계산하고, 오래된 타임스탬프는 거부하며, 재시도가 무해하도록 모든 이벤트를 activation id 기준으로 처리하세요. 웹훅 캡처 가이드에 완성된 핸들러 예시가 있고, API 레퍼런스에 모든 엔드포인트가 정리되어 있습니다.

에스와티니 전화번호에 대해 엔지니어가 알아야 할 점은 무엇인가요?

에스와티니는 국가 번호 +268을 쓰며 국내 번호는 8자리이고 국내 접두 번호가 없어서 제거해야 할 앞자리 0이 없습니다. 그래서 정규화는 많은 시장보다 간단합니다. 값은 +268 뒤에 8자리를 붙인 E.164 형식으로 저장하고, 자릿수가 다른 입력은 SMS 제공자에 닿기 전에 거부하세요.

공용어는 시스와티어와 영어입니다. 국제 플랫폼은 보통 이 시장에도 영어로 인증 문자를 보내므로 코드 추출 정규식이 예측 가능하지만, 자체 템플릿은 현지화되어 있을 수 있으니 주변 문구가 아니라 숫자를 기준으로 검증하세요. 팀이 이곳에서 테스트하는 경우는 대개 남부 아프리카 출시에 남아프리카공화국과 함께 이 왕국이 포함될 때나, 지역 운영 직원이 현지 번호에 연결된 비즈니스 계정을 필요로 할 때입니다.

+268 코드가 오지 않으면 어떻게 하나요?

작은 경로는 큰 경로보다 조용할 수 있으므로 가끔 빈 활성화가 생길 것을 예상해 두세요.

• 20분의 활성화 시간을 끝까지 두세요. 일부 서비스는 메시지를 대기열에 쌓았다가 보냅니다.
• 수락 여부를 확인하세요. 일부 경로에서는 특정 플랫폼이 가상 번호를 거부하며, 그래서 사용되지 않은 활성화는 전액 환불됩니다.
• 나중에 다시 하거나 경로를 바꾸세요. 잠시 후 다시 시도하거나, 남아프리카공화국 같은 인근 경로에서 같은 흐름을 테스트해 보세요.
• 짧은 간격의 반복 주문은 피하세요. 실패 직후 바로 재주문해도 도움이 되는 경우가 드물고 테스트 시간만 낭비됩니다.

더 많은 진단 방법은 전달 실패 점검 목록에 있습니다.

에스와티니 번호를 장기간 보유할 수 있나요?

셀프서비스로는 불가능합니다. OTP Route의 Dedicated Virtual Numbers는 미국과 캐나다에서만 제공되며 월 $1.95부터 시작하고, 수신 SMS, 발신 SMS, 브라우저 통화를 지원합니다. 셀프서비스 장기 +268 회선은 없습니다. 운영팀에 필요하다면 [email protected]으로 이메일을 보내 주세요. 팀이 현지 규정상 가능한 범위를 확인하겠지만 이용 가능성은 보장되지 않습니다. 스테이징 계정에 반복 로그인해야 한다면 미국이나 캐나다의 전용 회선이 현실적인 대안인 경우가 많습니다.

에스와티니용 OTP 라우팅은 어떻게 청구되나요?

+268 테스트 비용은 하나의 선불 USD 잔액에서 차감됩니다. 월 청구도 없고 비교할 요금제도 없습니다. 카드 결제와 USDT/USDC 스테이블코인 모두로 충전할 수 있으며, 충전할 때마다 재무 기록용 PDF 인보이스가 이메일로 발송됩니다. 요금은 코드가 전달된 경우에만 청구됩니다. 연동 작업에는 지원팀에 개발용 계정의 샌드박스 전환을 요청하세요. 시뮬레이션된 번호와 코드가 반환되므로 지갑 잔액을 쓰지 않고 CI 스위트를 실행할 수 있습니다. 자세한 내용은 요금 페이지에 있습니다. 각 서비스의 약관을 준수해 주세요. 모든 활성화에는 OTP Route Acceptable Use Policy가 적용됩니다.

자주 묻는 질문

현지 SIM 없이 우리 앱의 에스와티니 가입을 테스트할 수 있나요?

네. 국가 sz로 활성화를 주문해 +268 번호를 양식에 입력하고, 대시보드, 폴링, 웹훅 중 하나로 코드를 읽으면 됩니다.

에스와티니 번호에서 제거해야 할 앞자리 0이 있나요?

아니요. 에스와티니에는 국내 접두 번호가 없으므로 E.164 형식은 +268 뒤에 8자리 국내 번호를 붙인 것이 전부입니다.

에스와티니 인증번호는 얼마인가요?

코드당 $0.20부터 시작하며, 서비스별 정확한 금액은 GET /api/v1/prices가 반환하고 주문 전에 대시보드에도 표시됩니다.

OTP 문자는 어떤 언어로 오나요?

대부분의 국제 서비스는 이 시장에 영어로 보내지만 문구는 플랫폼마다 다릅니다. 고정된 문장이 아니라 숫자 코드를 파싱하세요.

SMS가 실패하면 돈을 잃나요?

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

에스와티니가 조용할 때는 어느 경로를 시도해야 하나요?

많은 팀이 +268 경로가 회복되는 동안 지역 커버리지를 위해 남아프리카공화국이나 모잠비크로 대체합니다.

지갑 잔액을 쓰지 않고 CI에서 이 테스트를 실행할 수 있나요?

네. 요청 시 개발용 계정을 샌드박스로 전환할 수 있으며, 파이프라인 종단 간 테스트용으로 시뮬레이션된 번호와 코드가 반환됩니다.

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