아이템 판매 설정

직접 링크, 위젯 또는 스토어 UI를 통해 아이템을 판매할 수 있습니다.

결제 UI를 여는 데 사용되는 링크:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}

이 링크에 추가할 데이터:

  • YOUR-ITEM-TYPE — 아이템 유형:
    • game — 게임; game_key — 명확한 DRM 게임 판매용.
    • physical_item — 실물 상품.
    • virtual_item — 가상 아이템.
    • virtual_currency — 인게임 재화.
    • bundle — 인게임 재화 패키지 또는 번들.
  • YOUR-PROJECT-ID게시자 계정의 프로젝트 ID(프로젝트 > 프로젝트 설정 > 일반 설정 > 프로젝트 ID).
  • YOUR-ITEM-SKU — 아이템 SKU. 명확한 DRM 게임을 판매하려면 DRM의 SKU를 스토어에 추가된 가상 아이템 전체 목록에 표시된 Get games list로 가져와야 합니다. 이 SKU는 일반적으로 unit_name_drm_sku로 표시됩니다.

  • 결제 UI 스타일: 테마(dark 매개변수인 어두움 또는 default 매개변수인 밝음), 크기 및 기타 매개변수. URL의 ui_settings 매개변수를 지정하고 Base64 인코딩을 값으로 가지는settings.ui JSON-개체를 전달합니다. UI 설정이 된 URL 예시:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

  • 사용자 데이터 전달을 위한 토큰. 인증된 사용자에게 아이템을 판매할 때만 사용되며 가상 아이템 및 가상 화폐에 필요합니다. 이 토큰은 인증 메소드에 따라 달라집니다. 토큰 URL 예시:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}

  • 결제 테스트에 대한 mode=sandbox 매개변수입니다. 테스트 은행 카드를 결제 완료에 사용할 수 있습니다. 테스트용 URL 예시:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&mode=sandbox

위젯으로 판매

위젯은 아이템을 판매할 수 있도록 웹 사이트에 구현하는 스크립트입니다. 위젯 작동 예시는 데모 페이지에서 확인할 수 있습니다.

위젯 구현 코드:

Copy
Full screen
Small screen
<script>
    var options = {
        project_id: "YOUR-PROJECT-ID",
        item_type: "YOUR-ITEM-TYPE",
        sku: "YOUR-ITEM-SKU",
        user: "ACCESS_TOKEN",
        widget_ui: {
            target_element: '#widget-example-element'
        }
    };
    var s = document.createElement('script');
        s.type = "text/javascript";
        s.async = true;
        s.src = "https://cdn.xsolla.net/embed/buy-button/3.1.2/widget.min.js";
        s.addEventListener('load', function (e) {
          var widgetInstance = XBuyButtonWidget.create(options);
          }, false);
    var head = document.getElementsByTagName('head')[0];
    head.appendChild(s);
</script>

위의 코드에 추가할 데이터:

  • YOUR-PROJECT-ID게시자 계정의 프로젝트 ID(프로젝트 > 프로젝트 설정 > 일반 설정 > 프로젝트 ID).
  • YOUR-ITEM-TYPE — 아이템 유형:
    • game — 게임;game_key — 명확한 DRM 게임 판매용.
    • physical_item — 실물 상품.
    • virtual_item — 가상 아이템.
    • virtual_currency — 인게임 재화.
    • bundle — 인게임 재화 패키지 또는 번들.
  • YOUR-ITEM-SKU — 아이템 SKU. 명확한 DRM 게임을 판매하려면 스토어에 추가된 가상 아이템 전체 목록에 표시된 Get games list로 DRM의 SKU를 가져와야 합니다. 일반적으로 이 SKU는 unit_name_drm_sku로 표시됩니다.
  • ACCESS_TOKEN — 사용자 데이터 전달용 토큰. 인증된 사용자에게 아이템을 판매할 때만 사용되며 가상 아이템 및 인게임 재화용으로 필요합니다. 이 토큰은 인증 방법에 따라 달라집니다.

위젯 구성에 대한 추가 정보는 GitHub를 참조하세요.

스토어 UI를 통해 판매

스토어 UI를 통해 게임 키, 가상 아이템 및 인게임 재화를 판매하기 위해 별도의 웹 애플리케이션을 구현하거나 스토어 UI를 게임 내부에 구현할 수 있습니다. 아이템 목록을 가져오고 이를 가져와서 작동하도록 하려면 Commerce API를 사용하거나 데모 버전을 기반으로 스토어를 직접 제작해야 합니다.

Commerce API 기준

Commerce API 메소드를 통합하여 스토어의 프론트엔드 파트를 만드는 방법:
  1. 가상 아이템, 인게임 재화 패키지, 게임의 목록 가져오기.
  2. 아이템 구매:

메소드가 올바르게 작동할 수 있도록 적합한 인증 옵션을 선택하세요.

Note
Commerce API 메소드를 통해 게임을 판매하려면, 프론트엔드 측에서 DRM 선택을 구현해야 합니다. items.unit_items.sku 매개변수 값을 SKU로서 게임 요청 얻기에서 전달하세요.

데모 버전 기준

스토어 데모 버전을 사용하여 API 기능을 확인할 수 있습니다. 해당 코드는 GitHub에 업로드되어 있습니다. 이러한 코드는 자체 버전을 만드는 기초로 사용할 수도 있습니다.

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

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!

계속 읽기

다음 단계

웹훅 설정
마지막 업데이트: 2021년 7월 23일

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

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