테스트 번호로 Battle.net SMS 코드 받기, 단계별 안내

상황: 스튜디오나 e스포츠 팀이 직접 관리하는 Battle.net 전화번호가 필요할 때

Blizzard 게임을 둘러싼 보조 도구, 오버레이, 대회 소프트웨어를 만드는 회사의 QA 리드를 떠올려 보세요. 팀은 테스트와 방송을 위해 공식 회사 계정을 운영하며, 어떤 엔지니어의 개인 휴대폰 번호도 거기에 붙여 두고 싶지 않습니다. 또 다른 흔한 사례는 운영 직원이 공용 팀 계정을 관리하는 e스포츠 조직으로, 인증이 팀 전체가 볼 수 있는 곳에 도착해야 합니다.

Battle.net은 휴대폰 번호를 여러 용도로 사용합니다. 계정 뒤의 사람을 확인하고, 민감한 정보가 바뀔 때 코드를 보내고, 계정 복구를 지원하며, Blizzard Authenticator 앱과 함께 보안 계층 역할을 합니다. 일부 Blizzard 타이틀은 플레이 전에 계정에 휴대폰 번호를 요구하기도 했습니다. 따라서 테스트용 Battle.net SMS 인증은 팀이 여러 번 재현해야 할 수 있는 플로우와 맞닿아 있습니다.

Battle.net용 가상 번호를 주문하기 전 체크리스트

• 알맞은 제품을 고르세요. 일회성 확인에는 OTP Gateway가 맞습니다. 휴대폰을 계속 연결해 두고 앞으로의 보안 요청을 통과해야 하는 계정은 전용 번호(Dedicated Number)를 쓰세요(아래 참고).
• 국가를 맞추세요. Battle.net 계정의 국가는 생성할 때 정해지며 보통 사용자가 나중에 바꿀 수 없으므로, 계정과 같은 시장의 번호를 주문하세요.
• 자격 증명을 준비하세요. 개발자 콘솔에서 발급한 Bearer 키(접두사 or_live_), 가능하면 시크릿이 있는 웹훅 엔드포인트.
• 지갑을 충전하세요. 선불 USD 지갑에 카드 또는 USDT/USDC로 충전합니다. 월 요금제는 없습니다.
• 샌드박스에서 사전 테스트하세요. 지원팀이 개발 계정을 샌드박스로 전환하면 비용 없이 시뮬레이션된 번호와 코드를 받을 수 있습니다.

QA 테스트 페이지에서 팀이 이런 재사용 가능한 테스트 데이터를 어떻게 정리하는지 설명합니다.

어느 국가에서 Battle.net OTP를 받을 수 있나요?

battle_net 경로는 현재 197개 국가에 걸쳐 있습니다. 미국, 캐나다, 영국, 독일, 프랑스, 스페인, 폴란드, 스웨덴, 대한민국, 대만, 일본, 싱가포르, 필리핀, 호주, 브라질, 멕시코, 튀르키예, 남아프리카공화국 등이 포함됩니다. Blizzard는 지역별 게임 허브를 통해 플레이어에게 서비스하므로, 가장 저렴한 경로가 아니라 테스트 케이스가 다루는 지역과 스토어프런트를 반영하는 국가를 고르세요. 국가별 실시간 가용성은 GET /api/v1/prices에서 확인할 수 있습니다.

Battle.net 인증 코드 API 플로우는 어떻게 동작하나요?

기본 URL은 https://otproute.com/api/v1이며 Bearer 인증을 사용하고 분당 300건 요청이 가능합니다.

1. 가격과 가용성을 확인합니다. GET /api/v1/prices?country=<id>&service=battle_net, 국가 id는 GET /api/v1/countries에서 가져옵니다.
2. {"service": "battle_net", "country": "us"} 같은 본문으로 POST /api/v1/activations를 호출해 activation을 생성합니다.
3. 반환된 번호를 Battle.net에 입력하고 코드를 요청합니다.
4. 웹훅에서 activation.sms_received를 처리합니다. 엔드포인트 시크릿으로 <t>.<raw body>에 대한 HMAC-SHA256을 계산해 X-OTPRoute-Signature를 검증하고 오래된 타임스탬프는 거부합니다.
5. 핸들러를 멱등하게 만드세요. activation id를 키로 처리하면 재시도된 전송이 같은 코드를 두 번 제출하지 않습니다.
6. 공개 엔드포인트가 없나요? 대신 GET /api/v1/activations/{id}를 폴링하고, activation.expired 또는 activation.cancelled 이벤트를 해당 테스트 실행의 종료로 처리하세요.

