카자흐스탄 OTP 실행에는 어떤 엔드포인트가 쓰이나요?
전체 사이클은 https://otproute.com/api/v1에 대한 5~6건의 요청이며, or_live_로 시작하는 Bearer 키로 서명합니다. 카자흐스탄의 국가 ID는 kz이고 한 계정은 키를 최대 10개까지 가질 수 있어서 CI, 스테이징, 개발자 노트북이 각자 키를 가질 수 있습니다.
- 작업 시작 시
GET /api/v1/balance를 호출해 지갑이 비어 있으면 실행이 일찍 실패하게 합니다. GET /api/v1/prices?country=kz&service=telegram으로 해당 조합의 현재 가격과 이용 가능 여부를 읽습니다.{"service": "telegram", "country": "kz"}로POST /api/v1/activations를 호출하면 활성화 ID와 +7 번호가 반환됩니다.- 폴링한다면
GET /api/v1/activations/{id}, 웹훅에 의존한다면 아무것도 호출하지 않아도 됩니다. - 코드가 필요해지기 전에 테스트가 종료되면
POST /api/v1/activations/{id}/cancel을 호출합니다.
한도는 계정당 분당 300건이어서, 몇 초마다 폴링하는 병렬 작업을 위한 여유가 있습니다. 처음 구축한다면 API 통합 가이드에서 시작하세요.
폴링 대신 웹훅으로 +7 코드를 받으려면 어떻게 하나요?
개발자 콘솔에 엔드포인트를 등록하고(계정당 5개) activation.sms_received, activation.expired, activation.cancelled를 구독하세요. 각 POST에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 붙어 있습니다.
엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256으로 서명을 다시 만들고 상수 시간으로 비교하세요. JSON을 다시 직렬화하면 다이제스트가 달라지므로 받은 그대로의 원본 바이트를 사용하고, 재전송을 막기 위해 짧은 허용 범위를 벗어난 타임스탬프는 거부하세요. 전달이 재시도될 수 있으므로 활성화 ID로 upsert해서 두 번째 사본이 아무것도 바꾸지 않게 하세요. 단계별 안내는 웹훅 기반 OTP 수신에 있습니다.
카자흐스탄 번호로 코드를 보낼 수 있는 앱은 무엇인가요?
kz 경로에는 1,700개가 넘는 서비스가 등록되어 있습니다. 최근 스냅샷 기준 인기 서비스는 Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, TikTok, Facebook, Viber, Discord, Microsoft & Outlook, LinkedIn, Uber, AliExpress, Amazon입니다.
이 목록을 코드에 고정하지 마세요. 경로는 하루 중에도 바뀌므로, 스크립트는 주문 전에 매번 GET /api/v1/prices를 확인하고 해당 조합을 쓸 수 없으면 대체 서비스 ID를 선택해야 합니다.
전화번호 데이터베이스에서 +7에 특별히 주의해야 하는 이유는 무엇인가요?
카자흐스탄은 국가 코드 7을 러시아와 공유합니다. 두 나라 모두 국내 번호가 10자리이며, 카자흐스탄 휴대전화 대역은 보통 국가 코드 뒤에 7로 시작하므로 +7 7xx xxx xx xx 같은 번호는 카자흐스탄 번호이고, 러시아 휴대전화는 많은 경우 9로 시작합니다. 국가 코드만으로 국가를 추정하지 마세요. 관리되는 전화번호 라이브러리로 번호 대역에서 국가를 판별하거나 별도의 국가 필드를 두세요.
국내에서는 10자리 앞에 트렁크 8을 누릅니다. 입력 시 이를 제거하고 +7 뒤에 국내 번호를 붙인 E.164 형식으로 저장하세요. 카자흐어가 국어이고 러시아어도 공식적으로 널리 쓰이므로 인증 문자는 러시아어, 카자흐어, 영어로 올 수 있으며 보통 키릴 문자입니다. SMS 파서와 로그가 UTF-8을 처리하는지, 문구가 아닌 숫자를 추출하는지 확인하세요.
중앙아시아 출시, 이중 언어 현지화 점검, 지역 운영 인력 지원을 위해 이곳에서 테스트하는 팀이 있습니다.
코딩하지 않는 팀을 위한 대시보드 경로가 있나요?
네. 이메일 코드나 Google로 가입한 뒤 지갑을 충전하고, 카자흐스탄과 서비스를 선택하고, 표시된 가격을 확인하고 주문하세요. +7 번호와 나중에는 코드가 활성화 카드에 나타납니다. 제품 매니저와 현지화 테스터는 파이프라인이 대량을 처리하는 동안 이 방법으로 즉석 점검을 합니다.
카자흐스탄 번호를 반복 로그인용으로 유지할 수 있나요?
이를 위한 셀프서비스 옵션은 없습니다. OTP Gateway 번호는 코드 한 번에만 쓰이며, 장기 전용 번호(Dedicated Number)는 미국과 캐나다에서만 판매됩니다. 월 $1.95부터이고 수신 및 발신 SMS와 브라우저 통화가 포함됩니다. 오래 유지할 카자흐스탄 회선이 필요하면 [email protected]으로 이메일을 보내세요. 마련할 수 있는지는 현지 규정에 따라 달라지며 보장되지 않습니다. 다시 로그인해야 하는 스테이징 계정에는, 서비스가 허용하는 경우 미국 또는 캐나다 회선이 현실적인 답인 경우가 많습니다.
20분 안에 코드가 오지 않으면 어떻게 되나요?
활성화가 만료되고, 웹훅이 activation.expired를 발송하며, 별다른 조치 없이도 전체 금액이 지갑으로 돌아옵니다. 그런 다음 재시도하기 전에 원인을 진단하세요.
- 번호를 국내용 8이 아닌
+7로 제출했나요? - 서비스가 가상 번호를 거부하나요? 일부 서비스는 거부하며, 그래서 OTP Route는 사용되지 않은 활성화를 환불합니다.
- 즉시 반복하지 말고 나중에 또는 다른 경로로 다시 시도하세요. 짧은 백오프를 두면 로그를 읽기 쉽게 유지할 수 있습니다.
전달 속도는 서비스와 경로에 따라 다르므로 테스트에서 타임아웃을 너무 짧게 잡지 마세요.
계정 요금은 어떻게 청구되나요?
하나의 선불 USD 지갑에서 사용한 만큼만 지불하며, 구독도 요금제 단계도 없습니다. 카드 또는 USDT나 USDC 스테이블코인으로 충전하고, 충전과 번호 구매마다 PDF 인보이스가 이메일로 발송됩니다. 요청하면 개발 계정을 샌드박스로 전환할 수 있으며, 시뮬레이션된 번호와 코드로 엔드투엔드 테스트를 할 수 있습니다. 서비스는 자사의 합법적인 제품에만 사용하고, 각 앱의 약관과 허용 사용 정책(Acceptable Use Policy)을 지키세요. 실시간 요금은 요금 안내를 참고하세요.
자주 묻는 질문
카자흐스탄 +7 번호와 러시아 번호를 어떻게 구분하나요?
국가 코드만이 아니라 번호 대역을 보세요. 카자흐스탄 휴대전화는 보통 +7 뒤에 7로 시작합니다. 관리되는 전화번호 라이브러리나 별도의 국가 필드를 쓰면 실수를 피할 수 있습니다.
OTP Route API에서 카자흐스탄의 국가 ID는 무엇인가요?
활성화 본문과 가격 엔드포인트의 country 매개변수에 kz를 사용하세요.
현지 SIM 없이 카자흐스탄 가입 흐름을 테스트할 수 있나요?
네. OTP Gateway에서 카자흐스탄 +7 번호를 주문하고, 자사 흐름에 입력한 뒤, 웹훅, 폴링 또는 대시보드로 코드를 가져오세요.
Telegram 코드가 끝내 오지 않으면 요금이 청구되나요?
아니요. 20분의 시간 안에 SMS가 없거나 취소하면 금액이 자동으로 지갑에 돌아옵니다.
카자흐스탄 인증 문자는 러시아어로 오나요, 카자흐어로 오나요?
둘 다 가능하고 영어를 쓰는 서비스도 있습니다. 숫자 코드를 파싱하고, 사용 중인 스택이 키릴 문자 텍스트를 처리하는지 확인하세요.
카자흐스탄 경로에 월 요금이 있나요?
아니요. OTP Route는 카드, USDT 또는 USDC로 충전하는 선불 USD 지갑에서 사용한 만큼만 지불합니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.