개발자와 QA 팀을 위한 이탈리아(+39) 인증 번호

이탈리아 전화번호가 검증기에서 까다로운 이유는 무엇인가요?

이탈리아는 많은 정규화 로직이 암묵적으로 가정하는 규칙을 깨뜨립니다. 유럽의 다른 나라에서는 국가 코드를 붙일 때 국내 0을 빼지만, 이탈리아의 유선전화는 0을 유지합니다. 로마 번호는 +39 06 …, 밀라노 번호는 +39 02 …로 씁니다. 휴대전화 번호는 3으로 시작하며 보통 +39 뒤에 10자리가 오고, 앞에 0이 없습니다.

따라서 국가 코드 뒤의 맨 앞 0을 제거하는 라이브러리는 이탈리아 유선전화 번호를 훼손하고, 고정 길이를 고집하는 검증기는 유효한 번호를 거부할 수 있습니다. 전체 E.164 문자열을 +39와 국내 번호 그대로 저장하고, 전화번호 파싱 테스트에 이탈리아 케이스를 추가하세요.

이탈리아 QA용 실용적인 픽스처 세트에는 최소한 휴대전화 번호 하나, 로마 유선전화 번호 하나, 밀라노 유선전화 번호 하나가 있어야 합니다. 세 가지를 파서, 데이터베이스 왕복, 표시용 포맷터에 모두 통과시키고 저장된 값이 입력값과 동일한지 확인하세요.

팀이 +39 경로에서 인증 테스트를 하는 이유는 무엇인가요?

이탈리아는 EU에서 큰 시장 중 하나여서, 제품이 유럽 한 나라에서 다음 나라로 확장할 때 흔히 거치는 곳입니다. 현지화 QA도 중요합니다. 이곳의 인증 메시지는 보통 이탈리아어로 도착하며, 자사 템플릿에서도 악센트 문자, 날짜 형식, 문구 길이를 확인해야 합니다. 마켓플레이스, 핀테크, 배달 앱도 현지 결제나 배송 파트너를 켜기 전에 이탈리아 온보딩을 테스트합니다. 이 패턴은 핀테크 온보딩 노트에서 다룹니다.

운영 팀에도 그들만의 이유가 있습니다. 이탈리아 고객의 소셜 또는 마켓플레이스 프로필을 관리하는 에이전시는 직원의 개인 휴대전화가 아닌 번호로 해당 비즈니스 계정을 인증하는 쪽을 선호하며, 공유 로그인과 어떻게 어울리는지는 운영 팀 페이지에 설명되어 있습니다.

이탈리아 목록에는 어떤 서비스가 있나요?

현재 2,100개가 넘는 서비스가 이탈리아 경로 번호로 코드를 보낼 수 있습니다. 인기 서비스로는 WhatsApp, Instagram, Facebook, Google (Gmail & YouTube), Amazon, eBay, Airbnb, Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Discord, ChatGPT (OpenAI)가 있습니다. 이 목록은 실시간이므로 오래 캐시해 두지 말고 그때그때 조회하세요.

API로 `it` 흐름은 어떻게 동작하나요?

or_live_로 시작하는 Bearer 키를 사용해 https://otproute.com/api/v1로 요청을 보냅니다. GET /api/v1/prices?country=it&service=<id>로 비용을 확인한 다음, POST /api/v1/activations와 {"service": "<id>", "country": "it"}로 주문을 만듭니다. 응답으로 활성화 ID를 받으면 GET /api/v1/activations/{id}를 폴링하거나 activation.sms_received 웹훅을 기다리고, 나머지 두 가지 종료 상태인 activation.expired와 activation.cancelled도 처리하세요.

X-OTPRoute-Signature("<t>.<raw body>"의 HMAC-SHA256)는 항상 검증하고 오래된 타임스탬프는 거부하세요. 자세한 내용은 HMAC 가이드에 있습니다. 계정당 키 10개, 웹훅 엔드포인트 5개, 분당 요청 300건까지 허용됩니다.

