사용자에게 구매 권한 부여

엑솔라로부터 받는 거래 상태 정보를 사용하여 여러분의 애플리케이션에서 사용자에게 구매 권한을 부여하는 기능을 구현합니다. 다음과 같은 방법으로 정보를 얻을 수 있습니다.

API를 사용하여 정보 요청

엑솔라측의 플레이어 인벤토리로부터 사용자가 구매한 가상 아이템, 인게임 재화 또는 번들에 대한 정보를 얻을 수 있습니다. 구매 승인 시 웹샵 솔루션을 통한 구매와 다른 방법으로 이루어진 구매를 모두 고려하려면 애플리케이션측과 엑솔라측의 플레이어 인벤토리에 대한 정보를 동기화하세요.

인벤토리 관리를위한 API 호출은 다음 그룹을 포함합니다.

알림
서버측 메소드는 기본 HTTP 인증을 사용합니다.
알림
클라이언트측 호출은 서버 OAuth 2.0 인증을 사용합니다.

기본 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를 가져오려면:

  1. 서버 OAuth 2.0 클라이언트를 생성합니다.
    1. 관리자 페이지에서 프로젝트를 엽니다. 로그인 > 자신의 로그인 프로젝트로 이동한 후 구성을 클릭합니다.
    2. 보안 블록에서 OAuth 2.0을 클릭합니다.
    3. OAuth 2.0 추가를 클릭한 후 다음을 지정합니다.
      • 클라이언트 이름.
      • OAuth 2.0 리디렉션 URI(필수).
      • 인증 유형 — 서버.
      • 프로젝트 ID.
    4. 연결을 클릭합니다. 추가 통합을 위해 생성된 클라이언트 ID와 비밀 키가 필요합니다.

  1. 서버 JWT를 가져옵니다. 이렇게 하려면 JWT 생성 API 메소드를 호출한 후 다음 매개변수를 전달합니다.
    • grant_type — JWT 유형. client_credentials 값을 지정합니다.
    • client_secret — 서버 OAuth 2.0 클라이언트 비밀 키.
    • client_id — 서버 OAuth 2.0 클라이언트 ID.
알림
서버 JWT는 59분 동안 유효합니다.
  1. 사용자 JWT 가져오기. 이를 수행하려면 Auth by custom ID API 메소드를 호출합니다. 요청에는 X-Server-Authorization: <server_JWT> 헤더가 포함되어야 합니다. 여기서 <server_JWT>2 단계에서 가져온 서버 JWT입니다.

웹훅을 사용하여 정보 수신

  1. 웹훅 수신을 위한 매개변수 구성:
    1. 관리자 페이지에서 프로젝트를 엽니다.
    2. 측면 메뉴에서 프로젝트 설정을 클릭합니다.
    3. 웹훅 섹션으로 이동합니다.
    4. 웹훅 토글을 켜기로 설정합니다.
    5. 웹훅 URL 필드에서 웹훅을 수신할 URL을 지정합니다.
    6. 프로젝트 웹훅에 서명할 비밀 키가 기본적으로 생성됩니다.새 비밀 비키를 생성하려면 새로 고침 아이콘을 클릭합니다.
    7. 설정 저장을 클릭합니다.

  1. 애플리케이션에서 다음 유형의 웹훅 처리를 구현합니다.

웹훅 수신 확인하려면 귀하의 서버는 반드시 다음과 함께 응답해야 합니다.

  • 메시지 본문 없이 HTTP 코드 204.
  • 지정된 사용자를 찾을 수 없거나 잘못된 서명이 전달된 경우 문제를 설명하는 HTTP 코드 400.

게임유저 유효성 검사결제 웹훅은 관리자 페이지에서 테스트할 수 있는데 이는 프로젝트 설정 > 웹훅 > 결제 섹션에 있습니다.

실제 값이 없는 경우 임의의 값을 입력할 수 있습니다.

샌드박스 또는 라이브 모드로 구매할 때 웹훅을 테스트할 수도 있습니다. 환불 테스트는 라이브 모드에서만 사용할 수 있습니다.

다음 단계

  1. 정기 결제 정보 가져오기를 구현합니다.
  2. 사용자 인증을 설정합니다.

통합 절차

이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!
마지막 업데이트: 2024년 1월 22일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!