출시 전 마케도니아(+389) 가입 코드 테스트하기

출시 체크리스트에 "+389 가입 확인"이 있는데, QA는 어디서 시작하나요?

흔한 상황입니다. 제품이 서발칸 지역으로 확장하고 있고, 가입 흐름은 이미 십여 개 시장을 처리하고 있습니다. 이제 누군가가 북마케도니아 번호를 받아주는지, 앱이 보낸 SMS가 실제로 도착하는지 증명해야 합니다. 동료의 휴대폰을 빌리는 방식은 확장되지 않고, 현지 SIM을 CI 러너 안에서 유지하기도 번거롭습니다.

OTP Gateway는 이런 의존성을 없애 줍니다. API나 대시보드로 북마케도니아 인증 번호를 요청하고, 자사 흐름에 입력한 뒤, 도착하는 코드를 받으면 됩니다. 번호 하나는 인증 한 번에만 쓰이므로 회귀 테스트 스위트는 실행할 때마다 새 +389 테스트 번호를 요청할 수 있습니다. 팀들이 이를 릴리스 프로세스에 어떻게 넣는지는 QA 테스트 개요에서 볼 수 있습니다.

+389 번호는 어떻게 표기하며, 검증기는 무엇을 허용해야 하나요?

북마케도니아의 국가 번호는 +389이고 국내 접두 번호(trunk prefix)는 0입니다. 휴대전화 번호는 현지에서 07X XXX XXX로 쓰며, 국제 형식에서는 0이 빠져 국내 번호 8자리의 +389 7X XXX XXX가 됩니다. E.164 형식(+3897…)으로 저장하고, 현지 형식은 입력용으로만 다루세요.

스위트에 넣어둘 만한 테스트 케이스는 다음과 같습니다.

• 사용자가 +389를 선택하고도 0을 입력하는 경우: 입력을 거부하지 말고 0을 제거해야 합니다.
• 공백, 슬래시, 대시가 섞인 붙여넣기 번호: 하나의 저장 값으로 정규화되어야 합니다.
• 번호 대역 검사는 하드코딩한 접두어가 아니라 관리되는 전화번호 라이브러리에 맡기세요. 통신사 번호 대역은 시간이 지나며 바뀌기 때문입니다.

키릴 문자 SMS 템플릿에 별도 테스트가 필요한 이유는 무엇인가요?

마케도니아어는 전국에서 쓰는 공용어이며 키릴 문자로 표기합니다. 알바니아어도 공용어 지위를 가지며 널리 쓰입니다. 앱이 인증 메시지를 마케도니아어로 보내면 키릴 문자 때문에 UCS-2 인코딩이 적용되어 SMS 한 건의 길이가 160자에서 70자로 줄어듭니다. 영어로는 넉넉히 들어가던 템플릿이 여러 조각으로 나뉘거나, 발송 측이 길이를 제한하면 잘릴 수 있습니다.

+389 번호로 실제 메시지를 받아보면 사용자가 무엇을 보게 되는지 알 수 있습니다. 알림 미리보기에서 읽을 수 있을 만큼 코드가 앞쪽에 있는지, 라틴 문자 대체 문구가 적용되는지, 자동 완성 힌트가 여전히 동작하는지 확인할 수 있습니다. 서드파티 서비스는 문구와 언어를 스스로 정하므로, 파서는 고정된 문구가 아니라 숫자를 기준으로 일치시켜야 합니다.

프로그래밍 방식으로 북마케도니아 번호를 받으려면 어떤 호출을 하나요?

모든 필드는 개발자 문서에 있으며, 이 SMS 인증 API의 개요는 간단합니다. https://otproute.com/api/v1에 대해 or_live_로 시작하는 Bearer 키로 인증한 뒤 다음을 진행합니다.

1. GET /api/v1/countries로 국가 목록을 불러옵니다. 북마케도니아의 ID는 mk입니다.
2. GET /api/v1/prices?country=mk&service=<id>로 실시간 가격과 가용성을 확인합니다.
3. POST /api/v1/activations에 {"service": "viber", "country": "mk"} 같은 본문을 보내 활성화를 생성합니다.
4. GET /api/v1/activations/{id}를 폴링하거나, 웹훅으로 activation.sms_received를 기다립니다.
5. 테스트가 일찍 끝나면 POST /api/v1/activations/{id}/cancel로 취소합니다.

웹훅 호출에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 "<t>.<raw body>"에 대한 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프는 거부하고, 재전송이 문제를 일으키지 않도록 활성화 ID를 기준으로 처리하세요. 계정당 최대 키 10개, 웹훅 엔드포인트 5개, 분당 300건의 요청이 허용됩니다.

지금 +389 경로에서 열려 있는 서비스는 무엇인가요?

