UI에서 메타프레임 인게임 재화의 판매를 구현하는 방법

자체 스토어 UI를 구현하거나 다른 인증 서비스를 사용하면 메타프레임 위젯을 사용하지 않아도 인게임 재화를 판매할 수 있습니다. 이렇게 하려면 메타프레임 API를 사용하여 구매, 인게임 재화 자동 충전, 사용자 잔액 표시 로직을 구현해야 합니다.

선행 조건

시작하기 전에 필요한 프로젝트 설정:

1. 프로젝트를 생성합니다.
2. 관리자 페이지에서 인게임 재화 패키지를 생성합니다.
3. 필요한 ID와 비밀 키를 구해야합니다 . 이렇게 하려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com 또는 integration@xsolla.com으로 이메일을 보내 문의합니다. 관리자 페이지에서 다음 정보를 제공합니다.

• 다음에서 찾을 수 있는 판매자 ID:
  • 회사 이름 옆에 있습니다.
  • 회사 설정 > 회사 섹션에 있습니다.
  • 게시자 계정 페이지의 브라우저 주소 표시줄에 있는 URL에 있습니다. URL의 형식은 https:​//publisher.xsolla.com/판매자 ID/관리자 페이지 섹션입니다.

• 프로젝트 ID는 프로젝트 이름 옆에서 찾을 수 있습니다.

• 프로젝트 웹훅에 서명하는 비밀 키는 프로젝트 설정 > 웹훅 섹션에서 찾을 수 있습니다.

• API 키는 생성할 때 한 번만 관리자 페이지에 표시되며 따로 저장하고 관리해야 합니다. 다음 섹션에서 새 키를 생성할 수 있습니다.
  • 회사 설정 > API 키
  • 프로젝트 설정 > API 키

엑솔라 팀은 추가 구성에 필요한 다음 정보를 제공합니다.

• 호스트 ID
• 엑솔라 계정 OAuth 2.0 클라이언트 ID
• 엑솔라 계정 OAuth 2.0 클라이언트 비밀 키

서버 토큰 가져오기

서버 토큰은 사용자 액세스 토큰을 구하고 자동 충전할 때 필요합니다.

애플리케이션의 백엔드에서 JWT 생성 API 호출을 사용하여 서버 JWT(JSON 웹 토큰)를 가져오는 메소드를 구현합니다. 요청에 포함해야 하는 매개변수:

• grant_type는 JWT 유형이며 client_credentials 값으로 전달합니다.
• client_secret는 엑솔라에게 받은 비밀 키입니다.
• client_id는 엑솔라에게 받은 클라이언트 ID입니다.

사용자 액세스 토큰 가져오기

사용자 인증 토큰은 결제 토큰을 생성하고 사용자의 인게임 재화 잔액을 요청할 때 필요합니다.

자체 인증 시스템을 사용하는 경우 다음을 사용하여 적합한 인증 토큰을 가져올 수 있습니다.

• 소셜 네트워크의 액세스 토큰
• 사용자 정의 ID - 서버에서 생성한 사용자 ID

소셜에 로그인하는 동안 토큰 가져오기

1. 관리자 페이지에서 소셜 네트워크를 통해 사용자 인증 설정하기

1. 1. 관리자 페이지에서 프로젝트를 엽니다.
   2. 사이드 메뉴에서 로그인을 클릭합니다.
   3. 로그인 프로젝트 생성을 클릭합니다.
   4. 표준 로그인 프로젝트를 선택하고 생성 및 설정을 클릭합니다. 새 로그인 프로젝트가 생성되면 로그인 프로젝트 설정과 페이지가 표시됩니다.
   5. 로그인 방법 블록에서 소셜 로그인을 선택하고 구성을 클릭합니다.
   6. 애플리케이션에서 소셜 로그인에 사용할 소셜 네트워크를 연결합니다.
   7. 사이트 이동 경로에서 로그인 프로젝트의 이름을 클릭하여 로그인 프로젝트 페이지로 돌아갑니다.
   8. 보안 블록으로 이동하여 JWT 서명 섹션을 선택합니다.
   9. 서명 생성 알고리즘으로 RS256을 선택하고 변경 사항 저장을 클릭합니다.

2. 애플리케이션의 클라이언트 측에서 소셜 네트워크의 액세스 토큰을 통한 인증 API 호출을 사용하여 토큰 수신 및 새로 고침을 구현합니다.

사용자 정의 ID로 토큰 가져오기

애플리케이션의 백엔드에서 사용자 정의 ID로 인증 API 호출을 사용하여 토큰을 가져오고 새로 고침하는 메소드를 구현합니다. 요청에 X-Server-Authorization: <server_JWT> 헤더를 포함해야 하며, 여기서 <server_JWT>는 이전 단계에서 입수한 서버 JWT입니다.

API 호출로 인게임 재화 관리