CI 파이프라인에서는 설정 단계에서 번호를 주문하고, SMS를 유발하는 브라우저 테스트를 실행한 다음, 웹훅이 도착하거나 시간이 끝날 때까지 수명이 짧은 리스너에서 대기하는 방식이 흔합니다. 중단된 실행이 번호를 열어 둔 채로 남기지 않도록 정리 단계에서 취소하세요.

대시보드에서 주문하기

개발자가 아니어도 웹 앱에서 같은 작업을 할 수 있습니다. OTP Gateway를 열고, 서비스와 이탈리아를 선택하고, 가격을 확인한 뒤 +39 번호를 테스트 중인 앱에 복사하세요. 코드는 도착하는 즉시 화면에 나타납니다. 오지 않는다면 시간이 끝날 때까지 기다리고, 서비스가 가상 번호를 허용하는지 확인한 다음, 반복 주문하는 대신 나중에 또는 다른 경로로 다시 시도하세요.

시도할 때마다 어떤 서비스와 경로를 썼는지 기록해 두세요. 문제가 특정 앱에만 해당하는지, 그 시간대에 이탈리아 경로 전체에 영향을 주는지 훨씬 쉽게 파악할 수 있습니다.

이탈리아 고정 회선이 있나요? 요금은 어떻게 청구되나요?

이탈리아용 셀프서비스 장기 번호는 없습니다. 전용 번호(Dedicated Number)는 월 $1.95부터이며 미국과 캐나다에서만 제공됩니다. 이탈리아 회선이 궁금하면 [email protected]으로 문의하되, 가능 여부는 현지 규정에 따라 달라진다는 점을 알아 두세요. 요금은 카드 또는 USDT/USDC로 충전하는 선불 USD 지갑으로 청구되며 PDF 인보이스가 제공되고 월 요금은 없습니다. 시작하려면 요금 안내를 보거나 가입하시고, 개발하는 동안에는 샌드박스 모드를 요청하세요.

자주 묻는 질문

이탈리아 번호에 +39를 붙일 때 0을 빼야 하나요?

유선전화는 빼지 않습니다. 이탈리아 유선전화 번호는 +39 뒤에도 맨 앞 0을 유지합니다. 휴대전화 번호는 3으로 시작하므로 처음부터 0이 없습니다.

OTP Route API에서 이탈리아의 국가 ID는 무엇인가요?

it이며, 가격 조회와 활성화 본문 모두에 사용합니다.

이탈리아 밖에서도 이탈리아 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway의 +39 번호는 팀이 어디에 있든 코드를 받으며, 대시보드나 API로 확인할 수 있습니다.

이탈리아 SMS OTP는 비용이 얼마인가요?

이탈리아 코드는 코드당 $0.20 이상에서 시작합니다. API가 서비스별 현재 요금을 알려 주고, 대시보드는 확정 전에 이를 표시합니다.

이탈리아 코드가 도착하지 않으면 어떻게 되나요?

20분이 지나면 활성화가 만료되고 금액이 지갑으로 자동 환불되며, 별도 문의는 필요하지 않습니다.

다음 달에도 같은 +39 번호를 다시 쓸 수 있나요?

아니요. 게이트웨이 번호는 한 번의 인증용입니다. 장기 회선은 미국과 캐나다에서만 이용할 수 있습니다.

인증 메시지가 이탈리아어로 도착하나요?

국가별로 현지화하는 발신자가 많아 자주 그렇지만, 계정의 언어 설정을 따르는 경우도 있습니다. 문구가 아니라 숫자를 기준으로 파서를 만드세요.

알아 두어야 할 사용 제한이 있나요?

각 서비스의 약관과 OTP Route의 허용 사용 정책(Acceptable Use Policy)을 따르세요. 게이트웨이는 자신의 합법적인 제품을 테스트하고 운영하기 위한 것이지 대량 계정 생성용이 아닙니다.

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