SDK de nivel empresarial para Unity / Artículos gratuitos
  Volver a Documentos

SDK de nivel empresarial para Unity

Artículos gratuitos

Free items are a type of item that users can get without spending virtual or real currency. These include:

  • Virtual items
  • Bundles
  • Virtual currency packages

Free items are only available to authorized users. Unauthorized users can only view the catalog of free items.

Examples of usage:

  • You can give away free items on important dates for your project (for example, on the day the project was founded) to reward users for their loyalty.
  • You can give away free starter packs for the game in the store to attract new users to the game.

You can limit the free giveaway of unique items if the user already has them.

To set up free items:

  1. Add free items to the catalog.
  2. Implement logic of ordering free items by users.
  3. Implement the logic of granting free items to the user.

Añadir artículos gratuitos al catálogo

Detailed instructions for creating items are available in the following documentation sections:

When creating or editing a free item, you need to select a Free item, Free package or Free bundle in the Paid or Free section.

Pedidos de artículos gratuitos por parte del usuario

A user can order a free item in two ways:

  • In one click (without using the shopping cart) — one SKU in any quantity. For example, 100 identical potions.
  • Via the shopping cart — any type of items in any quantity.

Pedir un artículo gratuito con un solo clic

To implement this option, call the CreateOrderWithSpecifiedFreeItem SDK method when a user clicks the button in the catalog to order the free item.

The delivery of items to the user’s inventory on Xsolla’s side occurs immediately after a successful request to this method (without the need to open the Pay Station).

Pedir artículos gratuitos a través de la cesta de la compra

If a user uses the shopping cart:

  • If the user’s cart contains both paid and free items:
    1. Get the payment token and order ID using the PurchaseCart SDK method.
    2. Implement opening the payment UI. To do this, call the OpenPurchaseUi SDK method and pass the payment token and order ID to it.

  • If the user’s cart contains only free items, call the CreateOrderWithFreeCart or CreateOrderWithParticularFreeCart SDK method. The delivery of items to the user’s inventory on Xsolla’s side occurs immediately after a successful request to this method (without the need to open the Pay Station payment form).

Concesión de artículos gratuitos al usuario

You can track the status of a free item order by calling the CheckOrder SDK method on a timer.

If the order was successful, use SDK methods for displaying user inventory to update the data on the client side of the application.

Nota
If you’ve configured your application’s server to handle Xsolla webhooks, you can update the data on your application’s client side when the order_paid webhook is received.
¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Valore esta página
Valore esta página
¿Hay algo en lo que podamos mejorar?

Prefiero no responder

¡Gracias por tu mensaje!

Enlaces útiles

Última actualización: 10 de Octubre de 2023

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!