Steam 콘솔 설정

개요

Steam으로 앱을 출시하려면 Steamworks 파트너 사이트에서 여러 값을 확인해 Hive 콘솔에 등록해야 합니다. 이 문서는 각 값을 확인하는 위치와 방법, 확인한 값을 등록할 Hive 콘솔 화면을 안내합니다. 콘솔 화면에서 값을 입력하고 저장하는 방법은 관련 콘솔 가이드에서 설명합니다.

스토어 App ID 등록

Steam App ID는 Steam이 앱을 식별하는 값입니다. Hive Axyl은 이 값을 기준으로 Steam과 연동해 로그인, 결제 등을 처리하므로, 로그인 연동과 결제 연동을 설정하기 전에 먼저 등록하세요.

Steamworks 파트너 사이트에서 대상 앱의 Steam App ID를 확인하세요.

확인한 Steam App ID는 Hive 콘솔 프로젝트 설정 > App ID에서 Steam 스토어로 만든 App ID의 Store App ID에 등록합니다. 등록 방법은 Store App ID 등록을 참조하세요.

Steam 로그인은 Hive Axyl 서버가 Steamworks에 사용자 인증 결과를 확인하는 방식으로 동작합니다. 확인에 사용하는 Publisher Web API Key를 Steamworks에서 확인해 Hive 콘솔에 등록해야 앱에서 Steam 로그인이 동작합니다.

Steam 로그인은 스토어 App ID로 등록한 Steam App ID도 함께 사용합니다. Steam App ID가 비어 있으면 인증 정보를 저장해도 로그인이 동작하지 않습니다.

1. Publisher Web API Key 확인

Publisher Web API Key는 Steamworks의 그룹 단위로 발급합니다. 키를 생성하려면 Steamworks 계정에 관리자 권한이 있어야 합니다. 관리자 권한이 없으면 Steamworks 파트너 사이트에서 관리자 목록을 확인하세요. 관리자에게 키 생성 또는 권한 승격을 요청하세요.

Steamworks 파트너 사이트에 접속하세요.
사용자 및 권한 > 그룹 관리로 이동하세요.
사용할 그룹을 선택하세요. 그룹이 없으면 새로운 그룹 만들기를 선택해 그룹을 생성하세요. Publisher Web API Key 전용 그룹을 별도로 만드는 것을 권장합니다.
그룹에 연결된 애플리케이션이 올바른지 확인하세요.
웹 API로 이동하세요.
기존 키가 없으면 Create WebAPI Key를 선택하세요.
사용할 키 권한을 선택하세요.
Save Changes를 선택하세요.
생성한 Publisher Web API Key 값을 복사하세요.

Steam 로그인과 Steam 결제는 같은 경로에서 확인하는 Publisher Web API Key를 사용합니다.

2. Hive 콘솔 설정으로 이동

확인한 인증 정보를 등록하고 Steam 로그인을 활성화하는 방법은 Steam 로그인 인증 정보를 참조하세요.

결제 연동

Steam 결제는 사용자가 결제를 마친 뒤 Hive Axyl 서버가 Publisher Web API Key로 영수증을 검증하는 방식으로 동작합니다. 검증에 사용할 인증 정보와 판매할 상품 정보를 Steamworks에서 확인해 Hive 콘솔에 등록해야 Steam 결제가 동작합니다.

Steam 결제는 소모성 상품의 단건 결제만 지원합니다. 구독 상품과 한 번에 여러 건을 결제하는 복수 결제는 지원하지 않습니다.

1. Publisher Web API Key 준비

Steam 결제는 Steam 로그인과 같은 Publisher Web API Key를 사용합니다. 키를 아직 발급하지 않았다면 로그인 연동의 Publisher Web API Key 확인을 먼저 마치세요. Steam 로그인을 사용하지 않아도 이 절차는 그대로 따릅니다.

2. 판매할 상품 등록과 상품 ID 확인

Hive Axyl은 Hive 콘솔에 등록한 상품 ID로 Steam 상품 정보를 조회합니다. 따라서 Steamworks에 등록한 상품 ID와 Hive 콘솔에 등록할 상품 ID가 같아야 합니다.

Steamworks 파트너 사이트에서 판매할 상품을 등록하고 상품 ID를 확인하세요.

3. Hive 콘솔에 등록

Steamworks에서 확인한 값은 아래 위치에 등록합니다. Hive Axyl 서버는 스토어 설정에 등록한 인증 정보로 영수증을 검증하고, 상품 등록에 등록한 상품 ID로 Steam의 상품 정보를 조회합니다.

Steamworks에서 확인한 값	Hive 콘솔 등록 위치	등록 방법
Publisher Web API Key	결제 > 스토어 설정의 Steam 카드 Web API Key	Steam 인증 정보
상품 ID	결제 > 상품 등록	상품 등록

Steam 상품에는 두 가지 선행 조건이 있습니다.

Steam 상품의 가격은 가격 등급으로 관리하므로, 상품을 등록하기 전에 결제 > 가격 등급에 사용 상태인 가격 등급을 먼저 만들어야 합니다. 만드는 방법은 가격 등급을 참조하세요.
Steam 상품은 상품명을 언어별로 입력하므로, 언어 탭이 보이지 않으면 앱 지원 언어에서 지원 언어를 먼저 설정하세요.

상품을 등록할 때 결제 플랫폼은 Steam을, 상품 유형은 소모성 상품을 선택하세요.

App ID마다 다른 키를 사용한다면 App ID별 인증 정보 설정에서 개별로 등록하세요.