에스토니아 +372 인증번호 수신을 위한 사전 점검 체크리스트

첫 +372 주문 전에 무엇을 점검해야 하나요?

테스트 실패의 상당수는 번호를 요청하기도 전에 빠뜨린 준비물에서 비롯됩니다. 먼저 아래 항목을 확인하세요.

• API 키: Developer 콘솔에서 만든 키입니다. 모든 키는 or_live_ 접두사를 가지며 Bearer 토큰으로 전달됩니다. 계정당 10개까지 만들 수 있으므로 CI 러너에는 전용 키를 따로 두는 것이 좋습니다.
• 웹훅 엔드포인트: 폴링 대신 호출을 받고 싶다면 시크릿을 서버 쪽에 안전하게 보관한 엔드포인트를 준비하세요. 계정당 5개까지 허용됩니다.
• 올바른 ID: 모든 요청에서 에스토니아는 ee이며, 서비스 ID는 GET /api/v1/services에서 가져옵니다.
• 실시간 가격 확인: 작업이 지갑 잔액을 쓰기 전에 비용을 알 수 있도록 GET /api/v1/prices?country=ee&service=<id>를 호출하세요.
• 아직 연동 중이라면 샌드박스: 요청 시 개발용 계정을 샌드박스 모드로 전환할 수 있으며, 잔액을 쓰지 않고 시뮬레이션된 번호와 코드로 처음부터 끝까지 테스트할 수 있습니다.
• 호출 한도 계획: API는 계정당 분당 300건을 허용합니다. 테스트 스위트가 무심코 과도하게 폴링하지 않는 한 충분한 양입니다.

각 항목은 OTP API 연동 가이드에서 더 자세히 다룹니다.

에스토니아 OTP API 요청을 처음부터 끝까지 어떻게 실행하나요?

체크리스트를 마쳤다면 호출 순서는 짧습니다.

1. 본문 {"service": "<id>", "country": "ee"}로 POST /api/v1/activations를 호출합니다. 응답에는 activation id와, 테스트 중인 가입·로그인 양식에 입력할 +372 번호가 들어 있습니다.
2. 테스트 중인 앱에서 인증 SMS 발송을 일으킵니다.
3. 코드를 기다립니다. 엔드포인트가 activation.sms_received를 받거나, 적당한 간격으로 GET /api/v1/activations/{id}를 호출합니다.
4. 앱에 코드를 입력하고 결과를 activation id와 함께 기록합니다.
5. 테스트 경로가 바뀌어 번호가 더 필요 없다면 POST /api/v1/activations/{id}/cancel을 호출해 점유를 즉시 해제합니다.

웹훅 수신 시에는 X-OTPRoute-Signature 헤더(t=<unix>,v1=<hex>)를 읽고, 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산한 뒤 상수 시간 비교로 대조하세요. 타임스탬프가 오래된 요청은 버립니다. HMAC으로 OTP 웹훅 보호하기에서 참고용 핸들러를 확인할 수 있습니다. 재시도 때문에 같은 이벤트가 두 번 전달될 수 있으므로, 쓰기 작업은 activation id 기준으로 멱등하게 만드세요.

에스토니아 인증번호로 코드를 보낼 수 있는 서비스는 무엇인가요?

현재 에스토니아 스냅샷에는 1,700개가 넘는 서비스가 올라와 있습니다. 인기 경로로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, LinkedIn, Microsoft & Outlook, Amazon, Discord, Signal, Uber, Airbnb, ChatGPT (OpenAI) 등이 있습니다.

재고는 하루 중에도 변하므로, 아침에 응답하던 경로가 저녁에는 한산할 수 있습니다. 목록을 테스트 픽스처에 하드코딩하지 말고 GET /api/v1/countries와 가격 엔드포인트를 기준으로 삼으세요.

+372 번호는 어떻게 저장하고 검증해야 하나요?

에스토니아는 번호 체계가 비교적 단순한 편이어서 오히려 허술한 검증 로직이 걸려 넘어지기 쉽습니다. 제거해야 할 국내 접두 0이 없으므로, 국내에서 쓰는 번호는 +372 뒤에 그대로 붙이는 숫자와 같습니다. 휴대전화 번호는 보통 5로 시작하고 7자리 또는 8자리이므로, 국내 번호 길이를 고정하는 정규식은 올바른 입력을 거부하게 됩니다.

양식과 데이터베이스에 적용할 실무 규칙은 다음과 같습니다.

• +3725xxxxxxx처럼 전체 E.164 문자열을 저장하고, 고객 지원에 필요하면 사용자의 원본 입력은 따로 보관하세요.
• 0을 앞에 붙이지 마세요. 제거하거나 추가할 것이 없습니다.
• 입력 마스크에서 7자리와 8자리 휴대전화 번호를 모두 테스트하세요.