큐 처리와 재시도는 웹훅 수신 가이드에서 자세히 다룹니다.

비개발자는 대시보드에서 무엇을 하나요?

OTP Gateway를 열고 Battle.net과 계정의 국가를 선택한 뒤 표시된 가격을 보고 확정합니다. Battle.net 전화번호 입력란에 번호를 입력하고 SMS를 요청한 다음 activation 페이지를 열어 두세요. 코드가 전달되면 그곳에 나타납니다. 같은 20분 창과 자동 환불이 적용됩니다.

Battle.net 코드가 도착하지 않는 이유는 무엇일까요?

Blizzard는 일부 보안 기능에서 가상 번호나 선불형 번호를 거부할 수 있으며, 이 정책은 예고 없이 바뀔 수 있습니다. 코드가 끝내 오지 않으면 창이 끝나거나 취소할 때 전체 금액이 지갑으로 돌아옵니다. 그다음에는 이렇게 하세요.

• 전달 시점은 서비스와 경로에 따라 다르므로 전체 창이 끝날 때까지 기다립니다.
• 나중에 다시 시도하거나, 계정에 여전히 맞는 다른 국가로 시도합니다.
• 요청 한도를 낭비하는 빠른 취소 후 재주문 루프를 피합니다.
• 번호가 완전히 거부되면 우회할 문제가 아니라 정책상의 답으로 받아들입니다.

전달 실패 체크리스트에 기록해 둘 만한 신호가 더 정리되어 있습니다.

Battle.net 전화번호로 전용 번호가 더 나은 경우는 언제인가요?

코드 하나짜리 번호는 창이 끝나면 사라지므로, 보안 코드를 다시 받아야 하는 계정에는 적합하지 않습니다. 오래 쓰는 회사 계정이라면 월 $1.95부터인 미국 또는 캐나다의 전용 번호가 지갑에서 갱신되는 동안 같은 회선을 유지하며, 수신 SMS를 대시보드와 웹훅으로 number.sms_received로 전달합니다.

어떤 쪽을 택하든 Blizzard의 약관을 따르세요. 실제 개인 또는 사업자당 계정 하나이며, 추가 계정이나 정지를 우회하려는 시도는 안 됩니다. OTP Route는 본인의 정당한 계정과 제품을 테스트하고 운영하기 위한 서비스이며 이용 정책(Acceptable Use Policy)이 적용됩니다. Battle.net은 해당 소유자의 상표이며 OTP Route는 이와 제휴 관계가 없습니다.

자주 묻는 질문

개인 휴대폰을 쓰지 않고 Battle.net OTP를 받을 수 있나요?

네. battle_net용 OTP Gateway 번호를 주문해 Battle.net에 입력하고 대시보드나 웹훅에서 코드를 읽으세요. 코드당 $0.20부터이며 전달된 경우에만 청구됩니다.

Battle.net은 모든 가상 번호를 허용하나요?

아니요. Blizzard는 일부 기능에서 가상 번호나 선불 번호를 거부할 수 있으며, 그래서 전달되지 않은 activation은 자동으로 환불됩니다.

Battle.net 테스트 계정에는 어느 국가를 선택해야 하나요?

계정과 같은 국가를 사용하세요. Battle.net 계정의 국가는 생성 시 정해지므로 번호가 맞지 않으면 혼란스러운 결과가 나올 수 있습니다.

API에서 Battle.net의 서비스 id는 무엇인가요?

서비스 id는 battle_net입니다. POST /api/v1/activations에서 국가 id와 함께 사용합니다.

Battle.net 웹훅 핸들러가 한 코드를 두 번 처리하지 않게 하려면 어떻게 하나요?

activation.sms_received를 처음 처리할 때 activation id를 저장하고, 서명을 검증한 뒤 같은 id가 담긴 이후 전송은 무시하세요.

나중에 코드가 필요한 회사 계정에 임시 activation을 써도 되나요?

아니요. 반복되는 보안 요청에는 월 $1.95부터인 미국 또는 캐나다 전용 번호가 갱신되는 동안 같은 회선을 유지합니다.

Battle.net 경로는 몇 개 국가를 지원하나요?

최신 스냅샷 기준 197개 국가입니다. 가용성은 하루 중 달라지므로 주문 전에 API에서 실시간 가격을 확인하세요.

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