제품 팀이 +383 번호를 필요로 하는 이유는 무엇인가요?
코소보는 작은 시장이지만 해외에서의 존재감은 큽니다. 독일, 스위스를 비롯한 서유럽에 대규모 디아스포라가 살고 있고, 이들 중 많은 사람이 가족과 은행 업무를 위해 코소보 번호를 유지합니다. 여행부터 해외 송금까지 이런 사용자를 대상으로 하는 앱은 +383 사용자가 가입 시 무엇을 경험하는지 직접 확인해야 합니다.
현지화도 또 다른 이유입니다. 알바니아어와 세르비아어가 모두 공용어이므로, 둘 중 어느 언어로 번역된 흐름이든 스크린샷 검토보다 실제 엔드투엔드 테스트가 필요합니다. OTP Gateway의 코소보 인증 번호가 있으면 QA가 어느 사무실에서든 그 점검을 할 수 있습니다.
프리슈티나에 기반을 두었거나 서부 발칸 전역을 담당하는 지역 운영 팀에는 세 번째 이유가 있습니다. 현지 연락처로 등록한 비즈니스 프로필이 새 코드를 요구하는 경우가 있는데, 직원의 휴대전화를 돌려가며 쓰는 것보다 공유되고 감사 가능한 도구로 처리하는 편이 낫습니다.
지금 코소보 경로에서는 어떤 앱을 쓸 수 있나요?
오늘 스냅샷에는 코소보용 서비스가 400개가 넘게 있습니다. 현재 제공되는 인기 서비스는 WhatsApp, Viber, Telegram, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Snapchat, Netflix, Airbnb, Uber, Flipkart입니다.
이 목록은 규모가 큰 유럽 시장보다 작고 더 자주 바뀌므로, 적어 둔 목록은 힌트로만 보세요. 주문하는 시점에 GET /api/v1/countries와 대시보드가 반환하는 내용이 정확한 답입니다.
코소보 OTP API를 실제로 사용하는 방법
국가 ID는 xk입니다. 일반적인 통합은 GET /api/v1/services에서 서비스 ID를 확인하고, GET /api/v1/prices?country=xk&service=<id>로 비용을 확인한 다음, {"service": "telegram", "country": "xk"} 같은 본문으로 POST /api/v1/activations를 호출해 활성화를 시작합니다. 응답에는 번호와 나중에 쓸 활성화 ID가 들어 있습니다.
그 후 코드는 activation.sms_received 웹훅으로 도착하며, X-OTPRoute-Signature 헤더에 "<t>.<raw body>"의 HMAC-SHA256으로 서명되어 있습니다. 오래된 타임스탬프는 거부하고, 재시도된 전달이 한 번만 처리되도록 핸들러를 활성화 ID 기준으로 처리하세요. CI 작업에 공개 URL이 없다면 GET /api/v1/activations/{id} 폴링도 가능합니다. 전체 예시는 통합 가이드를 참고하세요.
코소보가 +383을 받으면서 무엇이 바뀌었고, 번호는 어떻게 저장해야 하나요?
코소보는 2010년대 후반에야 자체 국가 코드 +383을 받았습니다. 그전에는 이동통신망이 모나코와 슬로베니아의 코드를 포함해 빌린 코드를 사용했고, 일부 오래된 고객 기록에는 지금도 그런 형식의 번호가 남아 있습니다. 레거시 데이터를 가져온다면 해당 항목을 자동으로 고쳐 쓰지 말고 표시해 두세요.
국내 번호는 트렁크 접두사 0으로 시작하며, 현지에서 044 123 456으로 표시되는 휴대전화는 E.164로 +383 44 123 456입니다. 국제 형식을 저장하고, 입력 시 0을 제거하며, 표시할 때만 서식을 적용하세요. 알바니아어 텍스트에는 기본 GSM 알파벳에 없는 ë 같은 글자가 쓰이므로, 현지화된 메시지는 UCS-2로 전송되어 세그먼트가 짧아질 수 있습니다.
코소보 코드가 늦거나 오지 않으면 어떻게 해야 하나요?
활성화에 20분의 시간을 모두 주세요. SMS 없이 창이 닫히거나 취소하면 요금이 자동으로 지갑에 환불되고 activation.expired 또는 activation.cancelled가 발생합니다. 합리적인 다음 조치는 다음과 같습니다.
- 잠시 후 다시 시도하거나, 테스트가 허용한다면 알바니아 같은 인접 경로를 선택합니다.
- 대상 서비스가 애초에 가상 번호를 허용하는지 확인합니다.
- 반복문으로 주문하지 말고 자동 재시도에 백오프를 추가합니다.
코소보 프로젝트를 위한 장기 회선, 지갑, 샌드박스
OTP Route는 코소보용 셀프서비스 장기 번호를 제공하지 않습니다. 월 $1.95부터인 전용 번호(Dedicated Number) 라인은 미국과 캐나다 두 나라만 지원합니다. 오래 쓸 +383 회선이 필요하면 [email protected]으로 이메일을 보내세요. 마련할 수 있는지는 현지 규정에 따라 달라집니다.
비용은 하나의 선불 USD 지갑에서 사용한 만큼 차감되며, 카드 또는 USDT/USDC로 충전하고 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 개발자는 개발 계정에 샌드박스 모드를 요청해 웹훅을 연결하는 동안 시뮬레이션된 번호와 코드를 받을 수 있습니다. 자세한 내용은 요금 안내를 참고하세요.
자주 묻는 질문
실제 코소보 번호로 앱의 알바니아어 가입 흐름을 확인할 수 있나요?
네. OTP Gateway에서 테스트용 +383 번호를 주문하고 알바니아어로 가입을 시작하면, 코드가 대시보드와 웹훅에 나타납니다.
SMS 인증 API에서 코소보는 어떤 ID를 사용하나요?
GET /api/v1/prices와 POST /api/v1/activations를 포함해 국가를 받는 모든 엔드포인트에서 코소보는 xk입니다.
코소보 인증 번호는 얼마인가요?
코드당 $0.20 이상이며, 정확한 요금은 서비스에 따라 다르고 주문 전에 표시되거나 가격 엔드포인트가 반환합니다.
코소보의 서비스가 독일보다 적게 보이는 이유는 무엇인가요?
커버리지는 당사 캐리어 파트너가 각 국가로 라우팅할 수 있는 범위를 따르며, 작은 시장은 목록이 더 짧습니다. 테스트를 계획하기 전에 실시간 목록을 확인하세요.
코소보 OTP가 끝내 오지 않으면 돈은 어떻게 되나요?
SMS 없이 20분의 시간이 끝나면 전액이 지갑으로 돌아가고, 취소하면 즉시 돌아갑니다.
예전 +377 또는 +386 번호가 여전히 코소보 사용자 것인가요?
일부 레거시 기록에 남아 있을 수 있지만 새 번호는 +383을 사용합니다. 오래된 형식은 맹목적으로 변환하지 말고 검토할 데이터로 취급하세요.
반복 로그인을 위해 +383 번호를 계속 가질 수 있나요?
셀프서비스로는 불가능합니다. 각 게이트웨이 번호는 코드 한 번에만 쓰이고 장기 회선은 미국/캐나다 상품이므로, 코소보에 대해서는 [email protected]으로 문의하세요.
OTP Route 번호를 어떻게 사용해야 하는지 규칙이 있나요?
네. OTP Route는 자사의 합법적인 제품과 비즈니스 계정에만 사용하고, 각 서비스의 약관을 따르며, 허용 사용 정책(Acceptable Use Policy)을 지키세요. 시작하려면 가입하세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.