안도라에서 +376 인증 코드로 테스트하고 운영하기

안도라 번호가 가입 양식에서 걸리는 이유는 무엇인가요?

안도라는 국가 코드 +376을 쓰고 트렁크 접두사가 없으므로 제거해야 할 앞자리 0이 없습니다. 대부분의 가입자 번호는 단 여섯 자리로, 인접한 스페인과 프랑스의 아홉 자리 국내 번호보다 훨씬 짧습니다. QA 엔지니어가 가장 먼저 테스트해야 할 부분이 바로 이 길이입니다. 직접 작성한 정규식과 오래된 검증 규칙은 일곱 자리 이상을 요구하는 경우가 많아, 유효한 안도라 휴대전화 번호를 조용히 거부합니다.

실용적인 저장 규칙은 다음과 같습니다.

• 번호를 E.164로, +376 뒤에 여섯 자리를 붙이고 공백이나 문장 부호 없이 저장하세요.
• 서식은 렌더링할 때만 적용하세요(예: 세 자리씩 두 그룹).
• 전화번호 메타데이터 라이브러리를 최신 상태로 유지해 AD의 길이 규칙이 현실과 맞게 하세요.

테스트용 +376 번호를 주문하는 것이 양식, 데이터베이스 열, 발신 SMS 경로가 이렇게 짧은 번호를 끝까지 모두 받아들이는지 증명하는 가장 빠른 방법입니다.

이 공국에서는 어떤 언어와 고객 패턴이 중요한가요?

공용어는 카탈루냐어이며, 상점과 사무실에서는 스페인어, 프랑스어, 포르투갈어도 널리 들립니다. 대형 글로벌 앱은 보통 사용자 계정이나 기기의 언어로 인증 문자를 보내므로, 서비스에 따라 코드는 영어, 스페인어, 프랑스어 또는 카탈루냐어로 도착할 수 있습니다. 자사 제품이 안도라 사용자에게 OTP를 보낸다면 카탈루냐어 템플릿이 올바르게 렌더링되는지, 숫자가 눈에 잘 띄는지 확인하세요.

팀이 안도라를 다루는 이유는 몇 가지가 반복됩니다. 방문객과 거주자를 온보딩하는 소매, 관광, 스키 시즌 사업, 현지 테스트 케이스가 필요한 공국 등록 기업, 피레네 산맥의 한쪽에 살면서 다른 쪽에서 일하는 사람들을 상대하는 국경 간 제품입니다. 흔한 버그는 안도라를 숨기거나 조용히 스페인이나 프랑스로 매핑하는 국가 선택기이며, 실제 +376 인증용 번호가 있으면 이를 금방 드러낼 수 있습니다.

어떤 서비스가 +376 경로로 코드를 전달할 수 있나요?

안도라 경로는 대형 시장보다 카탈로그가 작지만 실시간 목록에 50개가 넘는 서비스가 있습니다. 현재 스냅샷의 인기 항목으로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Viber, Netflix, Airbnb가 있습니다.

가용성은 하루 동안 바뀌므로 이 목록은 약속이 아니라 스냅샷으로 보세요. 테스트를 실행하기 전에 실시간 카탈로그를 확인하고, 필요한 서비스가 ad에 없다면 국가 페이지에서 인접 경로를 비교하거나 OTP 국가 라우팅 글을 읽어 보세요.

안도라 OTP API 호출 순서는 어떻게 되나요?

개발자 콘솔에서 Bearer 키(접두사 or_live_)를 만든 뒤 https://otproute.com/api/v1을 대상으로 작업하세요. 일반적인 실행은 다음과 같습니다.

1. GET /api/v1/prices?country=ad&service=telegram을 호출해 경로가 열려 있는지 확인하고 실시간 가격을 봅니다.
2. {"service": "telegram", "country": "ad"}와 함께 POST /api/v1/activations를 보내고, 반환된 활성화 id와 번호를 저장합니다.
3. 테스트 중인 앱이나 흐름에서 인증 SMS를 트리거합니다.
4. activation.sms_received 웹훅을 기다리거나, 적당한 간격으로 GET /api/v1/activations/{id}를 폴링합니다.
5. 테스트를 포기하면 POST /api/v1/activations/{id}/cancel을 호출해 자금이 즉시 돌아오게 합니다.

