무료 아이템

작동 방식

무료 아이템은 사용자가 인게임 재화 또는 실물 화폐를 사용하지 않아도 얻을 수 있는 아이템 유형입니다. 여기에는 다음이 포함됩니다.

• 가상 아이템
• 번들
• 인게임 재화 패키지

무료 아이템은 인증한 사용자만 사용할 수 있습니다. 인증 하지 않은 사용자는 무료 아이템의 카탈로그만 볼 수 있습니다.

사용 예시:

• 프로젝트에 있어 중요한 날짜(예: 프로젝트가 시작된 날)에 사용자의 충성도에 대한 보상을 제공하기 위해 무료 아이템을 제공할 수 있습니다.
• 스토어에서 게임용 무료 스타터 팩을 제공함으로써 새로운 사용자를 게임으로 끌어들일 수 있습니다.

사용자가 유니크 아이템을 이미 가지고 있는 경우 유니크 아이템의 무료 제공을 제한할 수 있습니다.

사용자

• 이미 인게임 스토어가 있고 새로운 제품 유형으로 무료 아이템을 설정하려는 파트너를 대상으로 합니다.
• 현재 사용자의 충성도를 높이거나 새로운 플레이어를 유치하려는 파트너에게 적합합니다.

통합 절차

1. 무료 아이템 생성 방법:
   • 관리자 페이지을 통해
   • API 호출을 통해
2. 스토어 설정
3. 사용자의 주문 상태 가져오기

관리자 페이지을 통해 생성

1. 관리자 페이지에서 프로젝트를 엽니다.
2. 사이드 메뉴에서 스토어를 클릭합니다.
3. 가상 아이템 창에서 구성을 클릭합니다.
4. +를 클릭한 후 드롭다운 목록에서 아이템 생성을 선택합니다.
5. 지정하기:
   • 이미지
   • SKU
   • 아이템이 속해야 하는 하나 이상의 그룹
   • 이름
   • 설명
   • 아이템 속성: 소모성, 비소모성 또는 기간 한정 아이템
6. 가격 설정 블록에서 무료 아이템을 선택합니다.
7. 특정 사용자에게 아이템 가용성을 제한하려면 한 사용자가 이 아이템을 구매할 수 있는 횟수 제한 토글을 ON(켜기)로 설정한 후 횟수를 지정합니다.
8. 스토어에 아이템이 표시되도록 하려면 스토어에 아이템 표시 토글을 ON(켜기)로 설정합니다.
9. 아이템 생성을 클릭합니다.

API 호출을 통해 생성

1. 무료 아이템을 생성하려면 관리자 하위 섹션에서 API 호출을 사용합니다.
   • 가상 아이템의 경우 - 가상 아이템 생성
   • 재화 패키지의 경우 - 인게임 재화 패키지 생성
   • 번들의 경우 - 번들 생성
   아이템을 생성하거나 편집할 때 요청 본문에서 is_free = true를 전달합니다.
2. 아이템의 가용성을 특정 사용자로 제한하려면 아이템 생성 또는 편집용 API 메소드를 호출하고 limits.per_user 매개변수의 값을 지정합니다.

스토어 설정

빠른 구매

{
  "method": "POST",
  "url": "https://mybestgame.com/xsolla/notification",
  "body": {
    "items": [
      {
        "sku": "gift_direct_game_reward-supercoin",
        "type": "virtual_currency",
        "is_pre_order": false,
        "quantity": 500,
        "amount": "0",
        "promotions": [

        ]
      },
      {
        "sku": "package-500_supercoin",
        "type": "bundle",
        "is_pre_order": false,
        "quantity": 1,
        "amount": "0",
        "promotions": [

        ]
      },
      {
        "sku": "xsolla-giveaway_offer_11_14_22",
        "type": "bundle",
        "is_pre_order": false,
        "quantity": 1,
        "amount": "0",
        "promotions": [

        ]
      }
    ],
    "notification_type": "order_paid",
    "order": {
      "id": 12345678,
      "mode": "default",
      "currency_type": "unknown",
      "currency": null,
      "amount": "0",
      "status": "paid",
      "platform": "xsolla",
      "comment": null,
      "invoice_id": null,
      "promotions": [

      ]
    },
    "user": {
      "external_id": "1234567812345678",
      "email": null
    }
  },
  "headers": {
    "Authorization": "Signature 3b840ccefea111dcdfd111db1fdc6df969a3ec11",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "type": "webhook_payment",
  "callback_parameters": {
    "order_id": 12345678
  }
}

• 수신기가 웹훅을 올바르게 수락하고 처리한 경우의 HTTP 응답 코드는 200 또는 204 입니다.
• 예상한 오류가 발생하는 경우의 HTTP 응답 코드는 4xx 입니다.
알림
이 경우 아이템이 플레이어의 인벤토리에 추가되고 엑솔라 측에서는 주문이 성공한 것으로 표시됩니다.
• 수신기가 서버의 일시적인 오류에 대해 5xx HTTP 응답 코드를 반환할 수도 있습니다. 이 경우 엑솔라 알림 서비스는 재시도 메커니즘을 사용합니다.

장바구니 구매

사용자가 장바구니 구매를 사용하는 경우:

• 사용자의 장바구니에 유료 및 무료 아이템이 모두 포함된 경우 주문 생성을 위해 특정 장바구니의 모든 아이템으로 주문 생성과 현재 장바구니의 모든 아이템으로 주문 생성을 진행하는 표준 API를 호출합니다. 사용자는 페이 스테이션의 결제 양식으로 주문 대금을 지불합니다.
• 사용자의 장바구니에 무료 아이템만 있는 경우 무료 장바구니로 주문 생성하기와 특정 무료 장바구니로 주문 생성하기 API를 호출하여 무료 장바구니를 가져옵니다. 이 경우 결제 인터페이스는 사용하지 않습니다.

웹훅 예제는 빠른 구매 예제와 유사합니다.