포르투갈 출시를 위한 +351 인증 코드의 프로그래밍 방식 수신

+351 인증 한 건에는 어떤 엔드포인트가 필요한가요?

기본 URL은 https://otproute.com/api/v1이며, 모든 요청에는 or_live_로 시작하는 Bearer 키가 포함됩니다. 포르투갈의 국가 ID는 pt입니다.

1. GET /api/v1/countries와 GET /api/v1/services로 ID를 확인합니다. 테스트 실행마다 캐시해 두세요.
2. GET /api/v1/prices?country=pt&service=<id>는 현재 가격과 해당 경로의 개통 여부를 반환합니다.
3. POST /api/v1/activations에 {"service": "telegram", "country": "pt"}를 보내면 번호가 예약되고 활성화 ID가 반환됩니다.
4. 폴링을 선호한다면 GET /api/v1/activations/{id}가 상태와 코드를 알려줍니다.
5. POST /api/v1/activations/{id}/cancel은 테스트에서 더 이상 필요 없는 번호를 해제합니다.
6. GET /api/v1/balance로 지갑 잔액이 부족할 때 파이프라인을 일찍 중단할 수 있습니다.

계정 한도는 API 키 10개, 웹훅 엔드포인트 5개, 분당 요청 300건입니다. 전체 스키마는 API 레퍼런스에 있습니다.

서명된 웹훅은 포르투갈 코드를 서비스로 어떻게 전달하나요?

개발자 콘솔에서 HTTPS 엔드포인트를 등록하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요. 각 POST에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다.

검증하려면 <t>.<raw body> 문자열을 다시 만들고, 엔드포인트 시크릿으로 HMAC-SHA256을 계산한 뒤 v1과 상수 시간 비교를 하세요. 타임스탬프가 너무 오래된 요청은 거부해야 가로챈 요청이 재사용되지 않습니다. 이벤트마다 활성화 ID를 저장하고 중복은 무시하면 전송이 재시도되어도 핸들러가 안전합니다. 이 패턴은 웹훅 기반 OTP 수신에서 단계별로 설명합니다.

포르투갈 경로에서는 어떤 서비스를 쓸 수 있나요?

