사용자에게 구매 권한 부여
엑솔라로부터 받는 거래 상태 정보를 사용하여 여러분의 애플리케이션에서 사용자에게 구매 권한을 부여하는 기능을 구현합니다. 다음과 같은 방법으로 정보를 얻을 수 있습니다.
API를 사용하여 정보 요청
엑솔라측의 플레이어 인벤토리로부터 사용자가 구매한 가상 아이템, 인게임 재화 또는 번들에 대한 정보를 얻을 수 있습니다. 구매 승인 시 웹샵 솔루션을 통한 구매와 다른 방법으로 이루어진 구매를 모두 고려하려면 애플리케이션측과 엑솔라측의 플레이어 인벤토리에 대한 정보를 동기화하세요.
인벤토리 관리를위한 API 호출은 다음 그룹을 포함합니다.
기본 HTTP 인증
요청에 Authorization: Basic <your_authorization_basic_key>
헤더를 포함해야 합니다. 여기에서 <your_authorization_basic_key>
는 Base64 표준으로 인코딩된 판매자 ID:API 키 쌍입니다. 이러한 매개변수를 찾으려면 게시자 계정으로 이동합니다.
- 판매자 ID 표시 위치:
- 프로젝트 설정 > 웹훅 섹션
- 회사 설정 > 회사 섹션
- 게시자 계정 페이지의 브라우저 주소 표시줄에 있는 URL. 이 URL의 형식:
https://publisher.xsolla.com/판매자 ID/게시자 계정 섹션
- API 키는 생성할 때 한 번만 게시자 계정에 표시되며 따로 저장하고 관리해야 합니다. 다음 섹션에서 새 키를 생성할 수 있습니다.
- 회사 설정 > API 키
- 프로젝트 설정 > API 키
API 키 작업에 대한 자세한 정보는 API 참조를 확인하세요.
주요 권장 사항:
- 본인의 공간에 생성된 API 키를 저장합니다.. 생성된 API 키는 게시자 계정에서 한 번만 볼 수 있습니다.
- API 키를 비밀로 유지해야 합니다. 이러한 API 키는 개인 계정과 게시자 계정의 프로젝트에 대한 액세스를 제공합니다.
- API 키는 서버에 저장해야 하며 바이너리나 프론트엔드에는 저장해선 안 됩니다.
서버 OAuth 2.0 인증
요청에는 Authorization: Bearer <user_JWT>
머리글이 포함되어야 합니다. 여기서 <user_JWT>
는 사용자 JWT입니다.
다음 단계에 따라 사용자 JWT를 가져오려면:
- 서버 OAuth 2.0 클라이언트를 생성합니다.
- 게시자 계정에서 프로젝트를 엽니다. 로그인 > 자신의 로그인 프로젝트로 이동한 후 구성을 클릭합니다.
- 보안 블록에서 OAuth 2.0을 클릭합니다.
- OAuth 2.0 추가를 클릭한 후 다음을 지정합니다.
- 클라이언트 이름.
- OAuth 2.0 리디렉션 URI(필수).
- 인증 유형 — 서버.
- 프로젝트 ID.
- 연결을 클릭합니다. 추가 통합을 위해 생성된 클라이언트 ID와 비밀 키가 필요합니다.
- 서버 JWT를 가져옵니다. 이렇게 하려면 JWT 생성 API 메소드를 호출한 후 다음 매개변수를 전달합니다.
grant_type
— JWT 유형.client_credentials
값을 지정합니다.client_secret
— 서버 OAuth 2.0 클라이언트 비밀 키.client_id
— 서버 OAuth 2.0 클라이언트 ID.
- 사용자 JWT 가져오기. 이를 수행하려면 Auth by custom ID API 메소드를 호출합니다. 요청에는
X-Server-Authorization: <server_JWT>
헤더가 포함되어야 합니다. 여기서<server_JWT>
는 2 단계에서 가져온 서버 JWT입니다.
웹훅을 사용하여 정보 수신
- 웹훅 수신을 위한 매개변수 구성:
- 게시자 계정에서 프로젝트를 엽니다.
- 측면 메뉴에서 프로젝트 설정을 클릭합니다.
- 웹훅 섹션으로 이동합니다.
- 웹훅 토글을 켜기로 설정합니다.
- 웹훅 URL 필드에서 웹훅을 수신할 URL을 지정합니다.
- 프로젝트 웹훅에 서명할 비밀 키가 기본적으로 생성됩니다.새 비밀 비키를 생성하려면 새로 고침 아이콘을 클릭합니다.
- 설정 저장을 클릭합니다.
- 애플리케이션에서 다음 유형의 웹훅 처리를 구현합니다.
- 가상 아이템, 인게임 재화, 인게임 재화 패키지 및 번들에 대한 권한 부여:
웹훅 수신 확인하려면 귀하의 서버는 반드시 다음과 함께 응답해야 합니다.
- 메시지 본문 없이 HTTP 코드 204.
- 지정된 사용자를 찾을 수 없거나 잘못된 서명이 전달된 경우 문제를 설명하는 HTTP 코드 400.
게임유저 유효성 검사 및 결제 웹훅은 게시자 계정에서 테스트할 수 있는데 이는 프로젝트 설정 > 웹훅 > 스토어 섹션에 있습니다.
실제 값이 없는 경우 임의의 값을 입력할 수 있습니다.
샌드박스 또는 라이브 모드로 구매할 때 웹훅을 테스트할 수도 있습니다. 환불 테스트는 라이브 모드에서만 사용할 수 있습니다.
다음 단계
유용한 링크
이 기사가 도움이 되었나요?
이 페이지 평가
답하기 원하지 않습니다
의견을 보내 주셔서 감사드립니다!
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.