+373 액티베이션은 요청부터 코드까지 어떻게 진행되나요?
액티베이션은 ID, 전화번호, 상태를 가진 수명이 짧은 객체입니다. 클라이언트는 개발자 콘솔에서 생성한 or_live_로 시작하는 Bearer 키로 https://otproute.com/api/v1에 인증합니다(계정당 키 최대 10개, 분당 300건 요청).
몰도바의 수명 주기는 다음과 같습니다. 작업이 GET /api/v1/prices?country=md&service=<id>를 읽어 라우트가 열려 있는지 확인하고 오늘의 가격을 봅니다. 이어서 {"service": "<id>", "country": "md"}와 함께 POST /api/v1/activations를 보내면 액티베이션 ID와 +373 번호를 받습니다. 테스트는 그 번호를 대상 앱에 입력하고 SMS를 트리거합니다. 그 시점부터 액티베이션은 20분 동안 유지되며, 코드를 받거나 POST /api/v1/activations/{id}/cancel을 호출하거나 시간이 다 되면 끝납니다.
서비스 ID와 전체 국가 카탈로그는 GET /api/v1/services와 GET /api/v1/countries에서 가져옵니다. 실시간 목록이 기준이므로 코드에 고정하지 말고 시작할 때 가져오세요. OTP API 연동 가이드에서 완전한 클라이언트 예제를 볼 수 있습니다.
몰도바 OTP API 클라이언트는 폴링해야 하나요, 웹훅을 받아야 하나요?
같은 SMS 인증 API로 둘 다 가능하며, 많은 팀이 속도를 위해 웹훅을 쓰고 안전망으로 폴링을 함께 씁니다.
웹훅. 개발자 콘솔에서 엔드포인트를 추가하고(계정당 다섯 개까지 등록 가능) activation.sms_received, activation.expired, activation.cancelled를 처리하세요. t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature 헤더는 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산해 검증하고 오래된 타임스탬프는 거부합니다. 중복 전달이 무해하도록 처리 로직은 액티베이션 ID를 키로 하세요.
폴링. 백오프를 두고 몇 초마다 GET /api/v1/activations/{id}를 호출하다가 상태가 확정되면 중단합니다. 인바운드 요청을 받을 수 없는 방화벽 뒤 CI 러너에 적합합니다. 두 방식의 타임아웃과 재시도는 CI 파이프라인의 SMS OTP 테스트 글에서 다룹니다.
몰도바 전화번호는 어떤 점이 다르게 처리되어야 하나요?
몰도바 국내 번호는 +373 국가 코드 뒤에 여덟 자리이며, 국내 통화에서는 앞에 트렁크 접두어 0이 붙습니다. 그래서 사용자는 같은 휴대폰 번호를 앞의 0을 붙이거나, +373을 붙이거나, 00373을 붙이는 등 여러 형태로 입력합니다. 공백과 대시를 제거하고, 국가 코드를 붙일 때 국내용 0을 제거한 뒤 E.164 형식으로 저장해 정규화하세요. 앞의 0을 강제하는 검증기는 올바른 국제 형식 입력을 거부하게 되며, 테스트용 +373 번호가 가장 먼저 드러내는 문제 중 하나입니다.
루마니아어가 공용어이고 러시아어도 널리 쓰이므로, 현지 서비스의 인증 문자는 두 언어 중 하나로, 글로벌 앱은 영어로 올 수 있습니다. 키릴 문자 메시지는 더 넓은 인코딩으로 전송되고 라틴 문자와 다르게 분할되므로, 코드를 추출하는 모든 파서에서 점검할 가치가 있습니다.
팀이 몰도바에서 테스트하는 경우는 앱을 루마니아어나 러시아어로 현지화할 때, 지역 전반의 고객을 지원할 때, 또는 키시너우의 지원·엔지니어링 직원이 자신의 인증 단계를 점검해야 할 때입니다.
현재 몰도바로 코드를 라우팅하는 앱은 무엇인가요?
OTP Route는 몰도바에서 1,700개 넘는 서비스를 제공합니다. 현재 스냅샷의 인기 서비스로는 Telegram, Viber, WhatsApp, Signal, Facebook, Instagram, TikTok, Google (Gmail & YouTube), LinkedIn, Snapchat, Amazon, eBay, Netflix, Claude가 있습니다.
이것은 계속 움직이는 그림으로 보세요. 재고는 하루 중 바뀌므로 매 실행 전에 실시간 목록을 요청하고, 불안정한 서비스를 위해 폴백 라우트를 준비해 두세요. 테스트 로직을 바꾸지 않고 폴백 국가로 OTP 라우팅이 이루어지는 방식은 국가별 라우팅 글에서 설명합니다.
몰도바 코드가 나타나지 않을 수 있는 이유는?
서비스가 가상 번호를 아예 거부하거나, 반복 시도를 제한하거나, 특정 라우트에서 느리게 전달할 수 있습니다. 이 중 어느 것도 비용이 들지 않습니다. 20분 윈도우 안에 도착하지 않은 코드는 지갑으로 자동 전액 환불되기 때문입니다.
이런 경우의 실용적인 단계는 다음과 같습니다.
- 첫 침묵에 취소하지 말고 윈도우가 끝날 때까지 기다립니다.
- 서비스가 애초에 가상 번호를 허용하는지 확인합니다.
- 나중에 다시 시도하거나, 서비스가 지원하는 다른 국가로 전환합니다.
- 반복 주문은 간격을 두세요. 새 액티베이션을 빠른 루프로 쏘는 것은 역효과입니다.
- 성공한 실행과 실패한 실행을 비교할 수 있도록 액티베이션 ID를 앱 로그와 함께 기록합니다.
코드를 쓰지 않는 사람은 몰도바 번호를 어떻게 주문하나요?
이메일과 6자리 이메일 코드 또는 Google 로그인으로 가입해 계정을 만드세요. OTP Gateway에서 서비스를 선택하고 몰도바를 고른 뒤 실시간 가격을 확인하고 확정합니다. +373 번호를 인증하려는 앱에 붙여 넣으면 수신되는 즉시 대시보드에 코드가 나타납니다. 같은 화면에서 취소할 수 있으며 금액은 곧바로 지갑으로 돌아갑니다.
장기 회선, 샌드박스 접근, 결제는 어떻게 되나요?
OTP Route는 셀프서비스 장기 몰도바 번호를 판매하지 않습니다. Dedicated Numbers는 미국과 캐나다에서만 제공되며 월 $1.95부터 시작합니다($1.95/month). 지속적인 +373 회선이 필요하면 [email protected]으로 문의하세요. 마련할 수 있는지는 현지 규정에 달려 있습니다.
결제는 하나의 USD 지갑에서 사용한 만큼 내는 방식이며 구독이나 요금 등급이 없습니다. 카드 또는 USDT/USDC로 충전하면 충전할 때마다 PDF 인보이스가 이메일로 도착합니다. 먼저 연동을 시험해 보고 싶은 개발자는 계정을 샌드박스로 옮겨 달라고 요청할 수 있으며, 샌드박스에서는 번호와 코드가 시뮬레이션되고 지갑은 건드리지 않습니다.
자주 묻는 질문
몰도바에 살지 않아도 몰도바 SMS OTP를 받을 수 있나요?
네. OTP Gateway는 어디서든 사용할 수 있는 +373 번호를 발급하며, 코드는 대시보드에 표시되거나 API 클라이언트로 전송됩니다.
몰도바에는 코드에서 어떤 국가 ID를 보내야 하나요?
country 값으로 md를 보내세요. 서비스 ID는 GET /api/v1/services에서 가져옵니다.
몰도바 번호를 앞의 0과 함께 저장해야 하나요?
아니요. 국내 트렁크 접두어를 빼고 +373에 여덟 자리 국내 숫자를 붙인 E.164 형식으로 저장하세요.
몰도바 액티베이션을 취소하면 어떻게 되나요?
코드가 도착하기 전에 POST /api/v1/activations/{id}/cancel을 호출하면 액티베이션이 종료되고 전액이 지갑으로 돌아갑니다.
몇 달 동안 유지할 수 있는 몰도바 인증 번호가 있나요?
셀프서비스로는 없습니다. 장기 Dedicated Numbers는 미국과 캐나다 제품이며, 몰도바는 지원팀에 이메일로 문의하세요.
OTP Route로 한 앱에 계정을 여러 개 만들 수 있나요?
아니요. 자사의 합법적인 제품과 계정을 테스트하고 운영하기 위한 서비스이며, 각 서비스의 약관과 OTP Route 이용 정책(Acceptable Use Policy)을 따라야 합니다.
비용을 쓰지 않고 몰도바를 대상으로 테스트 스위트를 실행할 수 있나요?
네, 개발 계정에 샌드박스 모드를 요청하면 됩니다. 엔드투엔드 테스트용으로 시뮬레이션된 번호와 코드가 반환됩니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.