현재 스냅샷 기준으로 포르투갈에는 2,000개 이상의 서비스가 표시됩니다. 자주 쓰이는 서비스는 WhatsApp, Telegram, Airbnb, Uber, Google(Gmail 및 YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft 및 Outlook, Amazon, Netflix, Discord, Signal 등입니다.

이 목록은 통신사 파트너의 용량 변화에 따라 하루 중에도 달라집니다. 그래서 정적 설정 파일이 아니라 가격 엔드포인트가 테스트 실행 여부를 결정해야 합니다.

제품팀은 왜 포르투갈 번호로 테스트하나요?

포르투갈은 EU 출시 계획에서 초기에 등장하는 시장입니다. 리스본과 포르투에는 많은 제품·엔지니어링 팀이 있고, 유럽 거점으로 포르투갈을 쓰는 기업도 많습니다. 현지화 측면의 이유도 있습니다. 유럽 포르투갈어(pt-PT)는 브라질 포르투갈어와 철자, 어휘, 호칭이 달라서 브라질 기준으로 번역한 플로우는 포르투갈 사용자에게 어색하게 읽힐 수 있습니다. 실제 +351 인증을 거치면 검토자가 pt-PT 문구, 도착하는 SMS, 주변 화면을 한꺼번에 확인할 수 있습니다.

GDPR 관점에서도 테스트·공용 계정에 직원 전화번호를 쓰지 않는 것이 좋은 데이터 최소화입니다. 확인할 때마다 일회용 번호를 쓰면 QA 시스템에 남는 개인 식별 정보가 줄어듭니다. CI 파이프라인 가이드에서 이 과정을 모든 빌드에 포함하는 방법을 볼 수 있습니다.

+351 번호는 어떻게 표기하고 저장하나요?

포르투갈에는 트렁크 접두사가 없습니다. 번호는 9자리이며 국내에서나 +351 뒤의 국제 형식에서나 똑같이 다이얼합니다. 휴대전화 번호는 9로 시작하고, 지역 유선 번호는 2로 시작합니다. E.164로 저장하고, 국가 코드 뒤가 9자리가 아니면 거부하며, 사용자가 세 자리씩 끊어 입력한 공백은 제거하세요.

수신되는 코드는 발신 서비스와 계정 언어 설정에 따라 보통 포르투갈어 또는 영어로 도착합니다. 코드 추출기는 고정된 문구가 아니라 숫자를 찾아야 합니다.

팀원이 코드 없이도 할 수 있나요? SMS가 오지 않으면 어떻게 하나요?

대시보드에서 OTP Gateway를 열고 포르투갈과 서비스를 선택한 뒤 실시간 가격을 확인하고 주문하세요. 번호를 앱에 붙여 넣고 활성화 페이지에서 코드를 기다리면 됩니다.

유효 시간은 20분이며, 코드가 도착한 경우에만 요금을 내고 그렇지 않으면 전액이 지갑으로 자동 환불됩니다. 코드가 오지 않을 때는 다음을 확인하세요.

• 몇 초 만에 취소하지 말고 유효 시간이 끝날 때까지 기다리세요.
• 해당 플로우에서 서비스가 가상 번호를 허용하는지 확인하세요.
• 나중에 다시 시도하거나 다른 서비스 경로로 같은 화면을 테스트하세요.
• 짧은 간격으로 반복 주문하지 말고 시도 사이에 간격을 두세요.

포르투갈 전용 회선이 있나요? 요금은 어떻게 청구되나요?

OTP Route는 포르투갈에서 셀프서비스 전용 번호를 판매하지 않습니다. Dedicated Virtual Numbers는 미국과 캐나다에만 있으며 월 $1.95부터입니다. 장기 +351 회선이 필요하면 [email protected]으로 문의하세요. 다만 제공 여부는 현지 규정에 따라 다르며 보장되지 않습니다. 임시 번호와 전용 번호의 차이도 참고하세요.

결제는 선불 USD 지갑에서 사용한 만큼 내는 방식이며 월 요금이나 요금제는 없습니다. 카드 또는 USDT/USDC로 충전하고, 충전할 때마다 PDF 인보이스가 발급됩니다. 개발 계정은 요청 시 샌드박스로 전환해 모의 번호와 코드로 테스트할 수 있습니다. 각 서비스의 약관을 따라야 하며 OTP Route의 이용 정책(Acceptable Use Policy)이 적용됩니다.

자주 묻는 질문

OTP Route API에서 포르투갈의 국가 ID는 무엇인가요?

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

포르투갈 전화번호에는 맨 앞 0 같은 트렁크 접두사가 있나요?

아니요. 포르투갈 번호는 트렁크 접두사 없이 9자리이므로 E.164 형식은 +351 뒤에 그 9자리가 붙습니다.

포르투갈 SIM 카드 없이 pt-PT 온보딩 플로우를 테스트할 수 있나요?

네. OTP Gateway의 테스트용 +351 번호가 코드를 수신하며, 대시보드나 API에서 확인할 수 있습니다.

포르투갈 인증 번호는 얼마인가요?

$0.20(코드당)부터이며, 정확한 가격은 서비스에 따라 다르고 주문 전에 표시됩니다.

아무것도 수신하지 못한 +351 활성화에도 요금을 내나요?

아니요. 만료되거나 취소된 활성화는 지갑으로 전액 환불됩니다.

계속 로그인할 용도로 포르투갈 번호를 임대할 수 있나요?

셀프서비스로는 불가능합니다. 장기 회선은 미국과 캐나다 전용 제품이며, +351 회선이 필요하면 지원팀에 이메일로 문의하세요.

포르투갈 코드는 폴링과 웹훅 중 무엇을 써야 하나요?

병렬 작업에는 웹훅이 더 잘 확장되고, 인바운드 트래픽을 받을 수 없는 러너에는 GET /api/v1/activations/{id} 폴링이 적합합니다.

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