해외에서 +257 가입 흐름을 확인하기 어려운 이유는 무엇인가요?
제품 팀이 동아프리카 출시에 부룬디를 추가한다고 상상해 보세요. 가입 화면은 전화번호를 요구하고 백엔드는 일회용 코드를 보내지만, 팀 누구도 부룬디 SIM을 갖고 있지 않습니다. 출장 중에 산 로밍 SIM은 만료되고, 부줌부라에 있는 동료에게 코드를 소리 내어 읽어 달라고 하면 개인 번호가 노출되며 야간 테스트 스위트 안에서 실행할 수도 없습니다.
OTP 라우팅은 이 병목을 없애 줍니다. 실물 단말 대신 특정 서비스 하나를 위한 부룬디 인증 번호를 요청하면 OTP Route가 코드를 받아 두고, 테스트 하네스는 이를 다른 이벤트처럼 읽어 갑니다. 부룬디 경로에서 비즈니스 프로필을 관리하면서 직원 본인의 휴대폰은 쓰고 싶지 않은 운영팀에도 같은 방식이 통합니다.
현재 부룬디 번호로 인증할 수 있는 서비스는 무엇인가요?
부룬디의 라이브 스냅샷에는 WhatsApp, Viber, imo, Telegram, Signal, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, ChatGPT (OpenAI), Uber, Amazon 등 익숙한 메신저, 검색, 커머스 앱이 올라와 있습니다. 이 경로는 전체적으로 1,000개 넘는 서비스를 지원합니다.
재고는 하루 중에도 바뀌므로 이 목록은 약속이 아니라 출발점으로 보세요. 현재 상황은 코드에서 GET /api/v1/services와 GET /api/v1/countries로 확인하고, 전체 디렉터리는 국가 목록에서 둘러볼 수 있습니다.
부룬디 OTP API는 테스트 실행에 어떻게 들어맞나요?
개발자 콘솔에서 키를 만드세요. 라이브 키는 or_live_로 시작하며 https://otproute.com/api/v1에 Bearer 헤더로 보냅니다. 일반적인 자동화 점검은 다음과 같습니다.
GET /api/v1/prices?country=bi&service=whatsapp를 호출해 해당 조합의 현재 가격을 확인합니다.- 본문
{"service": "whatsapp", "country": "bi"}로POST /api/v1/activations를 보냅니다. 응답에는 활성화 ID와 테스트 대상 앱에 입력할 +257 번호가 들어 있습니다. activation.sms_received웹훅을 기다리거나, 적당한 간격으로GET /api/v1/activations/{id}를 폴링합니다.- 코드를 검증하고 테스트를 종료합니다.
웹훅 요청에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함되며, 이는 엔드포인트 시크릿을 키로 <t>.<raw body>에 HMAC-SHA256을 적용한 값입니다. 다시 계산해서 상수 시간 방식으로 비교하고, 오래된 타임스탬프는 버리세요. 세부 내용은 이 가이드에서 다룹니다. 계정은 키 최대 10개, 웹훅 엔드포인트 최대 5개를 보유할 수 있고 분당 요청 한도는 300건입니다. 전체 레퍼런스는 문서에 있습니다.
검증기는 부룬디 번호에서 무엇을 기대해야 하나요?
부룬디는 폐쇄형 번호 체계를 사용합니다. 가입자 번호는 국가 코드 뒤에 8자리이며 제거해야 할 국내 트렁크 프리픽스가 없습니다. E.164로는 +257 뒤에 공백 없이 8자리를 붙인 형태입니다. 입력 폼에서는 두 자리씩 묶어 표시하는 경우가 많으므로, 저장 전에 공백, 하이픈, 맨 앞의 00을 제거해 정규화하세요.
흔한 버그는 9~10자리 국내 번호를 기준으로 만든 검증기가 올바른 +257 입력을 아무 말 없이 거부하는 것입니다. 단위 테스트에 이 자릿수의 픽스처를 추가하세요.
공용어는 키룬디어, 프랑스어, 영어이며 상거래에서는 스와힐리어도 널리 쓰입니다. 글로벌 앱의 인증 문자는 발신 측의 로캘 로직에 따라 보통 영어나 프랑스어로 오므로, 문구를 매칭하지 말고 숫자를 파싱하세요.
코드가 오지 않으면 어떻게 하나요?
모든 활성화는 20분 동안 열려 있습니다. 그 시간 안에 번호로 SMS가 도착하지 않거나 POST /api/v1/activations/{id}/cancel로 취소하면, 결제 금액 전액이 자동으로 지갑에 환불됩니다.
- 실패라고 판단하기 전에 창이 끝날 때까지 기다리세요. 일부 발신자는 메시지를 대기열에 쌓아 둡니다.
- 대상 서비스가 가상 번호를 허용하는지 확인하세요. 정책상 거부하는 서비스도 있습니다.
- 나중에 다시 시도하거나, 다른 서비스 경로로 같은 흐름을 테스트해 보세요.
- 짧은 간격으로 반복 주문하지 말고, 시도 사이에 대기 시간을 두세요.
대시보드를 선호하나요? 로그인하고 부룬디와 서비스를 선택한 뒤, 번호를 앱에 복사해 넣고 화면에 코드가 나타나는 것을 확인하세요. 더 많은 방법은 OTP 전송 실패 줄이기에 있습니다.
반복해서 로그인하는 계정을 위해 부룬디 회선을 유지할 수 있나요?
셀프서비스 상품으로는 불가능합니다. OTP Route는 부룬디 장기 번호를 판매하지 않으며, OTP Gateway는 인증 한 건마다 번호 하나를 발급합니다. 해당 국가에서 고정 회선이 정말 필요하다면 [email protected]으로 이메일을 보내 사용 사례를 설명해 주세요. 제공 가능 여부는 현지 규정에 따라 다르며 보장되지 않습니다.
전용 가상 번호(Dedicated Virtual Numbers)는 미국과 캐나다에서만 제공되며 월 $1.95부터 시작하고, 수신 SMS, 웹훅 전달, 브라우저 통화를 지원합니다. 스테이징 계정에 미국 또는 캐나다 회선이 맞는다면 가상 번호를 확인하세요.
부룬디 사용 요금은 어떻게 청구되나요?
선불 USD 지갑 하나를 사용하며 월 요금이나 선택할 요금제는 없습니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하고, 충전할 때마다 재무팀이 쓸 PDF 인보이스가 이메일로 발송됩니다. 결제를 CI에 연결하기 전에 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 지갑 자금을 쓰지 않고 시뮬레이션된 번호와 코드가 반환됩니다.
번호는 자사 제품이나 정당한 비즈니스 계정에만 사용하고, 각 서비스의 약관을 지키며, OTP Route의 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요. 현재 요금은 요금 페이지에서 확인할 수 있습니다.
자주 묻는 질문
현지 SIM 없이 우리 앱의 부룬디 가입 흐름을 테스트할 수 있나요?
네. OTP Gateway에서 해당 서비스용 +257 번호를 주문하고 앱에 입력한 뒤, 대시보드, API 또는 웹훅으로 코드를 읽으면 됩니다.
API에서 부룬디의 국가 ID는 무엇인가요?
POST /api/v1/activations에서 telegram 같은 서비스 ID와 함께 country 값으로 bi를 전달하세요.
+257 코드가 오지 않으면 요금이 부과되나요?
아니요. 20분 안에 아무것도 도착하지 않거나 취소하면 결제 금액 전액이 자동으로 지갑에 환불됩니다.
부룬디 번호에서 제거해야 할 맨 앞의 0이 있나요?
아니요. 부룬디에는 트렁크 프리픽스가 없으므로 E.164 형식은 +257 뒤에 8자리를 붙인 것입니다.
부룬디 인증 SMS는 어떤 언어로 오나요?
발송 서비스에 따라 다르지만 보통 영어나 프랑스어입니다. 메시지 문구에 의존하지 말고 숫자 코드를 추출하세요.
다음 달에도 같은 부룬디 번호를 재사용할 수 있나요?
아니요. Gateway 번호는 인증 한 건에만 쓰입니다. 반복 로그인이 필요하면 전용 번호(Dedicated Number)를 쓸 수 있지만 미국과 캐나다에서만 제공됩니다.
부룬디 인증 번호는 얼마인가요?
부룬디 요금은 코드당 $0.20부터 시작하며 서비스별로 다릅니다. 정확한 금액은 GET /api/v1/prices가 반환하고 주문 전에 표시됩니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.