벨라루스에서 +375 인증 코드를 받기 위한 사전 점검 체크리스트

+375 번호를 요청하기 전에 무엇이 준비되어 있어야 하나요?

테스트에 +375 번호를 쓰기 전에 아래를 하나씩 확인하세요.

• 계정과 충전된 지갑. /signup에서 이메일과 6자리 이메일 코드 또는 Google 로그인으로 계정을 만든 다음 소액을 충전하세요. API 키를 보유한 계정에는 TOTP 2단계 인증을 켜세요.
• or_live_ 접두사가 붙은 Bearer 키. 개발자 콘솔에서 만듭니다. CI와 로컬 개발에 별도의 키를 쓰세요. 계정당 최대 10개까지 둘 수 있습니다.
• 보낼 두 개의 ID. 벨라루스는 API에서 by이고, 서비스 ID는 GET /api/v1/services가 반환하는 api_service 값입니다.
• 웹훅을 쓸 계획이라면 수신 엔드포인트와, 저장소 밖에 보관한 서명 시크릿.
• 전화번호를 변경하거나 추가할 수 있는 내 제품의 테스트 계정.
• BY 지역으로 설정한 전화번호 라이브러리. 가입 양식에 붙여 넣는 번호가 실제 벨라루스 사용자가 입력하는 방식 그대로 파싱되도록 하기 위해서입니다.

벨라루스 번호는 어떻게 표기하며, 앱은 어떻게 저장해야 하나요?

벨라루스는 국가 코드 +375 뒤에 9자리 국내 번호를 사용합니다. 휴대폰 회선은 25, 29, 33, 44 같은 사업자 코드로 시작하므로 저장된 값은 +37529XXXXXXX처럼 보입니다.

까다로운 부분은 국내 관습입니다. 국내에서는 휴대폰 번호를 장거리 전화 접두사에서 유래한 앞자리 80을 붙여 8 029 XXX-XX-XX처럼 쓰는 경우가 많습니다. 국가 코드를 붙이기 전에 이 80을 제거해야 합니다. 이를 남겨 두는 양식은 유효하지 않은 E.164 문자열을 만들고, 일부 인증 서비스는 이를 조용히 거부합니다. 벨라루스 인증 번호를 위한 좋은 정규화 테스트는 다음과 같습니다.

• +375 29 ..., 375 29 ..., 8 029 ...를 모두 받아들여 세 가지를 동일하게 저장
• 번호는 현지 사용자에게 익숙한 묶음으로 표시하되, SMS나 인증 계층에는 E.164만 전송
• 375 뒤에 80이 남아 있는 번호는 거부

벨라루스어와 러시아어가 모두 공식 언어이며, 일상에서는 러시아어를 가장 많이 씁니다. 많은 서비스가 계정 로캘에 따라 코드 문구를 러시아어나 영어로 보내므로, 메시지를 그대로 보여 주는 모든 화면에서 앱이 키릴 문자를 올바르게 렌더링하는지 확인하세요.

벨라루스 인증 번호로 어떤 서비스의 코드를 받을 수 있나요?

OTP Route의 벨라루스 OTP 라우팅은 현재 ID by로 1,400개가 넘는 서비스를 지원합니다. 현재 스냅샷에서 인기 있는 경로는 Telegram, Viber, WhatsApp, Signal, Google (Gmail & YouTube), Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Amazon, AliExpress 등입니다.

개별 경로의 이용 가능 여부는 하루 중에도 바뀌므로 이런 목록은 약속이 아니라 출발점으로 보세요. 실행 전에 GET /api/v1/prices?country=by&service=<id>로 현재 가격과 지금 해당 경로가 주문을 받을 수 있는지 확인하세요. 국가를 고를 때는 OTP 국가 라우팅을 참고하세요.

단계별 안내: 테스트 스크립트에서의 벨라루스 OTP API 흐름

모든 요청은 Bearer 키와 함께 https://otproute.com/api/v1로 보냅니다. SMS 인증 API는 작아서 헬퍼 하나로 감쌀 수 있습니다.

1. GET /api/v1/balance를 호출하고, 스위트에 비해 지갑 잔액이 부족하면 작업을 일찍 중단합니다.
2. GET /api/v1/prices?country=by&service=telegram을 호출하고(서비스 ID는 직접 쓰는 값으로 바꾸세요) 지불하려는 가격을 기록합니다.
3. {"service": "telegram", "country": "by"} 같은 본문으로 POST /api/v1/activations를 호출해 주문을 생성합니다. 응답의 활성화 ID와 +375 번호를 저장하세요.
4. 그 번호를 내 앱의 전화번호 단계에 제출하고 코드를 발생시킵니다.
5. activation.sms_received 이벤트에서 코드를 수집하거나 GET /api/v1/activations/{id}를 폴링합니다. 한도는 분당 300건 요청입니다.
6. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel을 호출해 보류된 금액이 즉시 지갑으로 돌아가게 합니다.

