Verkaufsbeschränkungen für Schlüssel

So funktioniert's

Sie können beschränken, wie viele Schlüssel ein Benutzer kaufen darf.

Erreicht der Benutzer das festgelegte Limit, kann er keine weiteren Schlüssel erwerben und es wird ein Fehler mit dem Code 0401-1421 zurückgegeben. In diesem Fall müssen Sie dem Benutzer einen Hinweis über das Erreichen des Kauflimits anzeigen.

Sie können die maximale und die verbleibende Anzahl von Spielschlüsseln anzeigen, die der Benutzer kaufen kann.

Sofern Ihnen eine der folgenden Rollen im Kundenportal zugewiesen ist, werden Sie per E-Mail benachrichtigt, wenn in einem Paket nur noch 25 %, 10 % und 0 % der hochgeladenen Schlüssel vorhanden sind:

• Entwickler
• Inhaber

Nur ein Projektinhaber kann Rollen im Kundenportal unter Firmeneinstellungen > Nutzer ändern.

Für wen ist es

Partner, die Buy Button integriert und das Modul Spielschlüssel aktiviert haben.

Wie komme ich dazu

Um beim Erstellen eines Spielschlüsselpakets im Kundenportal ein Kauflimit festzulegen, müssen Sie den Schalter Anzahl der Käufe von Spielschlüssen pro Benutzer beschränken auf Ein stellen, und festlegen, wie oft der Schlüssel gekauft werden darf.

Sie können die Methoden der Untergruppe Katalog aus der Methodengruppe Spielschlüssel nutzen, um Informationen über Spielschlüssel abzurufen.

In der Antwort sind neben den Informationen über den Spielschlüssel die folgenden Daten enthalten:

• wie viele Spielschlüssel ein Benutzer maximal kaufen kann
• die verbleibende Anzahl der Spielschlüssel, die ein Benutzer kaufen kann

Antwortbeispiel:

{
  "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
  },
}