보츠와나 활성화는 어떤 API 호출을 거치나요?
모든 것은 https://otproute.com/api/v1 아래에 있으며 or_live_로 시작하는 Bearer 키로 인증합니다. 키는 개발자 콘솔에서 만들며, 계정당 최대 10개를 둘 수 있고 한도는 분당 300건입니다. 실행마다 보츠와나 번호를 몇 개 주문하는 테스트 스위트에는 충분한 양입니다.
일반적인 순서는 다음과 같습니다.
GET /api/v1/countries를 한 번 호출해 캐시하면, 코드가bw가 보츠와나의 식별자라는 것을 알 수 있습니다.GET /api/v1/prices?country=bw&service=whatsapp로 필요한 조합의 실시간 가격과 이용 가능 여부를 요청합니다. 가격은 서비스와 국가에 따라 다르므로 하드코딩하지 말고 읽으세요.- 본문
{"service": "whatsapp", "country": "bw"}로POST /api/v1/activations를 보냅니다. 응답에는 +267 번호와 활성화 ID가 들어 있습니다. - 테스트 중인 가입 양식에 그 번호를 입력한 다음
GET /api/v1/activations/{id}를 폴링하거나 웹훅을 기다립니다. - 테스트가 중단되면
POST /api/v1/activations/{id}/cancel을 호출해 자금이 즉시 지갑으로 돌아가게 합니다.
OTP API 연동 가이드는 오류 처리를 염두에 두고 같은 호출을 안내합니다.
웹훅 수신기는 +267 이벤트를 어떻게 처리해야 하나요?
두 개 이상의 테스트가 병렬로 실행된다면 웹훅이 더 깔끔한 선택입니다. 엔드포인트를 등록하고(계정당 5개) activation.sms_received, activation.expired, activation.cancelled를 수신하세요. 각 이벤트는 주문할 때 받은 활성화 ID를 기준으로 합니다.
모든 전송에는 t=<unix>,v1=<hex> 형태의 X-OTPRoute-Signature 헤더가 포함됩니다. 엔드포인트 시크릿으로 "<t>.<raw body>" 문자열의 HMAC-SHA256을 다시 계산하고, 상수 시간으로 v1과 비교하며, 타임스탬프가 오래된 것은 버리세요. 본문을 다시 직렬화하면 바이트가 바뀌므로 JSON은 검증이 통과한 뒤에만 파싱하세요.
핸들러는 멱등하게 만드세요. 코드를 소비할 때 활성화 ID를 저장하고 같은 이벤트가 반복되면 무시합니다. 자세한 내용은 HMAC으로 OTP 웹훅 보호하기에 있습니다.
보츠와나 인증 번호는 무엇에 쓸 수 있나요?
보츠와나의 실시간 스냅샷에는 800개가 넘는 서비스가 있습니다. 인기 있는 서비스는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT(OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Netflix, Airbnb 등입니다.
특정 경로의 이용 가능 여부는 캐리어 용량이 바뀜에 따라 하루 중 달라집니다. 그래서 가격 엔드포인트가 지금 주문할 수 있는 항목도 함께 알려 주는 것이며, 이 목록이 아니라 그 응답을 기준으로 삼으세요.
엔지니어가 보츠와나 전화번호에 대해 알아야 할 것은 무엇인가요?
보츠와나는 국가 코드 +267을 쓰고 트렁크 접두사가 없어서 국내 번호를 표기된 그대로 다이얼합니다. 휴대폰 번호는 8자리이며 7로 시작합니다. E.164에서는 +267 뒤에 8자리가 오고 제거할 0이 없습니다.
이 번호를 저장하거나 검증하는 사람을 위한 실용적인 요점이 몇 가지 있습니다.
- 입력 시 모든 것을 E.164로 정규화하세요. 사용자는
00267, 공백, 앞의 더하기 기호를 입력할 수 있으니, 비교하거나 중복을 제거하기 전에 모두 하나의 표준 형식으로 줄이세요. - 이웃 시장의 트렁크 접두사 규칙을 재사용하지 마세요. 앞자리 0을 버리는 나라에서 복사한 검증기는 올바른 보츠와나 입력을 거부합니다.
- 영어와 츠와나어가 주요 언어입니다. 글로벌 앱의 코드는 보통 영어로 도착하지만, 파서는 고정된 문구에 의존하지 말고 패턴으로 숫자를 추출해야 합니다.
팀이 이곳을 테스트하는 경우는 남부 아프리카에 제품을 출시할 때, 남아프리카 공화국과 국경을 맞댄 고객의 온보딩을 점검할 때, 또는 테스트용 현지 +267 번호가 필요한 지역 운영을 할 때입니다.
개발자가 아닌 사람도 대시보드에서 보츠와나 코드를 주문할 수 있나요?
예. 이메일과 6자리 코드(또는 Google)로 가입하고 지갑을 충전한 다음, OTP Gateway를 열고 보츠와나와 서비스를 선택해 표시된 가격을 확인하고 주문하세요. 테스트하려는 앱에 번호를 붙여 넣으면 SMS가 경로에 도착하는 즉시 코드가 대시보드에 나타납니다.
각 활성화는 20분 동안 열려 있습니다. 그 시간 안에 메시지가 도착하지 않거나 그 전에 취소하면 전체 금액이 지갑으로 자동 환불됩니다.
보츠와나 코드가 끝내 도착하지 않으면 어떻게 하나요?
전달 속도는 서비스와 경로에 따라 다르므로 조치하기 전에 시간 창에 여유를 주세요. 아무것도 없이 끝났다면 아래 목록을 확인하세요.
- 조금 뒤에 다시 시도하거나, 제품이 지원한다면 같은 흐름에 다른 서비스 경로를 선택해 보세요.
- 상대 앱이 가상 회선에 문자를 보내려 하는지 확인하세요. 일부 앱은 이런 번호를 거부하며, 사용하지 않은 활성화가 잔액으로 돌아오는 이유가 바로 이것입니다.
- 1분 뒤에 취소하지 말고 20분 시간 창이 끝나도록 두세요.
- CI에서 짧은 간격으로 반복 주문하지 마세요. 시도 사이에 백오프를 추가하세요.
더 많은 패턴은 OTP 전달 실패 줄이기에 있습니다. 무엇을 테스트하든 각 서비스의 약관을 따르세요. 모든 주문에 OTP Route 이용 정책(Acceptable Use Policy)이 적용됩니다.
+267 장기 회선이 있나요? 결제는 어떻게 처리되나요?
셀프서비스 상품으로는 없습니다. 전용 번호(Dedicated Numbers)는 미국과 캐나다에서만 즉시 판매되며 월 $1.95부터 시작합니다. 보츠와나는 [email protected]으로 이메일을 보내 문의하실 수 있으며, 이용 가능 여부는 현지 규정에 따라 달라집니다. 미국 및 캐나다 회선에 무엇이 포함되는지는 가상 번호를 참고하세요.
결제는 월 요금이 없는 선불 USD 지갑 하나로 이루어지며, 카드 또는 USDT/USDC로 충전하고 충전할 때마다 PDF 인보이스가 이메일로 도착합니다. 연동 작업에는 요청 시 개발 계정을 샌드박스로 전환해 시뮬레이션된 번호와 코드로 전체 흐름을 실행할 수 있습니다. 현재 요금은 가격 페이지에 있습니다.
자주 묻는 질문
OTP Route API에서 보츠와나의 국가 ID는 무엇인가요?
bw입니다. POST /api/v1/activations의 country와 GET /api/v1/prices의 쿼리 문자열에 사용하세요.
현지 SIM 없이 내 앱의 보츠와나 가입 흐름을 테스트할 수 있나요?
예. OTP Gateway에서 앱의 서비스용 +267 번호를 주문하고 대시보드나 웹훅에서 코드를 읽으세요. SIM 카드나 휴대폰은 필요하지 않습니다.
보츠와나 번호를 저장할 때 앞의 0이 필요한가요?
아니요. 보츠와나에는 트렁크 접두사가 없으므로 +267에 8자리 휴대폰 번호를 붙여 저장하세요.
+267 코드가 도착하지 않으면 요금이 청구되나요?
아니요. 20분 시간 창 안에 아무것도 도착하지 않거나 취소하면 전체 금액이 지갑으로 자동 환불됩니다.
앞으로의 로그인을 위해 보츠와나 번호를 유지할 수 있나요?
보츠와나에는 셀프서비스 장기 번호가 없습니다. 장기 회선은 미국과 캐나다 전용 상품이며, 다른 옵션을 알아보려면 [email protected]으로 이메일을 보내 주세요.
지갑 자금을 쓰지 않고 CI에서 보츠와나 테스트를 실행할 수 있나요?
개발 계정을 샌드박스로 전환해 달라고 요청하세요. 시뮬레이션된 번호와 코드를 반환하므로 전체 API와 웹훅 경로를 비용 없이 실행해 볼 수 있습니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.