Moedas virtuais são tipos de dinheiro virtual que são usados para comprar e vender itens dentro do jogo. Dependendo de sua finalidade, uma moeda virtual afeta o equilíbrio da economia do jogo ou está conectada à monetização do aplicativo. Você também pode criar moedas fortes, uma moeda virtual que está vinculada à plataforma de compra e que só pode ser comprada com dinheiro real.

Você pode vender a moeda virtual em quantias predefinidas. Para um pacote, você pode definir um preço especial que tenha um valor diferente da quantia de moedas virtuais nele.

Veja a seção Moedas Virtuais para saber mais sobre as moedas virtuais.

Para configurar moedas virtuais pela Conta de Distribuidor:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items.
2. Selecione Add e então Virtual currency na lista suspensa.

3. Especifique os seguintes parâmetros:
   1. Imagem (optional).
   2. SKU.
   3. Nome da moeda virtual.
4. Para configurar como a moeda virtual é exibida na loja, selecione o status apropriado.

5. Para definir um preço, selecione Set up prices e especifique o preço em moeda real. Se necessário, configure preços regionais.
6. Configure os atributos usando um dos seguintes métodos (opcional):

1. 1. Adicione os atributos e seus valores no formato JSON.

1. 2. Crie atributos e valores manualmente e vincule-os a itens específicos.

7. Confira as configurações e selecione Create currency.

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items.
2. Selecione Add e então Virtual currency package na lista suspensa.

3. Especifique os seguintes parâmetros:
   1. Imagem (opcional).
   2. SKU.
   3. Um ou diversos grupos aos quais o pacote deve pertencer.
   4. Nome.
   5. Descrição (opcional).
4. Para configurar como a moeda virtual é exibida na loja, selecione o status apropriado.

5. Especifique a moeda virtual inclusa no pacote e sua quantia.
6. Defina preços ou crie um item gratuito no campo Paid or free:

1. • Para criar um pacote gratuito, selecione Free package.

1. • Para definir um preço, selecione Paid package e especifique o preço em moedas reais. Se necessário, configure preços regionais.

7. Para limitar a quantidade de pacotes disponíveis para compra, ative a opção Limit number of times one user can buy package e insira a quantidade desejada.
8. Para configurar a frequência da redefinição do limite:

1. 1. A partir da lista suspensa, selecione um período:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval – isso é calculado a partir da data inicial de exibição do pacote.
      • No regular refresh.

1. 2. Defina o cronograma de redefinição com base no período selecionado.

9. Configure um limite de tempo para exibir um pacote (opcional):

1. 1. No campo Show item in store, selecione Limited time.

1. 2. Especifique o fuso horário e o início e fim do período.

1. 1. Se você não quiser indicar o fim do período de exibição do item, marque a caixa No end date.

10. Configure os atributos usando um dos seguintes métodos (opcional):

1. 1. Adicione os atributos e seus valores no formato JSON.

1. 2. Crie atributos e valores manualmente e vincule-os a itens específicos.

11. Confira as configurações e selecione Create package.

Itens virtuais são conteúdos do jogo que você pode vender por moedas reais e virtuais.

Veja a seção dos Itens Virtuais para saber mais sobre os itens virtuais.

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items.
2. Selecione Add e então Virtual item na lista suspensa.

3. Especifique os seguintes parâmetros:
   • Imagem (opcional).
   • SKU.
   • Um ou diversos grupos aos quais o item deve pertencer.
   • Nome.
   • Descrição (opcional).
4. Para configurar como o item virtual é exibido na loja, selecione o status apropriado.

5. Defina preços ou crie um item gratuito no campo Paid or free:

1. • Para criar um item gratuito, selecione Free item.

1. • Para definir um preço, selecione Paid item e especifique o preço em moeda real. Se necessário, configure preços regionais.

6. Para limitar a quantidade de itens disponíveis para compra, ative a opção Limit number of times one user can buy this item e insira a quantidade desejada.
7. Para configurar a frequência da redefinição do limite:

1. 1. A partir da lista suspensa, selecione um período:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval – isso é calculado a partir da data inicial de exibição do item.
      • No regular refresh.

1. 2. Defina o cronograma de redefinição com base no período selecionado.

8. Configure um limite de tempo para exibir o item (opcional):

1. 1. No campo Show item in store, selecione Limited time.

1. 2. Especifique o fuso horário e o início e fim do período.

1. 1. Se você não quiser indicar o fim do período de exibição do item, marque a caixa No end date.

