Itens gratuitos

Como funciona

Itens grátis são um tipo de item que o usuário pode obter sem gastar moedas virtuais ou reais. Estes incluem:

  • Itens virtuais
  • Conjuntos
  • Pacotes de moedas virtuais

Os itens grátis estão disponíveis apenas para usuários autorizados. Usuários não autorizados só podem visualizar o catálogo de itens grátis.

Exemplos de uso:

  • Você pode dar itens grátis em datas importantes para o seu projeto (por exemplo, no dia em que o projeto foi fundado) para recompensar os usuários por sua lealdade.
  • Você pode presentear pacotes de iniciante grátis do jogo na loja para atrair novos usuários ao jogo.

Você pode limitar a quantidade grátis de itens exclusivos caso o usuário já os possuam.

Quem pode usar

  • Para parceiros que já têm a In-Game Store e querem configurar um novo tipo de produto — itens gratuitos.
  • Para parceiros que desejam aumentar a fidelidade dos usuários atuais ou atrair novos jogadores.

Fluxo de integração

  1. Crie itens gratuitos das seguintes maneiras:
  2. Configure a Store.
  3. Obtenha o status do pedido de um usuário.

Criar via Conta de Distribuidor

Para criar um item gratuito (com base no exemplo de itens virtuais):
  1. Abra seu projeto na Conta de Distribuidor.
  2. Clique em Store no menu lateral.
  3. No painel Virtual Items, clique em Configure.
  4. Clique em + e selecione Create item na lista suspensa.
  5. Especifique:
    • Imagem
    • SKU
    • Um ou vários grupos aos quais o item deve pertencer
    • Nome
    • Descrição
    • Propriedade de item: consumível, não consumível ou item de tempo limitado
  6. No bloco Price settings, escolha Free item.
  7. Se você quiser limitar a disponibilidade de itens a usuários específicos, defina a opção Limit number of times one user can buy this item como On.
  8. Se você quiser mostrar um item na loja, defina a opção Show item in store como On.
  9. Clique em Create item.

Criar via chamadas de API

  1. Para criar itens gratuitos, use chamadas de API da subseção Admin:Ao criar ou editar um item, passe is_free = true no corpo da solicitação.
  2. Se você quiser limitar a disponibilidade de itens para usuários específicos, chame qualquer método de API para criar ou editar um item e especifique o valor do parâmetro limits.per_user.

Configurar a Store

Compra rápida

Se um usuário fizer uma compra rápida (o usuário faz uma compra sem usar o carrinho), você deve chamar a API Create order with specified free item para fornecer a oportunidade de receber itens grátis. A entrega dos itens ao inventário do usuário ocorre imediatamente após uma solicitação bem-sucedida a esse método (sem ser necessário abrir o formulário de pagamentodo Pay Station). A Xsolla envia um webhook Successful payment of the order para confirmar a entrega do item.
Observação
O envio do webhook Successful payment of the order ocorre imediatamente após a entrega dos itens grátis. Nesse caso, o webhook Pagamento não é enviado.
Exemplo de solicitação:
Copy
Full screen
Small screen

{
  "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
  }
}
Observação
Para itens gratuitos, o parâmetro order.invoice_id é definido como null.
Em resposta, um webhook deve ser enviado do seu lado:
  • Se o ouvinte aceitou e processou corretamente o webhook — código de resposta HTTP 200 ou 204.
  • Se o erro esperado ocorrer — código de resposta HTTP 4xx.
  • Observação
    Neste caso, os itens são adicionados ao inventário do jogador e a ordem é marcada como bem-sucedida do lado da Xsolla.
  • Seu ouvinte também pode retornar um código de resposta HTTP 5xx para erros temporários em seu servidor. Nesse caso, o serviço de alerta Xsolla usa um mecanismo de repetição.

Compra no carrinho

Se um usuário usar a compra de carrinho:

O exemplo de webhook é semelhante ao exemplo de compra rápida.

Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 3 de Outubro de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!