일회용 +385 번호로 크로아티아 가입 흐름 테스트하기

테스트에 +385 번호가 필요한 이유는 무엇인가요?

크로아티아는 규모는 작지만 계절 트래픽이 큰 시장입니다. 2013년에 EU에 가입했고 2023년에 유로를 도입했기 때문에, 이미 유로존을 대상으로 하는 앱이 다음 언어로 크로아티아어를 추가하는 경우가 많고, 여행·단기 숙박·모빌리티와 관련된 서비스는 아드리아 해안의 여름철에 이용이 급증합니다.

그래서 크로아티아 인증 번호가 필요한 구체적인 작업이 생깁니다.

• 현지화 QA: č, ć, đ, š, ž를 포함한 크로아티아어 문자열이 SMS 템플릿과 앱 내 확인 화면에서 깨지지 않는지 점검합니다.
• 출시 점검: +385 번호로 가입했을 때 독일이나 오스트리아 번호와 같은 온보딩 상태에 도달하는지 확인합니다.
• 지역 운영: 자그레브에서 주변 지역을 담당하는 팀이 직원 개인 휴대폰을 쓰지 않고 비즈니스 계정을 인증해야 할 때 사용합니다.

QA 테스트 가이드에서 팀들이 이 과정을 릴리스 체크리스트에 연결하는 방법을 볼 수 있습니다.

크로아티아 경로에서는 어떤 서비스를 인증할 수 있나요?

크로아티아의 실시간 카탈로그에는 1,800개가 넘는 서비스가 올라 있습니다. 팀들이 가장 자주 요청하는 서비스로는 WhatsApp, Viber, Telegram, Signal, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Facebook, Instagram, TikTok, Discord, Amazon, eBay, Uber, Airbnb가 있습니다.

Viber는 발칸 반도 전역에서 널리 쓰이기 때문에 이 지역에 진출하는 메시징 제품은 일찍부터 Viber를 테스트하는 편입니다. 각 서비스의 OTP 라우팅은 서비스와 국가별로 선택되며 가용 상태는 하루 동안에도 바뀝니다. 그래서 이 페이지가 고정된 목록을 약속하는 대신 API가 실시간으로 알려 줍니다.

크로아티아 OTP API 호출 순서는 어떻게 되나요?

SMS 인증 API로서 OTP Route는 크로아티아 흐름을 짧게 유지합니다. 모든 호출은 https://otproute.com/api/v1에 대해 이루어지며, Developer console에서 발급한 or_live_ 접두사의 Bearer 키를 사용합니다. 크로아티아의 국가 id는 hr입니다.

1. GET /api/v1/services로 서비스 id를 한 번 조회해 설정에 보관합니다.
2. 주문 직전에 GET /api/v1/prices?country=hr&service=<id>로 현재 가격과 가용 여부를 확인합니다.
3. POST /api/v1/activations에 {"service": "viber", "country": "hr"}를 보내 주문을 만듭니다. 응답으로 activation id와 +385 번호를 받습니다.
4. 받은 번호를 자체 앱의 인증 화면에 입력합니다.
5. activation.sms_received 웹훅 이벤트로 코드를 받거나, 대안으로 GET /api/v1/activations/{id}를 몇 초 간격으로 폴링합니다.

테스트가 중단되면 POST /api/v1/activations/{id}/cancel로 주문을 해제하세요. 계정당 분당 300건의 요청 제한이면 여러 작업을 병렬로 돌리기에 충분합니다. 전체 요청 형식은 API 문서에 있습니다.

코드를 다루지 않는 사람도 대시보드를 사용할 수 있나요?

네. 일회성 점검이라면 지원 담당자와 제품 매니저가 이 방법을 자주 씁니다. 로그인한 뒤 OTP Gateway를 열고 크로아티아와 서비스를 선택하고, 표시된 가격을 확인한 다음 주문을 확정하면 됩니다. 카운트다운과 함께 +385 번호가 나타납니다. 이 번호를 앱에 붙여넣으면 코드가 도착하는 즉시 같은 화면에 표시됩니다. 터미널도 API 키도 필요 없습니다.

+385 번호는 어떻게 저장해야 하나요?

크로아티아에서는 국내 통화 시 앞에 트렁크 0을 붙이기 때문에 현지 표기의 휴대폰 번호는 09로 시작합니다. E.164에서는 이 0이 사라지고, +385 뒤에 국내 번호가 이어지며 휴대폰은 +3859로 시작합니다. 입력 시 공백, 슬래시, 국내용 0을 제거해 하나의 표준 문자열로 저장하세요. 09… 값과 +3859… 값을 서로 비교하는 것은 "사용자를 찾을 수 없음" 버그의 전형적인 원인입니다.

