QA와 지역 출시를 위한 조지아 +995 SMS 코드 수신

국가 조지아는 왜 테스트 계획에서 혼동을 일으키나요?

첫 번째 함정은 이름입니다. 국가 조지아는 미국의 주 이름과 같아서 양식 라이브러리, 분석 필터, 심지어 팀원들도 둘을 혼동합니다. API에서 국가 ID는 ISO 코드 GE에 맞춘 ge이고 국가 번호는 +995입니다. 누군가 검색창에 "Georgia"를 입력했다는 이유로 테스트가 조용히 미국 +1 번호를 고르는 것은 일찍 잡아낼 만한 버그입니다.

두 번째는 문자입니다. 조지아어는 자체 알파벳인 므헤드룰리를 쓰며 GSM 7비트 문자 집합 밖에 있습니다. 조지아 문자가 들어간 SMS는 유니코드로 전송되므로 세그먼트당 들어가는 글자 수가 줄고 긴 메시지는 더 빨리 나뉩니다. 자사 제품이 조지아어 메시지를 보낸다면 현지화 QA가 바로 이 부분을 확인해야 합니다.

올바르게 저장된 +995 번호는 어떤 모습인가요?

국내에서는 가입자 번호 앞에 0이라는 국내 접두 번호를 누르지만 국제 형식에서는 그 0이 사라집니다. 휴대전화 번호는 9자리이고 5로 시작하므로 E.164 형식은 +995 뒤에 5로 시작하는 9자리가 이어집니다.

조지아 입력값에 적용할 실용적인 정규화 절차는 다음과 같습니다.

• 사용자가 습관적으로 입력하는 공백, 점, 대시를 제거합니다.
• 값이 0으로 시작하고 10자리라면 0을 지우고 +995를 붙입니다.
• 995로 시작하는데 더하기 기호가 없다면 더하기 기호를 붙입니다.
• 더하기 기호 뒤로도 12자리가 되지 않는 값은 거부합니다.

하나의 표준 형식으로 저장하면 테스트가 입력한 번호와 나중에 백엔드가 조회하는 번호가 일치합니다.

어떤 조지아 인증 흐름을 실행해 볼 수 있나요?

조지아 스냅샷에는 현재 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, Discord, LinkedIn, Viber가 표시되며, 전체 카탈로그는 1,500개가 넘는 서비스에 이릅니다.

팀이 여기서 테스트하는 이유는 몇 가지로 반복됩니다. 남캅카스 진출을 앞둔 제품, 트빌리시의 원격 팀이 지역 비즈니스 계정을 인증하는 경우, 가입 화면에서 조지아어 텍스트가 올바르게 렌더링되는지 확인하는 현지화 점검 등입니다. 가용성은 하루 중에도 바뀌므로 테스트용 +995 번호를 예약하기 전에 어제의 목록을 믿지 말고 API에 물어보세요. OTP 라우팅은 그 순간 실제로 사용 가능한 것 중에서 선택합니다.

조지아 OTP API 호출 순서는 어떻게 진행되나요?

모든 호출은 or_live_ 접두사의 Bearer 키로 https://otproute.com/api/v1에 보냅니다. 계정은 키를 최대 10개까지 보유할 수 있어 스테이징과 프로덕션을 분리할 수 있습니다.

1. GET /api/v1/countries를 한 번 호출해 ID ge를 확인합니다.
2. GET /api/v1/prices?country=ge&service=<id>로 오늘의 가격과 가용성을 확인합니다.
3. 예를 들어 {"service": "whatsapp", "country": "ge"}로 POST /api/v1/activations를 호출해 주문합니다.
4. 테스트 중인 앱에 +995 번호를 입력하고 SMS 단계를 일으킵니다.
5. GET /api/v1/activations/{id}에서 코드를 읽거나 웹훅이 전달하게 합니다.
6. 시나리오가 중단되면 POST /api/v1/activations/{id}/cancel로 주문을 해제합니다.

