알바니아(+355) OTP를 테스트 파이프라인으로 라우팅하기

알바니아 번호와 그 코드를 반환하는 REST 호출은 무엇인가요?

알바니아 OTP API는 모든 시장에서 쓰는 SMS 인증 API와 동일하며 국가 id만 바뀝니다. 요청은 개발자 콘솔에서 생성한 접두사 or_live_의 Bearer 키와 함께 https://otproute.com/api/v1로 보냅니다. 알바니아의 id는 al이며, 일반적인 실행은 다음과 같습니다.

1. GET /api/v1/services로 필요한 서비스 id(예: telegram 또는 google)를 확인합니다. 목록은 실행 사이에 캐시해 두세요.
2. GET /api/v1/prices?country=al&service=<id>로 실시간 가격을 읽고 지금 그 경로가 열려 있는지 확인합니다.
3. {"service": "telegram", "country": "al"}와 함께 POST /api/v1/activations를 호출하면 활성화 id와 +355 번호가 반환됩니다.
4. 테스트가 그 번호를 테스트 대상 앱의 가입 또는 로그인 화면에 제출합니다.
5. 코드는 웹훅이나 GET /api/v1/activations/{id} 폴링으로 도착하며, 테스트가 중단되면 POST /api/v1/activations/{id}/cancel을 호출합니다.

계정은 키를 최대 10개까지 가질 수 있으므로 스테이징, CI, 동료의 노트북에 각각 키를 주고 따로 폐기할 수 있습니다. 분당 300건 요청 한도는 여러 스위트를 병렬로 돌리기에 넉넉합니다. 필드별 세부 정보는 API 레퍼런스에 있습니다.

알바니아 테스트는 폴링과 웹훅 중 무엇을 써야 하나요?

폴링은 가장 빨리 붙일 수 있는 방법입니다. 상태가 바뀔 때까지 몇 초마다 활성화 엔드포인트를 호출하면 됩니다. 스위트가 병렬로 돌기 시작하면 웹훅이 더 깔끔합니다. 엔드포인트를 최대 5개 등록하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요.

모든 전송에는 서명이 붙습니다. X-OTPRoute-Signature 헤더의 형식은 t=<unix>,v1=<hex>이며, v1은 엔드포인트 시크릿으로 계산한 "<t>.<raw body>"의 HMAC-SHA256입니다. 손대지 않은 요청 바이트로 다시 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프가 붙은 요청은 버리세요. 이벤트는 활성화 id를 키로 다뤄서, 재전송되어도 두 번 기록되지 않게 하세요. 완전한 핸들러는 웹훅 기반 OTP 수집 글에서 단계별로 보여 줍니다.

+355 번호는 데이터베이스에 넣기 전에 어떻게 정규화해야 하나요?

알바니아는 국가 코드 +355와 국내 트렁크 접두사 0을 사용합니다. 국내에서 휴대전화 번호는 보통 앞에 0을 붙여 06X XXX XXXX로 쓰고, 국제 형식에서는 이를 빼서 +355 6X XXX XXXX로 씁니다. E.164 버전(+3556…, 공백 없음)으로 저장하고, 현지 형식은 표시할 때만 적용하세요.

테스트용으로 +355 번호를 검증할 때 추가할 만한 점검 사항은 다음과 같습니다.

• 사용자가 이미 +355를 선택한 뒤 국내 형식으로 입력하면 앞의 0을 제거하세요.
• 양식이 국가 코드를 현지 번호에 무작정 붙일 때 나타나는 +355 0 6X 같은 접두사 중복을 거부하세요.
• 저장 값에서 공백, 대시, 괄호를 제거하세요.

코드 앞뒤의 문구는 발송 서비스와 계정의 언어 설정에 따라 다르며, 알바니아어와 영어가 모두 흔합니다. 고정된 문장 대신 파서가 숫자를 겨냥하도록 하세요. 팀이 이 시장을 테스트하는 이유는 알바니아 출시, 지역 안팎의 알바니아어 사용자를 위한 앱 현지화, 또는 지역 운영 계정이 여전히 인증되는지 확인하기 위해서입니다.

알바니아 경로에서 어떤 서비스를 인증할 수 있나요?

알바니아 경로에는 현재 1,500개가 넘는 서비스가 나열되어 있습니다. 실시간 스냅샷의 인기 항목은 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, Signal, Microsoft & Outlook, ChatGPT (OpenAI), Uber, LinkedIn, Discord입니다.

재고는 하루 동안 변하므로 가용성은 정적인 목록이 아닌 API에서 가져옵니다. 각 테스트를 al에 대한 가격 조회로 게이트하고, 경로가 닫혀 있으면 실패가 아닌 건너뜀으로 표시하세요. 그러면 OTP 라우팅 잡음이 실제 회귀 테스트 결과에 섞이지 않습니다.

개발자가 아닌 팀원도 +355 번호를 주문할 수 있나요?

네. 대시보드는 코드 없이 같은 흐름을 제공합니다.

