팀에 아제르바이잔 SIM이 없어도 +994 가입 흐름 테스트하기

우리 제품이 바쿠에서 출시되는데 인증 단계가 모든 테스트를 막습니다. 어떤 방법이 있나요?

기존 앱에 아제르바이잔을 추가하는 팀에서 흔히 생기는 지점입니다. 전화 화면은 +994를 받아들이고 현지화 문구도 준비되었는데, 유일한 아제르바이잔 SIM이 다른 시간대의 계약자에게 있어서 QA가 멈춥니다. 동료의 개인 휴대전화를 빌리면 한 번은 되지만, 테스트 계정이 개인 번호에 묶이고 파이프라인 안에서는 실행할 수 없습니다.

OTP Gateway가 이 병목을 없애 줍니다. 코드 한 건용 +994 번호를 요청해 자체 가입 또는 로그인 화면에서 사용하면, 하드웨어를 가진 사람 없이도 SMS를 수집할 수 있습니다. 각 번호는 인증 한 건을 처리하므로 테스트 데이터가 깨끗하게 유지되고 개인 휴대전화가 비즈니스 계정에서 분리됩니다. 매 스프린트 이를 실행하는 팀은 보통 QA 테스트 워크플로와 함께 씁니다.

지금 아제르바이잔 경로로 코드를 전달할 수 있는 앱은 무엇인가요?

아제르바이잔의 실시간 스냅샷에는 1,600개가 넘는 서비스가 나열되어 있습니다. 인기 서비스로는 WhatsApp, Telegram, Viber, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Signal, Amazon이 있습니다.

가용성은 고정되어 있지 않습니다. 운영 파트너가 용량을 순환시키면서 경로가 하루 동안 열리고 닫히므로, 오전에 보이던 서비스가 오후에는 없을 수 있습니다. 목록을 하드코딩하지 말고 매 실행 전에 API에서 읽고, 제공되지 않는 조합은 부드럽게 건너뛰세요.

아제르바이잔 OTP API를 자동화된 스위트에 연결하려면 어떻게 하나요?

모든 호출은 개발자 콘솔의 Bearer 키와 함께 https://otproute.com/api/v1로 보냅니다. 키는 or_live_로 시작하며 계정당 최대 10개를 가질 수 있습니다. 아제르바이잔의 국가 id는 az입니다.

1. GET /api/v1/services와 GET /api/v1/countries로 카탈로그를 가져온 뒤, GET /api/v1/prices?country=az&service=<id>로 조합을 확인합니다.
2. {"service": "viber", "country": "az"} 같은 본문으로 POST /api/v1/activations를 호출해 주문을 만들고, 응답의 활성화 id를 보관합니다.
3. 반환된 +994 번호를 테스트 중인 빌드에 입력합니다.
4. 웹훅에서 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을 다시 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프는 버리세요. 웹훅 보안 가이드에서 단계별로 설명합니다. 분당 300건 요청 한도는 병렬 작업에 충분한 여유를 줍니다.

엔지니어링 외 사람도 +994 코드를 직접 받을 수 있나요?

네. 프로덕트 매니저, 번역가, 지원 리드는 화면을 확인하려고 코드 한 건이 필요한 경우가 많은데, 대시보드는 API 키 없이 이를 처리합니다.

• 로그인해서 OTP Gateway를 엽니다.
• 아제르바이잔과 테스트하려는 서비스를 고르고 실시간 가격을 확인합니다.
• 번호를 주문해서 앱에 붙여 넣습니다.
• 활성화 페이지를 열어 둡니다. SMS가 전달되는 즉시 그곳에 나타납니다.

테스트를 취소하게 되면 활성화를 취소하세요. 금액이 곧바로 지갑으로 돌아갑니다.

백엔드는 +994 번호를 어떻게 저장하고 정규화해야 하나요?

모든 번호를 E.164 형식으로 보관하세요. 예를 들어 +994 뒤에 아홉 자리 국내 번호를 붙입니다. 국내에서는 운영사 코드 앞에 트렁크 0을 누르므로 가입 양식은 두 형식을 모두 받게 됩니다. 공백, 대시, 그 국내 0을 제거하고 저장 전에 국가 코드를 앞에 붙이세요. 직접 쓴 정규식보다 관리되는 파싱 라이브러리가 더 안전합니다.

