Cuando crea artículos virtuales en el servidor de Xsolla, puede configurar los precios y los límites regionales, así como utilizar el sistema de promociones y otras funciones de Xsolla que se amplían y actualizan periódicamente.

Crear grupo

Para establecer artículos virtuales, es necesario configurar grupos de artículos virtuales. Los grupos le permiten tener un catálogo multinivel y gestionar los artículos que se muestran en la tienda.

1. Abra su proyecto en Cuenta del editor.
2. En el menú lateral, haga clic en Store.
3. En el panel Virtual Items, haga clic en:
   • Connect - si no ha configurado antes los elementos virtuales.
   • Configure - si ha configurado elementos virtuales anteriormente.
4. En la lista desplegable, seleccione Create group.

5. Especifique los siguientes parámetros:
   • External ID - ID del grupo en la tienda que se usa para gestionar el grupo de artículos virtuales a través de llamadas API. Tiene que ser único para cada grupo.
   • Group name.
6. Ponga el conmutador Show group in store en la posición de On para mostrar los artículos de este grupo en la tienda.
7. Haga clic en Create group.

Crear artículos virtuales

1. Haga clic en el nombre del grupo creado.
2. Haga clic en Create item.

3. Especificar información sobre un elemento. Campos obligatorios:
   • SKU - ID único del artículo
   • Item name
   • Description
   • Price in real currency
4. Ponga el conmutador Show item in store en la posición On.
5. Haga clic en Create item.

Para los siguientes pasos, necesita el código del artículo (SKU) creado:

Utilice las llamadas API de la subsección Admin del grupo Virtual Items & Currency para configurar artículos virtuales.

La autorización básica se utiliza para las llamadas a la API. Introduzca la Authorization:Basic <your_authorization_basic_key>, en la cual <your_authorization_basic_key> es el merchant ID:API key codificado según el estándar Base64. Vaya a Cuenta del editor para encontrar estos parámetros:

• Merchant ID se muestra:
  • en la sección Company settings > Company.
  • En la URL de la barra de direcciones del navegador de cualquier página de Cuenta del editor. La URL tiene el siguiente formato: https:​//publisher.xsolla.com/<merchant ID>/<Publisher Account section>.

• Clave de API se muestra en la Cuenta del editor solo una vez cuando se crea y debe almacenarse en su servidor. Puede crear una nueva clave en la siguiente sección:
  • Company settings > API keys
  • Project settings > API keys

Utilice las llamadas API de la subsección Catalog del grupo Virtual Items & Currency para obtener el catálogo de artículos virtuales en el lado del cliente. Estas llamadas no requieren autorización básica.

Utilice la llamada API Get virtual items list para obtener la lista completa de artículos no divididos en grupos. Para obtener la lista de artículos del grupo definido, transmita el parámetro external_id a la llamada Get items list by specified group.