아르메니아(+374) 인증 코드를 위한 올바른 경로 고르기

아르메니아 인증 작업에는 어떤 OTP Route 제품이 맞나요?

답이 연동 전체의 모양을 좌우하므로 코드를 작성하기 전에 정하세요. OTP Route는 두 가지를 판매하며, 그중 하나만 아르메니아에 닿습니다.

• OTP Gateway: 운영 파트너가 제공하는 번호로, 서비스 하나와 코드 한 건을 위해 예약됩니다. 가입 테스트, 현지화된 온보딩 화면에 대한 회귀 실행, 비즈니스 프로필의 일회성 인증에 적합합니다. +374에는 이것을 사용합니다.
• Dedicated Virtual Numbers: 갱신되는 동안 유지하는 회선으로, 수신·발신 SMS와 브라우저 통화를 지원합니다. 미국과 캐나다에서만 즉시 판매되며 월 $1.95부터입니다.

셀프 서비스 방식의 아르메니아 장기 번호는 없습니다. 프로젝트에 정말 필요하다면 [email protected]으로 사용 사례를 적어 보내세요. 마련 가능 여부는 현지 규정에 달려 있으므로 계획이 아닌 문의로 받아들이세요. 첫 코드 이후에도 계속 로그인해야 하는 계정에는 미국 또는 캐나다의 Dedicated 회선이 현실적인 대안입니다.

+374 번호로 OTP Gateway에서 무엇을 인증할 수 있나요?

아르메니아 경로는 현재 1,700개가 넘는 서비스를 지원합니다. 실시간 스냅샷의 인기 서비스는 WhatsApp, Telegram, Viber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, LinkedIn, Microsoft & Outlook, Discord, ChatGPT (OpenAI), Uber입니다.

메신저에 대해 한마디 하자면, Viber와 Telegram은 모두 아르메니아에서 친숙한 이름이므로 사용자를 채팅 채널로 연결하는 제품이라면 이들에 대한 테스트 계정이 필요한 경우가 많습니다. 서비스별 가용성은 하루 동안 변하며, 그래서 우리는 고정된 목록을 게시하는 대신 API가 실시간으로 반환하도록 합니다.

아르메니아 OTP API 호출은 어떤 순서로 진행되나요?

모든 것은 개발자 콘솔의 접두사 or_live_ Bearer 키와 함께 https://otproute.com/api/v1 아래에 있습니다. 아르메니아의 국가 id는 am입니다.

1. GET /api/v1/services로 서비스 id를 한 번 조회하고, GET /api/v1/countries로 am을 확인합니다.
2. GET /api/v1/prices?country=am&service=<id>로 현재 가격과 경로가 열려 있는지 확인합니다.
3. {"service": "telegram", "country": "am"} 같은 본문으로 POST /api/v1/activations를 호출해 주문을 만들고, 반환된 활성화 id를 저장합니다.
4. +374 번호를 테스트 중인 흐름에 넣은 다음, 웹훅의 activation.sms_received를 기다리거나 GET /api/v1/activations/{id}를 폴링합니다.
5. 실행이 중단되면 POST /api/v1/activations/{id}/cancel을 호출해 자금이 즉시 돌아오게 합니다.

웹훅 요청에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 붙습니다. 엔드포인트 시크릿으로 <t>.<raw body>에 대한 HMAC-SHA256을 계산해 비교하고, 오래된 타임스탬프가 붙은 요청은 버리세요. API 문서에는 같은 활성화 id를 키로 하는 나머지 이벤트인 activation.expired와 activation.cancelled가 나와 있습니다. 계정은 분당 300건 요청으로 제한되므로 폴링은 너무 자주 하지 마세요.

API 권한이 없는 동료도 +374 번호를 주문할 수 있나요?

네. 운영 담당자와 고객지원 담당자는 브라우저에서 똑같이 할 수 있습니다.

1. 로그인해서 OTP Gateway를 열고 아르메니아를 선택합니다.
2. 서비스를 고릅니다. 확정하기 전에 실시간 가격이 표시됩니다.
3. 번호를 그 번호를 요구하는 앱이나 사이트에 복사합니다.
4. 활성화를 열어 둡니다. 코드가 도착하면 번호 옆에 나타납니다.

대시보드와 API는 하나의 지갑과 하나의 주문 내역을 공유하므로, QA 엔지니어와 지원 리드가 같은 잔액으로 일할 수 있습니다.

아르메니아 번호는 어떻게 저장해야 하고, 코드는 어떤 언어로 오나요?