웹훅에서는 X-OTPRoute-Signature 헤더(t=<unix>,v1=<hex>)를 읽고, 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산하여 상수 시간으로 비교하고, 타임스탬프가 오래된 전송은 버리세요. 반복 전송되어도 해가 없도록 핸들러를 활성화 ID 기준으로 처리하세요. 자세한 내용은 API 문서와 HMAC으로 OTP 웹훅 보호하기 가이드를 참고하세요.

단계별 안내: 대시보드에서 같은 작업 하기

가끔 코드가 필요한 지원 담당자는 API를 건너뛸 수 있습니다.

1. 대시보드에서 OTP Gateway를 열고 벨라루스를 선택합니다.
2. 서비스를 고릅니다. 확정하기 전에 해당 경로의 가격이 표시됩니다.
3. +375 번호를 복사해 테스트 중인 앱에 입력합니다.
4. 주문 카드를 지켜보세요. 코드가 도착하는 즉시 그곳에 나타납니다.

20분 안에 아무것도 도착하지 않으면 주문이 종료되고 전체 금액이 환불됩니다. 코드가 전달되었을 때만 요금을 냅니다.

문제 해결: +375 코드가 도착하지 않았어요

일반적인 원인과 각각의 다음 조치입니다.

• 서비스가 번호를 거부했습니다. 일부 플랫폼은 가상 번호를 거절합니다. 환불 규칙은 바로 이런 경우를 위한 것입니다. 테스트가 허용한다면 다른 서비스 경로나 다른 국가를 시도하세요.
• 번호가 국내 형식으로 입력되었습니다. 양식이 80 없이 +375와 9자리를 제출했는지 다시 확인하세요.
• 경로가 바쁩니다. 1분 뒤에 취소하지 말고 시간 창이 끝날 때까지 기다린 다음, 나중에 다시 시도하세요.
• 스크립트가 짧은 간격으로 반복 주문하고 있습니다. 시도 사이에 백오프를 추가하세요. 한 서비스에 빠르게 반복 주문하는 것은 도움이 되는 경우가 드물고 대상 플랫폼에는 악용처럼 보일 수 있습니다.

+375 주문의 추가 실패 패턴은 OTP 전달 실패 줄이기에서 다룹니다.

벨라루스 장기 회선이 있나요? 결제는 어떻게 이루어지나요?

아니요. OTP Route에는 벨라루스용 셀프서비스 장기 번호가 없습니다. 팀에 운영이나 지원 용도로 필요하다면 [email protected]으로 이메일을 보내 설명해 주세요. 제공 가능 여부는 현지 규정에 따라 달라지며 아무것도 약속하지 않습니다. 전용 가상 번호(Dedicated Virtual Numbers)는 미국과 캐나다 전용 상품으로 월 $1.95부터 시작하며, 수신 SMS, 발신 SMS, 브라우저 통화를 지원합니다.

벨라루스 주문도 다른 모든 경로와 같은 선불 USD 지갑에서 차감되며, 월 요금도 선택할 등급도 없습니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하면 충전할 때마다 PDF 인보이스가 받은편지함에 도착합니다. 개발자는 시뮬레이션된 번호와 코드를 반환하는 샌드박스 계정을 요청할 수 있으며, 실제 주문 전에 연동을 검증하는 가장 저렴한 방법입니다. 모든 번호는 본인의 제품이나 정당한 계정에만 사용하고, 각 서비스의 약관을 따르며, OTP Route 이용 정책(Acceptable Use Policy)이 적용된다는 점을 유의하세요. 현재 금액은 가격에서 확인하세요.

자주 묻는 질문

현지 SIM 없이 내 앱의 벨라루스 가입 흐름을 테스트할 수 있나요?

예. OTP Gateway에서 서비스용 +375 번호를 주문해 가입 양식에 제출하고, 대시보드나 API로 코드를 읽으세요.

OTP Route API에서 벨라루스의 국가 ID는 무엇인가요?

by입니다. GET /api/v1/prices와 POST /api/v1/activations의 본문에 사용하세요.

벨라루스 번호를 80 접두사와 함께 저장해야 하나요?

아니요. E.164로 +375 뒤에 9자리를 붙여 저장하고 국내용 80은 제거하세요. 그렇지 않으면 많은 서비스가 그 번호를 유효하지 않다고 판단합니다.

+375 번호로 코드가 끝내 오지 않으면 내 돈은 어떻게 되나요?

SMS 없이 20분 시간 창이 끝나거나 취소하면 전체 요금이 지갑으로 자동 환불됩니다.

인증 SMS는 어떤 언어로 오나요?

발신 서비스가 정합니다. 벨라루스 번호의 경우 계정이나 기기 언어에 따라 러시아어 또는 영어인 경우가 흔합니다.

앞으로의 로그인을 위해 +375 번호를 유지할 수 있나요?

셀프서비스로는 불가능합니다. 장기 전용 번호는 미국과 캐나다에만 있으며, 벨라루스는 [email protected]으로 문의하실 수 있지만 제공 가능 여부는 약속드리지 않습니다.

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

예. 요청하면 개발 계정을 샌드박스로 전환해 드리며, 시뮬레이션된 번호와 코드를 반환해 전 과정을 테스트할 수 있습니다.

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