에스토니아 사용자에게 가는 인증 문자는 보통 에스토니아어로 도착하지만, 계정이나 기기 언어를 따르는 앱도 많고 러시아어나 영어 템플릿도 흔합니다. 제품에 에스토니아어 로케일이 있다면 õ, ä, ö, ü 같은 글자가 템플릿에서 단말기까지 깨지지 않고 전달되는지 확인하세요.

팀들은 왜 에스토니아 번호로 가입 흐름을 테스트하나요?

에스토니아는 국토 규모에 비해 소프트웨어 팀에게 존재감이 큽니다. 디지털 정부로 알려진 명성과 e-Residency 프로그램 덕분에, 직원이 다른 곳에 있더라도 이 나라와 연결된 창업자와 원격 근무 기업이 많고, 발트·북유럽 시장을 겨냥한 제품은 이곳에서 먼저 출시되는 경우가 많습니다.

QA 리드가 테스트용 +372 번호를 요청하는 대표적인 이유는 다음과 같습니다.

• 번호 체계가 짧은 EU 시장에서 국가 선택기, 전화번호 마스크, SMS 템플릿이 제대로 동작하는지 확인
• 지역 출시 전에 에스토니아어 문구의 현지화 점검
• 코드가 오지 않았다는 에스토니아 고객의 지원 티켓 재현

팀이 이런 점검을 릴리스 주기에 녹이는 방법은 QA 테스트에서 볼 수 있습니다.

코드가 오지 않으면 무엇을 확인해야 하나요?

번호를 계속 새로 주문하기보다 순서대로 문제를 살펴보세요.

1. 시간을 끝까지 두세요. 활성화는 20분간 열려 있으며, 일부 서비스는 문자를 대기열에 쌓아 두었다가 보냅니다.
2. 서비스가 가상 번호를 받는지 확인하세요. 정책상 거부하는 서비스가 있으며, 환불 제도가 있는 이유입니다.
3. 최종 상태를 보세요. activation.expired 이벤트나 GET 호출에서 만료 상태가 보인다면 SMS가 오지 않았다는 뜻이며 돈은 이미 지갑으로 돌아와 있습니다.
4. 여유를 두고 재시도하세요. 짧은 간격으로 반복 주문하지 말고, 조금 뒤에 다시 하거나 같은 서비스의 다른 경로를 시도하세요.
5. 자체 트리거를 점검하세요. 실제로 SMS를 요청하지 않은 테스트는 코드가 오지 않은 것과 똑같아 보입니다.

배제해 볼 만한 다른 원인은 OTP 전달 실패 줄이기 글에 정리되어 있습니다.

에스토니아 회선을 장기간 보유할 수 있나요? 요금은 어떻게 청구되나요?

셀프서비스로 이용할 수 있는 장기 에스토니아 번호는 없습니다. Dedicated Numbers는 미국과 캐나다 전용 상품으로 월 $1.95부터 시작합니다. 에스토니아에서 지속적으로 쓸 회선이 필요하다면 [email protected]으로 문의하세요. 팀이 현지 규정상 가능한 범위를 알려 드리지만 이용 가능성을 약속하지는 않습니다.

OTP 라우팅 요금은 선불 USD 지갑 하나로 처리되며 월 요금도, 고를 요금제도 없습니다. 카드나 USDT, USDC로 충전할 수 있고 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 현재 요금은 요금 페이지에, 엔드포인트 레퍼런스는 문서에 있습니다.

자주 묻는 질문

현지 SIM 없이 우리 앱의 에스토니아 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 +372 번호를 주문해 가입 양식에 입력한 뒤, 대시보드나 웹훅, 활성화 엔드포인트에서 코드를 읽으면 됩니다.

OTP Route API에서 에스토니아의 국가 ID는 무엇인가요?

활성화 요청과 가격 조회의 country 값으로 ee를 사용하세요.

에스토니아 전화번호에는 제거해야 할 국내 접두 번호가 있나요?

아니요. 에스토니아에는 국내 접두 번호가 없어서 국내 번호의 숫자가 +372 뒤에 그대로 이어집니다.

에스토니아 코드가 오지 않으면 요금이 청구되나요?

아니요. 20분의 활성화 시간 안에 아무것도 도착하지 않거나 먼저 취소하면 전액이 자동으로 지갑에 환불됩니다.

개발자가 아니어도 에스토니아 인증번호를 주문할 수 있나요?

네. 대시보드에서 에스토니아와 서비스를 선택하고, 표시된 가격을 확인한 뒤 번호를 앱에 복사해 넣으면 같은 화면에 코드가 나타납니다.

실제 자금을 쓰기 전에 에스토니아 연동을 미리 연습할 수 있나요?

지원팀에 요청해 개발용 계정을 샌드박스로 전환하세요. 시뮬레이션된 번호와 코드가 반환되므로 지갑 잔액 없이 전체 흐름을 실행할 수 있습니다.

이 번호를 사용할 때 지켜야 할 규칙이 있나요?

각 서비스의 약관과 OTP Route의 Acceptable Use Policy를 따라야 합니다. 번호는 자사 제품 테스트와 정당한 계정 운영에만 사용해야 합니다.

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