아르메니아 안에서는 사람들이 트렁크 접두사로 맨 앞에 0을 누릅니다. 국제 형식에서는 그 0이 사라지고 국가 코드 +374 뒤에 여덟 자리 국내 번호가 이어집니다. 저장하기 전에 모든 입력을 E.164로 정규화하세요. 공백과 대시를 제거하고, 국내 0을 빼고, 플러스 기호와 374를 유지합니다. 국내 형식을 받아들이면서 손대지 않고 저장하는 양식은, 나중에 테스트 하네스가 보유한 E.164 값과 조회가 맞지 않게 됩니다.

아르메니아어는 고유한 문자를 쓰고 러시아어도 널리 통하므로, 아르메니아어 UI는 실제 현지화 대상입니다. 글로벌 앱의 인증 문자는 보통 앱의 언어 설정을 따르고 영어로 오는 경우가 많지만, 현지화된 템플릿은 아르메니아어나 러시아어 문자로 올 수 있습니다. 주변 단어를 무시하는 패턴으로 숫자를 추출하고, 비라틴 메시지 본문이 깨지지 않도록 로그와 데이터베이스가 UTF-8을 처리하는지 확인하세요.

팀이 이곳을 테스트하는 데는 현실적인 이유가 있습니다. 아르메니아 출시를 위한 현지화된 온보딩, 해외에서 본국 번호로 가입하는 대규모 아르메니아 디아스포라 지원, 남캅카스를 아우르는 지역 운영입니다.

아르메니아 코드가 오지 않을 때는 무엇을 확인해야 하나요?

시간 창 안에서의 무응답에는 보통 몇 가지 원인이 있으며, 어느 쪽도 비용이 들지 않습니다.

• 서비스가 번호를 거부했습니다. 일부 플랫폼은 가상 번호를 아예 거부합니다. 사용하지 않은 활성화를 환불하는 이유가 바로 이것입니다.
• 경로가 붐빕니다. 20분의 시간 창이 끝날 때까지 기다린 뒤 나중에 다시 시도하거나 다른 서비스 경로를 고르세요.
• 테스트가 너무 빨리 재전송했습니다. 짧은 루프의 재주문은 거의 도움이 되지 않으며 서비스 자체의 요청 제한을 건드릴 수 있습니다. 시도 사이에 간격을 두세요.

시간 창이 닫히기 전에 아무것도 도착하지 않거나 취소하면 전체 금액이 자동으로 지갑에 돌아갑니다. 실패한 OTP 전송 줄이기 가이드에서 재시도 타이밍을 더 깊이 다룹니다.

아르메니아 활성화는 어떻게 청구되고 테스트하나요?

OTP Route는 월 요금도 선택할 요금제도 없는 하나의 선불 USD 지갑으로 운영됩니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하며, 충전마다 PDF 인보이스가 이메일로 발송됩니다. 현재 요금은 요금 페이지에 있고 가격 엔드포인트에서도 반환됩니다.

실제 잔액을 쓰기 전에, 개발 계정에 샌드박스 모드를 요청하세요. 시뮬레이션된 번호와 코드를 반환하므로 CI 작업이 am 흐름 전체를 처음부터 끝까지 실행할 수 있습니다. QA 테스트 개요에서 팀들이 이를 파이프라인에 연결하는 방법을 볼 수 있습니다. 이 서비스는 본인의 제품과 정당한 계정에만 사용하고, 각 플랫폼의 약관을 지키며, OTP Route 이용 정책(Acceptable Use Policy)이 적용된다는 점을 유념하세요.

자주 묻는 질문

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

네. OTP Gateway에서 서비스용 +374 번호를 주문해 흐름에 입력하고, 국가 id am으로 대시보드 또는 API에서 코드를 확인하세요.

테스트용 +374 번호는 비용이 얼마인가요?

코드는 $0.20부터 시작하며 정확한 금액은 서비스에 따라 다릅니다. 20분의 시간 창 안에 SMS가 도착했을 때만 비용을 냅니다.

저장하는 번호에 맨 앞 0을 포함해야 하나요?

아니요. E.164로 저장하세요. +374 뒤에 국내 트렁크 0을 뺀 여덟 자리 국내 번호를 붙입니다.

나중 로그인을 위해 아르메니아 인증용 번호를 유지할 수 있나요?

셀프 서비스로는 불가능합니다. OTP Gateway 번호는 코드 한 건용이며 장기 Dedicated 회선은 미국과 캐나다 제품입니다. 다른 국가는 [email protected]으로 문의하세요.

아르메니아 코드가 아르메니아 문자로 올까요?

가끔 그렇습니다. 많은 서비스가 영어 문구를 보내지만 현지화된 템플릿은 아르메니아어나 러시아어를 쓸 수 있으므로, 숫자만 파싱하고 메시지는 UTF-8로 저장하세요.

자금을 쓰지 않고 아르메니아 연동을 테스트할 방법이 있나요?

네. 개발 계정에 샌드박스 모드를 요청하면 활성화 흐름 전체에 대해 시뮬레이션된 번호와 코드를 반환합니다.

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