Ao criar itens virtuais do lado da Xsolla, você pode configurar preços e limites regionais, bem como usar o sistema de promoção e outros recursos da Xsolla que são regularmente expandidos e atualizados.

Criar grupo

Para configurar itens virtuais, você precisa configurar grupos de itens virtuais. Os grupos permitem que você tenha um catálogo multinível e gerencie os itens que são exibidos na loja.

1. Abra seu projeto na Conta de Distribuidor.
2. No menu lateral, clique em Store.
3. No painel Virtual Items, clique em:
   • Connect — se você não tiver configurado itens virtuais antes.
   • Configure — se você já configurou itens virtuais antes.
4. Na lista suspensa, escolha Create group.

5. Especifique os seguintes parâmetros:
   • External ID — ID do grupo na loja que é usado para gerenciar o grupo de itens virtuais por meio de chamadas de API. Ele deve ser exclusivo para cada grupo.
   • Group name.
6. Defina a configuração Show group in store como On para exibir itens desse grupo na loja.
7. Clique em Create group.

Criar itens virtuais

1. Clique no nome do grupo criado.
2. Clique em Create item.

3. Especifique informações sobre um item. Campos obrigatórios:
   • SKU — ID específico do item
   • Item name
   • Description
   • Price in real currency
4. Defina a configuração Show item in store como On.
5. Clique em Create item.

Para as próximas etapas, você precisa do SKU do item criado:

Use chamadas de API da subseção Admin do grupo Virtual Items & Currency para configurar itens virtuais.

A autorização básica é usada para chamadas de API. Passe o Authorization:Basic <your_authorization_basic_key>, onde <your_authorization_basic_key> é o par merchant ID:API key codificado de acordo com o padrão Base64. Vá para a Conta de Distribuidor para encontrar estes parâmetros:

• O Merchant ID é exibido:
  • Na seção Company settings > Company.
  • No URL na barra de endereços do navegador em qualquer página da Conta de Distribuidor. O URL tem o seguinte formato: https:​//publisher.xsolla.com/<merchant ID>/<Publisher Account section>.

• A API key é mostrada na Conta de Distribuidor apenas uma vez, durante a criação, e deve ser armazenada por você. Você pode criar uma nova chave na seguinte seção:
  • Company settings > API keys
  • Project settings > API keys

Use chamadas de API da subseção Catalog do grupo Virtual Items & Currency para obter o catálogo de itens virtuais no lado do cliente. Essas chamadas não exigem autorização básica.

Use a chamada de API Get virtual items list para obter a lista completa de itens não divididos em grupos. Para obter a lista de itens do grupo definido, passe o parâmetro external_id para a chamada Get items list by specified group.