1. 이메일과 6자리 이메일 코드 또는 Google 로그인으로 가입한 뒤 TOTP 2단계 인증을 켜세요.
2. 카드 또는 USDT/USDC로 지갑에 자금을 충전하세요.
3. 알바니아와 서비스를 선택하고, 표시된 가격을 확인한 뒤 주문을 확정하세요.
4. 알바니아 인증용 번호를 앱에 입력하세요. SMS가 도착하면 활성화 페이지에 코드가 표시됩니다.

클라이언트 프로필을 관리하는 에이전시와 지역 비즈니스 계정을 설정하는 운영 담당자가 보통 이 경로를 씁니다. 여기서 한 주문과 API로 한 주문은 같은 지갑과 같은 환불 규칙을 공유합니다.

알바니아 SMS가 오지 않으면 어떻게 하나요?

활성화는 20분 동안 열려 있습니다. 코드가 도착해야만 비용을 냅니다. 시간 창이 빈 채로 끝나거나 일찍 취소하면 전체 금액이 저절로 지갑에 돌아가며, 웹훅은 activation.expired 또는 activation.cancelled를 보냅니다.

코드가 보이지 않을 때는 이렇게 해 보세요.

• 일부 서비스는 천천히 보내므로, 반응하기 전에 시간 창을 충분히 기다리세요.
• 서비스가 가상 번호를 허용하는지 먼저 확인하세요. 일부는 정책상 거부합니다.
• 나중에 다시 시도하거나, 테스트가 허용한다면 다른 서비스 경로로 시도하세요.
• 짧은 루프에서 재주문하지 마세요. 스크립트가 경로를 두드리지 않도록 시도 사이에 간격을 두세요.

실패한 OTP 전송 줄이기 글에는 발칸 경로와 그 밖의 경로를 위한 재시도 패턴이 더 정리되어 있습니다. 이 번호는 본인의 제품과 계정에만 사용하고, 각 서비스의 약관을 지키며, OTP Route의 이용 정책(Acceptable Use Policy)이 적용된다는 점을 유념하세요.

알바니아의 장기 회선이 있나요? 요금은 어떻게 청구되나요?

알바니아에는 셀프 서비스 방식의 장기 번호가 없습니다. Dedicated Virtual Numbers는 미국과 캐나다에서만 즉시 판매되며 월 $1.95부터이고, 수신 SMS, 웹훅 전달, 발신 SMS, 브라우저 통화를 지원합니다. 오래 쓸 알바니아 회선이 필요하면 [email protected]으로 이메일을 보내세요. 마련 가능 여부는 현지 규정에 달려 있고 보장되지 않습니다.

요금 청구는 월 요금도 선택할 요금제도 없는 하나의 선불 USD 지갑으로 이루어집니다. 카드 또는 USDT/USDC로 충전하며, 충전마다 PDF 인보이스가 이메일로 발송됩니다. 실시간 요금은 요금 페이지에 있습니다. 연동 작업에는 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 시뮬레이션된 번호와 코드를 반환하므로 지갑 자금을 쓰지 않고도 파이프라인을 시험해 볼 수 있습니다.

자주 묻는 질문

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

네. 국가 al로 OTP Gateway 번호를 주문해 가입 화면에 제출하고, 대시보드나 웹훅에서 코드를 확인하세요. SIM이나 현지 통신사 계약은 필요하지 않습니다.

알바니아 인증 코드는 얼마인가요?

코드는 $0.20부터 시작하며, 서비스별 정확한 가격은 주문 전에 GET /api/v1/prices가 반환합니다. 20분의 시간 창 안에 아무것도 도착하지 않으면 요금이 지갑으로 돌아갑니다.

알바니아 번호를 맨 앞 0과 함께 저장해야 하나요?

아니요. +355 뒤에 트렁크 0 없는 국내 번호를 붙인 E.164 형식으로 저장하고, 0은 현지 표시용으로만 다시 붙이세요.

같은 +355 번호를 나중 로그인에 재사용할 수 있나요?

OTP Gateway 번호는 인증 코드 한 건만 처리합니다. 계속 로그인해야 하는 계정에는 미국 또는 캐나다의 Dedicated Number를 쓰거나, 알바니아에 대해서는 지원팀에 문의하세요.

OTP Route에는 알바니아 연동 테스트용 샌드박스가 있나요?

개발 계정에 요청하면 샌드박스 모드를 켤 수 있습니다. 시뮬레이션된 번호와 코드를 반환하므로 지갑 자금을 쓰지 않고 CI에서 전체 흐름을 실행해 볼 수 있습니다.

알바니아 번호가 앱에서 거부된 이유는 무엇인가요?

일부 서비스는 가상 번호를 거부합니다. 활성화를 취소하거나 만료시키면 자동으로 환불되며, 이후 다른 시간대에 또는 다른 경로로 다시 시도해 보세요.

알바니아에는 어떤 API id를 사용하나요?

가격 조회와 활성화 요청의 country 값으로 al을 사용하고, 서비스 id는 GET /api/v1/services에서 가져오세요.

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