9. Configure os atributos usando um dos seguintes métodos (opcional):

1. 1. Adicione os atributos e seus valores no formato JSON.

1. 2. Crie atributos e valores manualmente e vincule-os a itens específicos.

10. Confira as configurações e clique em Create item.

Conjunto é uma combinação de vários itens que são vendidos como uma única unidade. Você pode adicionar itens de diferentes tipos a um conjunto:

• Moedas virtuais.
• Pacote de moedas virtuais.
• Itens virtuais, incluindo itens de tempo limitado.
• Conjuntos.

Veja a seção Conjuntos para saber mais sobre eles.

Para criar um conjunto:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items.
2. Selecione Add e então Bundle na lista suspensa.

3. Especifique os seguintes parâmetros:
   • Imagem (opcional).
   • SKU.
   • Um dos diversos grupos do qual o conjunto deve pertencer.
   • Nome.
   • Descrição (opcional).
4. Configure atributos do conjunto (opcional) usando um dos seguintes métodos:
   • Adicione atributos e seus valores no formato JSON.
   • Crie atributos e valores manualmente e vincule-os a itens específicos.
5. Selecione Next.
6. Se a personalização do lado do parceiro estiver habilitada, você pode escolher entre um tipo de conjunto padrão e um dinâmico. Conjuntos dinâmicos permitem que você pule a criação do item na Xsolla e, em vez disso, retorne os conteúdos do conjunto gerado pelo seu servidor quando o catálogo é solicitado. Se a personalização do lado do parceiro for desativada, o seletor do tipo de conjunto não é exibido, e um conjunto padrão é criado automaticamente.

7. Adicione itens ao conjunto:
   1. Selecione o tipo de item.
   2. Especifique um ou mais SKUs de itens a serem inclusos no conjunto.
   3. Defina a quantidade para cada SKU.

8. Selecione Next.
9. Defina o preço do conjunto no campo Paid or Free:
   • Para criar um conjunto gratuito, selecione Free bundle.
   • Para definir um preço, selecione Paid bundle e especifique o preço em moeda real ou virtual. Não é possível criar um conjunto com um preço de valor zero. Se necessário, configure preços regionais.
10. Para limitar a quantidade de conjuntos disponíveis para compra, ative a opção Limit bundle purchases per user e insira a quantidade desejada.

11. Para configurar a frequência de redefinição do limite:
    1. Na lista suspensa, selecione um período:
       • Diariamente.
       • Semanalmente.
       • Mensalmente.
       • Intervalo personalizado — isso é calculado a partir da data inicial de exibição do conjunto.
       • Sem atualização regular.
    2. Defina o cronograma de redefinição com base no período selecionado.

12. Selecione Next.

13. Configure como o conjunto é exibido na loja:
    1. Escolha o status.
    2. Defina um limite de tempo de exibição para o conjunto (opcional): especifique o fuso horário e o início e fim do período. Se você não quiser indicar o fim do período de exibição, marque a caixa No end date.

14. Selecione Next.
15. Confira as configurações e clique em Save.

Você pode configurar planos de assinatura por meio da Conta de Distribuidor ou com a chamada de API Criar Plano.

Para configurar um plano através da Conta de Distribuidor:

1. Vá para a seção Subscriptions.
2. Na aba Subscription plan, selecione Create subscription plan.

3. Escolha e configure o tipo de plano:
   • Plano regular com pagamentos regulares.
   • Plano vitalício com um pagamento único e um período ilimitado de validade.
   • Passe de temporada com um pagamento único e um período limitado de validade.

Configure um plano regular

1. Especifique:
   1. Nome do plano.
   2. Descrição (opcional): essa descrição do plano é exibida na interface de pagamento quando os usuários estão comprando uma assinatura.

2. Clique em Next.
3. Escolha uma das opções de taxa de assinatura:
   • Regular: o valor de cada pagamento é especificado manualmente.
   • Including setup fee: o valor de cada pagamento, bem como o valor da taxa de configuração, são especificados manualmente. Use essa configuração se quiser cobrar custos adicionais do assinante, como conectar uma licença, configurar um sistema, treinar um usuário ou fornecer uma consulta. Neste caso, o primeiro pagamento incluirá uma taxa de configuração e os pagamentos restantes serão equivalentes ao valor do pagamento regular.

• • Associated with the first payment: o valor de cada pagamento é equivalente ao primeiro pagamento. O custo da assinatura e o tipo de moeda são passados nos parâmetros purchase.checkout.amount e purchase.checkout.currency ao abrir a interface de pagamento. Use essa opção se quiser gerenciar preços do seu lado e definir preços individuais para usuários específicos.