크로아티아 현지 서비스의 코드는 보통 크로아티아어로 도착하고, 글로벌 플랫폼은 계정이나 기기의 로케일에 따라 언어를 고르므로 숫자 주변 문구는 크로아티아어일 수도 영어일 수도 있습니다. 고정된 문장 대신 숫자 패턴으로 코드를 추출하세요.

크로아티아 코드가 늦거나 오지 않으면 어떻게 하나요?

각 activation은 20분 동안 열려 있습니다. 그 시간 안에 번호로 SMS가 도착하지 않거나 먼저 취소하면 결제 금액이 자동으로 지갑에 환불되므로, 도착한 코드에 대해서만 비용을 내게 됩니다. 코드가 지연될 때는 다음을 확인하세요.

• 실패로 단정하기 전에 제한 시간이 끝날 때까지 기다리세요. 전달 속도는 서비스와 경로에 따라 다릅니다.
• 해당 서비스가 이 흐름에서 가상 번호를 허용하는지 확인하세요. 일부 서비스는 아예 거부합니다.
• 짧은 간격으로 재주문을 반복하지 말고, 나중에 다시 시도하거나 다른 서비스 경로를 이용하세요.

OTP 전달 실패 줄이기 글에는 +385 경로에서 시도해 볼 만한 추가 해결책이 정리되어 있습니다.

크로아티아 장기 번호가 있나요? 결제는 어떻게 처리되나요?

크로아티아에는 셀프 서비스 장기 번호가 없습니다. 전용 번호(Dedicated Numbers)는 미국·캐나다 전용 상품으로 월 $1.95부터 시작하며, 자세한 내용은 가상 번호 페이지에 있습니다. 팀에서 지속적으로 사용할 +385 회선이 필요하다면 [email protected]으로 이메일을 보내세요. 제공 가능 여부는 현지 규정에 따라 달라집니다.

결제는 월 이용료 없는 선불 USD 지갑 하나로 이루어집니다. 카드 또는 USDT/USDC로 충전할 수 있고, 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 연동 작업 중에는 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 지갑 잔액을 쓰지 않고도 시뮬레이션된 번호와 코드를 받을 수 있습니다.

자주 묻는 질문

현지 SIM 없이 앱의 크로아티아 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 +385 번호를 주문해 가입 양식에 입력하고, 대시보드나 API에서 코드를 확인하세요. 실제 크로아티아 SIM은 필요하지 않습니다.

OTP Route API에서 크로아티아의 국가 id는 무엇인가요?

hr입니다. POST /api/v1/activations의 country 값과 가격 조회 쿼리에 이 값을 전달하세요.

크로아티아 인증 번호는 얼마인가요?

가격은 코드당 $0.20부터 시작하며 서비스에 따라 다릅니다. 정확한 금액은 GET /api/v1/prices가 반환하고, 확정하기 전에 대시보드에도 표시됩니다.

코드가 도착하지 않으면 요금이 청구되나요?

아니요. 20분 후 아무것도 오지 않고 만료되었거나 직접 취소한 +385 주문은 지갑으로 전액 환불됩니다.

크로아티아 번호는 앞의 0을 포함해서 저장해야 하나요?

앞의 0 없이 +385 뒤에 국내 번호를 붙인 E.164 형식으로 저장하세요. 국내용 09 형식은 크로아티아 사용자가 기대하는 경우에 표시용으로만 유지하세요.

SMS는 크로아티아어로 오나요?

현지 서비스는 보통 크로아티아어 문구를 보내고, 국제 앱은 계정이나 기기 언어를 따릅니다. 문구가 아니라 숫자를 파싱하세요.

모든 서비스가 OTP Route의 +385 번호를 허용하나요?

아니요. 일부 서비스는 가상 번호를 거부하며, 그래서 도착하지 않은 코드는 환불됩니다. 각 서비스의 약관을 항상 준수하세요. OTP Route 이용 정책도 함께 적용됩니다.

반복 로그인을 위해 크로아티아 번호를 계속 보유할 수 있나요?

셀프 서비스로는 불가능합니다. 장기 전용 번호는 미국과 캐나다에만 있으며, 크로아티아는 [email protected]으로 문의해 주세요.

서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.