아이템 판매 설정
인게임 스토어를 통해 다음 아이템을 실제 통화나 인게임 재화로 판매하는 인게임 판매를 진행해 게임에서 수익을 창출할 수 있습니다.
- 인게임 재화 및 가상 패키지
- 소모성 아이템
- 비소모성 아이템
- 사용기간 제한 아이템
| 상품 | 판매 방식 |
|---|---|
| 하나의 아이템(예: 가상 아이템 또는 수용자 정의 수량의 인게임 재화 | 빠른 구매 호출 |
| 장바구니 속 여러 아이템 | 고유한 사용자 ID를 전달합니다. 고유한 사용자 ID는 가상 아이템 및 인게임 재화 메소드 그룹에서 카탈로그 하위 섹션의 API 메소드를 호출할 때 제목에서 숫자 또는 행으로 사용됩니다(x-unauthorized-id 매개 변수). 식별자는 프론트엔드에서 생성됩니다(예: 식별자 생성 라이브러리를 통해). |
애플리케이션 및 엑솔라 제품의 기능에 대한 사용자 액세스를 관리하려면 인증 시스템을 설정하세요. 이때 엑솔라 로그인을 사용하거나 자체 인증 시스템을 구현할 수 있습니다.
자체 인증 시스템을 구현했으며 결제 UI만 필요한 경우 페이 스테이션 액세스 토큰을 생성한 후 서버에 웹훅을 설정하세요.
자체 서버가 없거나 기존 솔루션을 사용하려는 경우 인게임 스토어에 대해 엑솔라 로그인을 사용할 수 있습니다. 엑솔라에서 수행하는 기능:
- 카탈로그 저장 및 관리
- 가격 관리
- 지역별 가격 데이터 저장
- 사용자 인증
- 거래 처리
엑솔라 로그인을 통한 인증
엑솔라 로그인은 사용자 등록 및 인증을 위해 OAuth 2.0 표준 프로토콜을 지원합니다. 표준 OAuth 2.0 프로토콜을 통해 클라이언트 애플리케이션의 개발을 단순화할 수 있습니다. OAuth 2.0을 사용하면 사용자가 참여하지 않아도 액세스 토큰을 업데이트할 수 있습니다.
승인된 사용자 데이터를 다음에 저장할 수 있습니다.
- 엑솔라 스토리지의 경우. 설정하려면 엑솔라 로그인 시작하기를 참조하세요.
- PlayFab 데이터베이스의 경우. 설정하려면 PlayFab 저장소 사용법을 참조하세요.
- 사용자 지정 저장소의 경우. 설정하려면 사용자 지정 저장소 사용법을 참조하세요.
페이 스테이션 액세스 토큰을 통한 인증
일반 절차
귀하의 클라이언트와 엑솔라 서버 간의 상호 작용 흐름:- 클라이언트가 인증 요청을 귀하의 서버에 전송합니다.
- 서버가 권한 부여 토큰을 요청하고 헤더를 엑솔라 서버에 전송하는데, 이는
project_id/merchant_id및api_key매개 변수를 포함하고 있습니다. - 엑솔라 서버가 Pay Station 액세스 토큰을 반환합니다.
- 서버가 Pay Station 액세스 토큰을 클라이언트에게 전달합니다.
- 반환된 Pay Station 액세스 토큰이 IGS API 인증 및 스토어 인터페이스 빌드용 권한 부여 토큰으로 사용됩니다.
페이 스테이션 액세스 토큰 받기
애플리케이션의 백 엔드에서 HTTP POST 요청을 사용하여 페이 스테이션 액세스 토큰 가져오기 메서드를 구현하세요.
엑솔라 API는 기본 HTTP 인증을 사용합니다. 요청에는 Authorization: Basic <your_authorization_basic_key> 헤더가 있어야 합니다. 여기에서 <your_authorization_basic_key>는 Base64 표준으로 인코딩된 판매자 ID:API 키 쌍입니다. 이러한 매개변수를 찾으려면 관리자 페이지으로 이동합니다.
- 판매자 ID 표시 위치:
- 회사 설정 > 회사 섹션.
- 관리자 페이지의 브라우저 주소 표시줄에 있는 URL. 해당 URL은
https://publisher.xsolla.com/<merchant ID>/<Publisher Account section>형식으로 되어 있습니다.
- API 키는 생성할 때 한 번만 관리자 페이지에 표시되며 따로 저장하고 관리해야 합니다. 다음 섹션에서 새 키를 생성할 수 있습니다.
- 회사 설정 > API 키
- 프로젝트 설정 > API 키
API 키 작업에 대한 자세한 정보는 API 참조를 확인하세요.
주요 권장 사항:
- 본인의 공간에 생성된 API 키를 저장합니다. 생성된 API 키는 관리자 페이지에서 한 번만 볼 수 있습니다.
- API 키를 비밀로 유지해야 합니다. 이러한 API 키는 개인 계정과 관리자 페이지의 프로젝트에 대한 액세스를 제공합니다.
- API 키는 서버에 저장해야 하며 바이너리나 프론트엔드에는 저장해선 안 됩니다.
필요로 하는 API 호출에 project_id 경로 매개 변수가 포함되어 있지 않으면 회사의 모든 프로젝트에서 유효한 API 키를 사용하여 인증을 설정해 주세요.
HTTP 요청:
POST https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token
토큰을 받으려면 전달해야 하는 요청 본문의 매개 변수:
| 매개 변수 | 유형 | 설명 |
|---|---|---|
settings | object | 사용자 지정 프로젝트 설정와 관련된 객체입니다. |
settings.project_id | integer | 게임의 엑솔라 ID. 프로젝트 이름 옆 관리자 페이지에서 찾으실 수 있습니다. 필수. |
user | object | 사용자에 대한 데이터가 포함된 개체입니다. |
user.id | object | 권한 부여 시스템의 사용자 ID(개체). |
user.id.value | string | 사용자 ID. 필수. |
user.email | object | 사용자 이메일(개체). |
user.email.value | string | 사용자 이메일. RFC 822 프로토콜에 따라 유효해야 합니다. 필수. |
user.name | object | 게임유저 닉네임 데이터와 관련된 값입니다.필수. |
user.name.value | string | 사용자 닉네임. |
user.steam_id | object | 사용자 Steam ID(개체). |
user.steam_id.value | string | 사용자 Steam ID. 애플리케이션이 Steam에 게시된 경우 필수입니다. |
user.playfab_id | object | 사용자 PlayFab ID(개체). |
user.playfab_id.value | string | 사용자 PlayFab ID. 애플리케이션이 PlayFab 서비스를 사용하여 아이템 부여를 하는 경우 필수입니다. |
custom_parameters, purchase, 등)는 전달하지 마세요. 다른 매개 변수는 권한 부여 토큰 수신용이 아닙니다.페이 스테이션 액세스 토큰을 인게임 스토어 및 인벤토리와 같이 사용하는 경우 엑솔라 API로의 마지막 호출 후 1시간이 지나면 만료됩니다. 페이 스테이션 액세스 토큰의 수명을 변경하려면, 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.
만료 후 새 페이 스테이션 액세스 토큰을 수신하는 로직을 구현합니다. 새 토큰을 백그라운드 모드에서 수신하여 사용자가 애플리케이션에 다시 로그인하지 않아도 되게 할 것을 권장합니다.
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