4. Independentemente do tipo de taxa escolhida, regular ou de configuração, você poderá configurar preços de assinatura diferentes para diferentes moedas. Para fazer isso:

• 1. No campo Currency e Price, selecione a moeda necessária e especifique o preço da assinatura. Para uma assinatura com taxa de configuração, insira também o valor da taxa de configuração no campo correspondente.

• 2. Clique em + para adicionar preços em outras moedas.

• 3. Especifique a moeda padrão.

5. Configure o ciclo de cobrança:
   1. Especifique a frequência do pagamento.
   2. Especifique o número de dias no período de avaliação em que a assinatura pode ser usada sem pagamento. Defina o valor como 0 para criar um plano sem um período de avaliação.

6. Especifique parâmetros para um pagamento único. Com esse tipo de renovação de assinatura, os usuários fazem pagamentos por meio de um link de pagamento enviado por e-mail.
   1. Lembrete de vencimento: especifique o número de dias antes da data de vencimento da assinatura em que o usuário receberá um lembrete. Se o valor for definido como 6 ou superior, o usuário receberá um lembrete extra um dia antes da data de vencimento. Defina o valor como 0 se você não quiser enviar um lembrete.
   2. Período de carência: o número de dias que os usuários podem continuar usando sua assinatura após a data de validade com a opção de renová-la. Defina o valor como 0 para criar um plano sem um período de cortesia.

7. Especifique os parâmetros para um pagamento automático: com esse tipo de renovação de assinatura, os pagamentos são feitos automaticamente usando as informações de cobrança salvas sem qualquer interação do usuário.
   1. Lembrete de validade da assinatura.
   2. A quantidade de tentativas após a primeira tentativa malsucedida de cobrar pela assinatura. O sistema tentará novamente uma vez por dia.

8. Clique em Next.

9. Clique em Criar.

Configure um plano vitalício

1. Especifique:
   1. Nome do plano.
   2. Descrição (opcional): essa descrição do plano é exibida na interface de pagamento quando os usuários estão comprando uma assinatura.

2. Clique em Next.
3. Escolha uma das opções de taxa de assinatura:
   • Regular: o valor de cada pagamento é especificado manualmente.
   • Associated with the first payment: o valor de cada pagamento é equivalente ao primeiro pagamento feito pelo usuário. O custo da assinatura e o tipo de moeda são passados nos parâmetros purchase.checkout.amount e purchase.checkout.currency ao abrir a interface de pagamento. Use essa opção se quiser gerenciar os preços do seu lado e ser capaz de definir o preço individual para um usuário específico.

4. No campo Refund period, defina o número de dias em que o usuário pode cancelar a assinatura e reembolsar o pagamento.

5. Se você escolher uma taxa de assinatura regular, você poderá configurar preços de assinatura diferentes para moedas diferentes. Para fazer isso:

• 1. No campo Currency e Price, selecione a moeda necessária e especifique o valor do preço de assinatura.

• 2. Clique em + para adicionar preços em outras moedas.

• 3. Especifique a moeda padrão.

6. Clique em Next.

7. Clique em Create.

Configure um passe de temporada

1. Especifique:
   1. Nome do plano.
   2. Período de validade do passe de temporada.
   3. Descrição (opcional): essa descrição do plano é exibida na interface de pagamento quando os usuários compram uma assinatura.

2. Clique em Next.
3. Escolha uma das opções de taxa de assinatura:
   • Regular: o valor de cada pagamento é especificado manualmente.
   • Associated with the first payment: o valor de cada pagamento é equivalente ao primeiro pagamento feito pelo usuário. O custo da assinatura e o tipo de moeda são passados nos parâmetros purchase.checkout.amount e purchase.checkout.currency ao abrir a interface de pagamento. Use essa opção se quiser gerenciar os preços do seu lado e ser capaz de definir o preço individual para um usuário específico.

4. No campo Período de reembolso, defina o número de dias em que o usuário pode cancelar a assinatura e reembolsar o pagamento.

5. Se você escolher uma taxa de assinatura regular, você poderá configurar preços de assinatura diferentes para moedas diferentes. Para fazer isso:

• 1. No campo Currency e Price, selecione a moeda necessária e especifique o valor do preço de assinatura.

• 2. Clique em + para adicionar preços em outras moedas.

• 3. Especifique a moeda padrão.

6. Clique em Next.

7. Clique em Create.