분당 300건이라는 호출 한도는 여러 병렬 작업에서 몇 초마다 폴링해도 여유가 있습니다.

+995 코드는 폴링으로 받아야 하나요, 웹훅으로 받아야 하나요?

두 방식 모두 같은 SMS 인증 API를 사용하며, 노트북에서 조지아 SMS OTP 메시지를 받으려는 개발자 한 명에게는 폴링으로 충분합니다. CI에서는 웹훅이 더 안정적입니다. Developer 콘솔에 엔드포인트를 최대 5개 등록하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요.

모든 요청을 검증하세요. X-OTPRoute-Signature 헤더에는 t=<unix>,v1=<hex>가 들어 있습니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산해 상수 시간으로 비교하고, 타임스탬프가 오래된 요청은 버리세요. 결과를 activation id를 키로 저장하면 중복 전달도 무해합니다. 웹훅 캡처 글에 구체적인 패턴이 있습니다.

조지아 코드가 도착하지 않았습니다. 무엇을 시도해야 하나요?

먼저 20분을 모두 기다리세요. 아무것도 오지 않으면 주문은 스스로 환불됩니다. 그다음 해당 서비스가 조지아 계정에 가상 번호를 받아주는지 따져 보세요. 받지 않는 서비스도 있습니다. 나중에 다시 시도하거나 같은 테스트를 다른 서비스 경로로 실행하면 일시적인 저하가 풀리는 경우가 많습니다. 하지 말아야 할 일은 짧은 간격으로 새 주문을 연달아 넣는 것입니다. 시간만 낭비하고 수신 플랫폼에는 의심스러워 보입니다.

장기 번호, 결제, 샌드박스

OTP Route는 셀프서비스 장기 조지아 번호를 판매하지 않습니다. 전용 회선은 미국과 캐나다에서만 월 $1.95부터 제공됩니다. 지속적인 +995 회선에 대해 문의하려면 [email protected]으로 연락하세요. 답은 현지 규정에 따라 달라집니다.

지갑은 USD 선불이며 구독이 없습니다. 카드나 USDT/USDC로 충전하면 매번 PDF 인보이스를 받습니다. 요청 시 제공되는 샌드박스 계정은 연동 테스트용으로 시뮬레이션된 번호와 코드를 반환합니다. 시작하려면 요금을 보거나 계정을 만드세요.

자주 묻는 질문

미국 주가 아니라 국가 조지아의 번호를 받으려면 어떻게 하나요?

API 호출에서 국가 ID ge를 사용하고 대시보드에서 +995 국가 번호를 확인하세요. 미국의 주에는 자체 국가 ID가 없습니다.

현지 SIM 카드 없이 조지아 가입 흐름을 테스트할 수 있나요?

네. +995 접두사의 OTP Gateway 번호가 코드를 받으며, 대시보드나 API에서 읽으면 됩니다.

조지아 휴대전화 번호를 저장할 때 앞자리 0을 유지하나요?

아니요. 0은 국내 접두 번호이므로 +995 뒤에 5로 시작하는 9자리를 붙여 저장하세요.

조지아어 SMS 메시지는 왜 세그먼트당 짧게 보이나요?

조지아 문자는 GSM 7비트 알파벳 밖에 있어 메시지가 유니코드 인코딩을 쓰고, 그러면 세그먼트마다 들어가는 글자 수가 줄어듭니다.

조지아 인증번호의 가격은 얼마인가요?

코드당 $0.20부터이며 서비스에 따라 다릅니다. 실시간 가격은 GET /api/v1/prices에서 오고 주문 전에 대시보드에도 표시됩니다.

플랫폼이 번호를 거부하면 요금이 청구되나요?

아니요. 20분의 활성화 시간 안에 SMS가 도착하지 않거나 취소하면 전액이 지갑으로 돌아갑니다.

+995 번호로 허용되는 용도는 무엇인가요?

자사 제품 테스트, QA 자동화, 자사 비즈니스 계정 운영입니다. 각 서비스의 약관과 OTP Route Acceptable Use Policy를 따르세요.

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