제품 팀이 케냐 시장을 대상으로 테스트하는 이유는 무엇인가요?
나이로비는 동아프리카에서 가장 활발한 기술 허브 중 하나이며, 케냐 사용자는 철저히 모바일 중심입니다. 많은 사용자에게 전화번호는 메시징, 차량 호출, 전자상거래, 특히 모바일 머니의 핵심 신원 수단이므로, +254 번호를 잘못 처리하는 가입 흐름은 첫날부터 고객을 잃습니다.
영어와 스와힐리어가 모두 공용어입니다. 대부분의 글로벌 앱은 영어로 코드를 보내지만, 이 지역에 맞게 현지화된 제품은 스와힐리어로 바꿀 수 있으므로, 자사 템플릿을 번역했다면 확인해 볼 만합니다. 이곳에서 테스트를 돌리는 일반적인 이유는 다음과 같습니다.
- 동아프리카에서 핀테크, 배달 또는 마켓플레이스 제품을 출시할 때
- SMS 템플릿과 온보딩 화면의 스와힐리어 문구를 검증할 때
- 직원 번호를 노출하지 않고 케냐 고객용 지원 또는 운영 계정을 운영할 때
더 넓은 패턴은 핀테크 온보딩 페이지에서 다룹니다.
케냐 휴대전화 번호를 E.164로 어떻게 쓰나요?
현지에서는 휴대전화 번호를 트렁크 접두사 0과 함께 07XX XXX XXX 또는 01XX XXX XXX로 씁니다. 국제 형식에서는 0이 빠지고 +254 뒤에 9자리 가입자 번호가 옵니다.
대표적인 결함은 국가 코드 뒤에 이 0을 남겨 두어 발신자가 명확한 오류 없이 거부하는 잘못된 +2540... 문자열을 만드는 것입니다. 데이터베이스에 도달하기 전에 모든 입력을 정규화하세요.
- 공백, 하이픈, 괄호를 제거합니다.
- 값이
0으로 시작하면 이를 빼고+254를 앞에 붙입니다. 254로 시작하고 플러스 기호가 없으면 플러스를 추가합니다.- 결과를 E.164 문자열로 저장하고, 정규화 후 길이를 검증합니다.
테스트용 +254 번호가 있으면 이 로직의 각 분기를 실제 수신 SMS로 쉽게 증명할 수 있습니다.
지금 케냐 경로에서는 어떤 서비스를 쓸 수 있나요?
케냐는 가장 폭넓은 카탈로그 중 하나로, 실시간 스냅샷에 2,800개가 넘는 서비스가 있습니다. 자주 요청되는 서비스는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Uber, LinkedIn, Signal, Netflix입니다.
이용 가능 여부는 시간 단위로 바뀔 수 있으므로, API는 고정된 목록 대신 이를 실시간으로 보고합니다.
케냐 OTP API를 테스트 스위트에 어떻게 연결하나요?
개발자 콘솔에서 받은 or_live_ 접두사의 Bearer 키로 https://otproute.com/api/v1에 인증합니다. 케냐의 국가 ID는 ke입니다.
일반적인 CI 단계는 먼저 GET /api/v1/balance를 호출해 지갑이 비어 있으면 실행이 빨리 실패하게 합니다. 그다음 GET /api/v1/prices?country=ke&service=<id>를 확인하고, {"service": "uber", "country": "ke"} 같은 본문으로 POST /api/v1/activations를 호출해 주문한 뒤, 반환된 +254 번호를 테스트 대상 앱에 입력합니다. 코드는 activation.sms_received 웹훅으로 돌아오거나, GET /api/v1/activations/{id}를 몇 초마다 폴링해서 받으며, 분당 300건 허용 범위 안에서 충분히 가능합니다.
웹훅은 최대 5개의 엔드포인트를 등록하고, 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산해 X-OTPRoute-Signature를 검증하며 오래된 타임스탬프는 거부하세요. 재시도된 전달이 문제를 일으키지 않도록 핸들러를 활성화 ID 기준으로 처리하세요. CI 테스트 가이드에서 파이프라인에 연결하는 방법을 보여 주며, 전체 레퍼런스는 문서에 있습니다.
코드를 작성하지 않고 +254 번호를 주문할 수 있나요?
네. 대시보드에서 OTP Gateway를 열고, 케냐를 선택하고, 서비스를 고른 뒤 표시된 가격을 확인하세요. 번호가 바로 나타나며, 가입 또는 로그인 양식에 붙여 넣으면 코드가 수신되는 즉시 활성화 옆에 표시됩니다. 엔지니어가 같은 지갑으로 API를 사용하는 동안 지원 담당자와 어카운트 매니저는 이 방식으로 일할 수 있습니다.
케냐 코드가 늦거나 오지 않을 때 어떻게 하면 되나요?
모든 활성화에는 20분의 시간이 있습니다. 코드가 도착한 경우에만 비용을 내며, 아무것도 오지 않고 시간이 끝나거나 POST /api/v1/activations/{id}/cancel로 취소하면 문의 없이 금액이 지갑으로 돌아갑니다.
재시도하기 전에 시간을 충분히 두세요. 일부 발신자는 메시지를 대기열에 쌓습니다. 그래도 실패하면 나중에 다시 시도하거나 다른 서비스 경로를 이용하고, 앱이 가상 번호를 허용하는지 확인하세요. 허용하지 않는 앱도 있습니다. 주문 엔드포인트를 연달아 호출하지 마세요. 많은 발신자가 같은 흐름에 대한 반복 요청을 제한합니다. OTP 전달 실패 줄이기 글에 추가 해결 방법이 모여 있습니다. 모든 테스트는 대상 서비스의 약관 범위 안에서 수행하세요. OTP Route의 허용 사용 정책(Acceptable Use Policy)이 적용됩니다.
케냐 프로젝트를 위한 장기 회선, 지갑, 샌드박스
OTP Route는 셀프서비스 장기 케냐 번호를 판매하지 않습니다. 전용 회선은 미국과 캐나다에서만 월 $1.95부터 제공되며, 수신 SMS, 발신 SMS, 브라우저 통화를 지원합니다. 계속 사용할 +254 회선이 필요한 팀은 [email protected]으로 문의할 수 있지만, 가능 여부는 현지 규정에 따라 달라집니다.
결제는 USD 지갑 하나에서 사용한 만큼만 지불하며, 카드 또는 USDT나 USDC 스테이블코인으로 충전하고, 충전할 때마다 PDF 인보이스가 발급됩니다. 월 요금은 없으며, 비용이 표시되는 방식은 요금 안내를 참고하세요. 요청하면 개발 계정을 샌드박스로 전환할 수 있으며, 지갑 비용 없이 시뮬레이션된 번호와 코드로 엔드투엔드 통합 테스트를 할 수 있습니다.
자주 묻는 질문
케냐 밖에서도 앱의 케냐 가입 흐름을 테스트할 수 있나요?
네. 팀이 어디에 있든 OTP Gateway에서 +254 번호를 주문하고, 수신된 코드를 대시보드나 API로 확인하세요.
케냐는 어떤 국가 ID를 보내야 하나요?
가격 조회와 활성화 본문에 ke를 보내세요. 예: {"service": "whatsapp", "country": "ke"}.
케냐 번호를 맨 앞의 0과 함께 저장해야 하나요?
아니요. 트렁크 접두사 0을 빼고 +254 뒤에 9자리를 붙여 저장하세요.
케냐 인증 문자는 스와힐리어로 오나요?
보통은 영어로 오지만, 케냐에 맞게 현지화된 앱은 스와힐리어로 보낼 수 있으므로 템플릿을 번역했다면 두 가지를 모두 확인하세요.
코드가 끝내 오지 않으면 돈은 어떻게 되나요?
SMS 없이 20분의 시간이 끝나면 자동으로, 취소하면 즉시 지갑으로 돌아갑니다.
+254 코드에는 웹훅과 폴링 중 어느 쪽이 좋은가요?
병렬 테스트 작업에는 웹훅이 더 잘 확장되고, 단일 스크립트에는 GET /api/v1/activations/{id} 폴링이 더 간단합니다. 둘 다 같은 활성화를 읽습니다.
매달 유지하는 케냐 번호를 받을 수 있나요?
셀프서비스로는 불가능합니다. 전용 번호는 미국과 캐나다로 한정되며, 케냐 회선이 필요하면 [email protected]으로 문의하세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.