Restrições de venda de chaves

Como funciona

Você pode limitar o número de chaves de jogo que um usuário pode comprar.

Se o usuário tiver atingido o limite especificado, chaves adicionais não estarão disponíveis para compra e um erro com o código 0401-1421 será retornado. Nesse caso, você precisa exibir informações ao usuário sobre como atingir o limite de compra.

Você pode exibir o número máximo disponível e o número restante de chaves de jogo que está disponível para o usuário.

À medida que as chaves são vendidas, você será notificado por e-mail quando houver 25%, 10% e 0% de chaves carregadas em cada pacote. Você será notificado se tiver uma das seguintes funções na Conta de Distribuidor:

• desenvolvedor
• proprietário

Somente um proprietário de projeto pode alterar funções na Conta de Distribuidor na seção Company settings > Users.

Quem pode usar

Parceiros que tenham o Buy Button integrado e o módulo Game Keys ativado.

Como obtê-lo

Para definir um limite de compra ao criar um pacote de chaves de jogo na Conta de Distribuidor, defina a opção Limit number of times one user can buy game key como On e especifique o número de vezes que a chave pode ser comprada.

Você pode usar os métodos da subseção Catalog do grupo de métodos Game Keys para obter informações sobre chaves de jogo.

Na resposta, você receberá as seguintes informações, além de informações sobre a chave de jogo:

• o número máximo de chaves de jogo que um usuário pode comprar
• o número restante de chaves de jogo disponíveis para o usuário comprar

Exemplo de resposta:

{
  "sku": "game_1",
  "name": "Game name",
  "groups": [
    {
      "external_id": "all",
      "name": "All games"
    },
    {
      "external_id": "Xsolla",
      "name": "Xsolla games"
    }
  ],
  "type": "game_key",
  "description": "Game description",
  "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
  "attributes": {
    "$ref": "../components/examples/client-attribute-game-horror.yaml#/value"
  },
  "is_free": false,
  "price": {
    "amount": "30.5",
    "amount_without_discount": "30.5",
    "currency": "USD"
  },
  "virtual_prices": [],
  "can_be_bought": true,
  "drm_name": "Steam",
  "drm_sku": "steam",
  "has_keys": true,
  "is_pre_order": true,
  "release_date": "2020-08-11T10:00:00+03:00",
  "limits": {
    "per_user": {
        "total": 5,
        "available": 5
    },
    "per_item": null
  },
}