모든 웹훅에는 X-OTPRoute-Signature 헤더가 붙습니다. 엔드포인트 시크릿으로 타임스탬프, 점, 원본 본문에 대한 HMAC-SHA256을 다시 계산해 비교하고, 오래된 타임스탬프는 거부하세요. 계정은 키 최대 10개, 웹훅 엔드포인트 5개, 분당 300건 요청을 사용할 수 있습니다. 이 SMS 인증 API의 나머지는 API 문서에 있습니다.

운영 담당 동료가 코드 없이도 같은 일을 할 수 있나요?

네. 팀의 누구나 안도라 OTP API 대신 대시보드를 쓸 수 있습니다.

1. 로그인하고 OTP Gateway를 엽니다.
2. 안도라와 필요한 서비스를 선택합니다.
3. 표시된 가격을 확인하고 번호를 주문합니다.
4. +376 번호를 서비스에 붙여 넣고 코드를 요청합니다.
5. 활성화 화면을 열어 둡니다. +376 코드는 도착하는 즉시 표시됩니다.

이 경로는 회사 계정을 확인하는 지원 담당자나, 현지화된 가입 과정을 한 번 살펴보는 프로덕트 매니저에게 적합합니다.

+376 코드가 도착하지 않으면 어떻게 해야 하나요?

각 활성화는 20분 동안 열려 있습니다. 코드가 도착해야만 비용을 냅니다. SMS 없이 시간 창이 닫히거나 직접 취소하면 전체 금액이 자동으로 지갑에 돌아갑니다.

아무것도 오지 않을 때는 곧바로 다시 주문하지 말고 시간 창이 끝날 때까지 기다리며, 서비스가 가상 번호를 허용하는지 확인하세요. 거부하는 서비스도 있습니다. 그런 다음 나중에 다시 시도하거나 다른 서비스 경로를 써 보세요. 스크립트에서 짧은 루프로 재주문하지 말고, 백오프와 상한을 두세요. 실패한 OTP 전송 줄이기 가이드에 점검 항목이 더 있습니다.

안도라의 장기 회선이 있나요? 요금은 어떻게 청구되나요?

안도라에는 셀프 서비스 방식의 장기 번호가 없습니다. Dedicated Number는 가상 번호를 통해 미국과 캐나다에서만 즉시 판매되며 월 $1.95부터입니다. 팀에 오래 쓸 +376 회선이 필요하면 [email protected]으로 이메일을 보내 문의하세요. 가능 여부는 현지 규정에 달려 있으며 보장되지 않습니다.

요금 청구는 월 요금도 선택할 요금제도 없는 하나의 선불 USD 지갑으로 이루어집니다. 카드 또는 USDT/USDC로 충전하며, 충전마다 PDF 인보이스가 이메일로 도착합니다. 요금을 참고하세요. 연동 작업에는 요청 시 개발 계정을 샌드박스로 전환해, 시뮬레이션된 번호와 코드로 OTP 라우팅 로직을 테스트할 수 있습니다. 실제 경로는 본인의 정당한 계정에만 사용하고, 각 서비스의 약관을 지키며, OTP Route의 이용 정책(Acceptable Use Policy)이 적용된다는 점을 유념하세요.

자주 묻는 질문

현지 SIM 없이 우리 앱의 안도라 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 안도라 번호를 주문해 가입 양식에 입력하고, 대시보드나 API로 코드를 확인하세요.

OTP Route API에서 안도라의 국가 id는 무엇인가요?

가격 및 활성화 요청의 country 값으로 ad를 사용하세요.

안도라 SMS OTP 코드를 받으려면 비용이 얼마나 드나요?

코드당 $0.20부터 시작하며 서비스에 따라 다릅니다. 정확한 금액은 GET /api/v1/prices가 반환하며 주문 전에 대시보드에도 표시됩니다.

안도라 번호에는 앞자리 0이 필요한가요?

아니요. 안도라에는 트렁크 접두사가 없으므로 번호는 +376 뒤에 가입자 번호(보통 여섯 자리)를 붙이기만 하면 됩니다.

반복 로그인을 위해 같은 +376 번호를 유지할 수 있나요?

셀프 서비스 제품으로는 불가능합니다. Gateway 번호는 코드 한 건용입니다. 미국과 캐나다 밖에서 오래 쓸 회선이 필요하면 [email protected]으로 문의하세요.

지갑 자금을 쓰지 않고 안도라 연동을 프로토타이핑할 수 있나요?

네. 지원팀에 개발 계정을 샌드박스로 전환해 달라고 요청하면 시뮬레이션된 번호와 코드를 반환합니다.

Telegram이 코드를 보내지 않으면 요금이 청구되나요?

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

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