북마케도니아에는 현재 OTP Gateway에 900개가 넘는 서비스가 있습니다. 실시간 스냅샷에는 Viber, WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), TikTok, Microsoft & Outlook, Signal, LinkedIn, Uber, ChatGPT (OpenAI)가 포함됩니다.

모든 서비스가 모든 시간대에 열려 있는 것은 아닙니다. SMS 재고에서는 흔한 일이며, 가격과 가용성을 API로 제공하는 이유이기도 합니다. 코드를 다루지 않는 동료도 대시보드에서 같은 단계를 따라 할 수 있습니다. 계정을 만들고, 충전한 뒤, 북마케도니아와 서비스를 선택하면 코드가 도착하는 즉시 활성화 페이지에 표시됩니다.

코드가 오지 않으면 어떻게 하나요?

각 활성화는 20분 동안 유지되며, SMS가 도착한 경우에만 비용을 냅니다. 취소하거나 아무것도 오지 않은 채 시간이 끝나면 전액이 지갑으로 자동 환불됩니다.

다시 주문하기 전에 다음을 확인하세요.

• 유효 시간이 끝날 때까지 기다리세요. 메시지 분실보다 발송이 느린 경우가 훨씬 많습니다.
• 해당 서비스가 가상 번호를 받는지 확인하세요. 정책상 거부하는 서비스도 있으며, 환불은 바로 그 경우를 위한 것입니다.
• 나중에 다시 시도하거나 다른 서비스 경로를 이용하세요.
• 시도 사이에 간격을 두어, 불안정한 테스트가 +389 경로에 주문을 연달아 쏟아내지 않게 하세요.

국가별 라우팅 가이드에서 여러 시장에 걸친 대체 경로 계획을 확인할 수 있습니다. 자사 제품과 계정에만 사용하고, 각 서비스의 약관을 지키며, OTP Route의 허용 사용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요.

마케도니아 고정 회선, 결제, 샌드박스는 어떤가요?

OTP Route는 북마케도니아에서 셀프 서비스 장기 번호를 제공하지 않습니다. 전용 번호(Dedicated Numbers)는 미국과 캐나다 전용 상품으로, 월 $1.95부터 즉시 구매할 수 있습니다(From $1.95/month). 오래 쓸 +389 회선이 필요하면 [email protected]으로 이메일을 보내세요. 현지 규정상 가능한지 팀이 알려드리지만, 제공을 약속하지는 않습니다.

결제는 카드 또는 USDT/USDC로 충전하는 선불 USD 지갑을 쓰는 종량제이며, 월 사용료가 없고 충전할 때마다 PDF 청구서가 발급됩니다. 요청하면 개발 계정을 샌드박스로 전환할 수 있어, 연동이 시뮬레이션된 번호와 코드로 실행됩니다.

자주 묻는 질문

SIM 카드 없이 내 앱의 마케도니아 가입 SMS를 확인할 수 있나요?

네. 국가 mk로 OTP Gateway 번호를 요청해 자사 가입 화면에서 사용하고, 대시보드 또는 웹훅에서 메시지를 읽으세요.

+389 인증 코드는 얼마인가요?

코드당 $0.20부터이며, 정확한 금액은 서비스에 따라 다르고 대시보드에 표시되거나 GET /api/v1/prices가 반환합니다. SMS 없이 20분의 유효 시간이 끝나면 전액을 돌려받습니다.

북마케도니아 번호로 오는 인증 메시지는 키릴 문자로 되어 있나요?

발신자에 따라 다릅니다. 자사 앱은 템플릿을 직접 정하고, 서드파티 서비스는 계정이나 기기 설정에 따라 언어를 고르므로 숫자를 기준으로 파싱하세요.

데이터베이스에 마케도니아 휴대전화 번호의 앞 0을 남겨야 하나요?

E.164 형식으로 저장하세요. +389 뒤에 국내 번호 8자리를 붙이고, 접두 번호 0과 공백은 넣지 않습니다.

반복 로그인을 위해 북마케도니아 번호를 계속 보유할 수 있나요?

셀프 서비스로는 불가능합니다. 장기 전용 번호는 미국과 캐나다에만 있습니다. +389가 필요하면 지원팀에 이메일을 보내세요. 답변은 현지 규정에 따라 달라집니다.

크레딧을 쓰지 않고 북마케도니아 대상 CI를 실행할 수 있나요?

개발 계정에 샌드박스를 요청하세요. 번호와 코드를 시뮬레이션하므로 지갑 차감 없이 연동 전체를 처음부터 끝까지 실행할 수 있습니다.

서비스가 내 +389 번호를 거부하는 이유는 무엇인가요?

일부 플랫폼은 가상 번호를 거부합니다. 이 경우 활성화가 만료되거나 취소할 수 있으며, 청구 금액은 자동으로 지갑에 돌아옵니다.

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