아제르바이잔어가 공용어이며 ə, ğ, ı, ş, ç 같은 문자가 있는 라틴 알파벳을 쓰고, 러시아어도 널리 통합니다. 서비스와 기기 로캘에 따라 코드는 아제르바이잔어, 러시아어, 영어로 올 수 있습니다. 그래서 +994 경로는 자체 SMS 템플릿이 특수 문자를 올바르게 렌더링하는지, 코드 파서가 영어 문구에 의존하지 않는지 확인하기에 유용합니다.

코드가 나타나지 않았습니다. 에스컬레이션 전에 무엇을 시도해야 하나요?

먼저 활성화가 20분 전체를 채우게 두세요. 일부 발신자는 메시지를 큐에 쌓아 둡니다. 아무것도 오지 않으면 주문이 만료되고 activation.expired가 발생하며 전체 금액이 자동으로 환불되므로, 코드가 도착했을 때만 비용을 냅니다.

그런 다음 일반적인 원인을 하나씩 확인하세요.

• 일부 서비스는 특정 흐름에서 가상 번호를 거부합니다. 경로를 탓하기 전에 서비스가 가상 번호를 허용하는지 확인하세요.
• 나중에 다시 시도하거나, 같은 화면을 시험하는 다른 서비스 경로로 전환하세요.
• 짧은 루프로 재주문하지 마세요. 시도 사이에 간격을 두어, 연속 실패가 큐를 소진시키지 않게 하세요.

실패한 전송 점검 목록에서 추가 진단 방법을 다룹니다.

아제르바이잔의 장기 회선이 있나요? 사용량은 어떻게 청구되나요?

아제르바이잔에는 셀프 서비스 방식의 Dedicated Number가 없습니다. Dedicated Number는 미국과 캐나다 전용 제품으로 월 $1.95부터입니다. 영구적인 +994 회선이 필요하다면 [email protected]으로 이메일을 보내세요. 팀이 현지 규정이 허용하는 범위를 확인해 드리지만 제공 여부는 약속할 수 없습니다. 반복 로그인이 필요한 계정에는 미국 또는 캐나다 회선이 대안입니다.

바쿠 테스트의 경우 비용은 하나의 선불 USD 지갑에서 차감되며 구독 요금제도 월 요금도 없습니다. 카드 또는 USDT나 USDC로 충전하고, 충전마다 PDF 인보이스가 이메일로 발송됩니다. 현재 요금은 요금 페이지에 있습니다. 요청하면 개발 계정을 샌드박스로 전환해 시뮬레이션된 번호와 코드를 반환하므로, 실제 자금을 쓰기 전에 연동을 처음부터 끝까지 테스트할 수 있습니다. 모든 주문에는 OTP Route의 이용 정책(Acceptable Use Policy)과 각 서비스 자체 약관이 적용됩니다.

자주 묻는 질문

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

네. OTP Gateway에서 +994 번호를 주문해 앱에 입력하고, 물리적 SIM 없이 대시보드나 API로 코드를 확인하세요.

OTP Route API에서 아제르바이잔의 국가 id는 무엇인가요?

POST /api/v1/activations의 country 필드와 가격 조회에 az를 사용하세요.

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

코드는 $0.20부터 시작하며, 정확한 금액은 서비스에 따라 다르고 확정하기 전에 GET /api/v1/prices가 반환합니다.

아제르바이잔 SMS가 오지 않으면 요금이 청구되나요?

아니요. 20분 안에 코드가 도착하지 않거나 먼저 취소하면 전체 금액이 자동으로 지갑에 환불됩니다.

아제르바이잔 번호를 맨 앞 0과 함께 저장해야 하나요?

아니요. 국내 트렁크 0을 빼고 +994로 시작하는 E.164 형식으로 저장하세요.

나중 로그인을 위해 같은 아제르바이잔 인증용 번호를 유지할 수 있나요?

OTP Gateway는 코드마다 번호 하나를 발급하므로 불가능합니다. 셀프 서비스 장기 회선은 미국과 캐나다에만 있으며, 아제르바이잔은 지원팀에 문의하세요.

아제르바이잔 인증 메시지는 어떤 언어로 오나요?

발신자와 기기 설정에 따라 다르며, 아제르바이잔어, 러시아어, 영어가 모두 흔합니다.

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