キー販売制限
どのように動作するか
ユーザーが購入できるゲームキーの数を制限することができます。
ユーザーが指定した上限に達した場合、追加のキーは購入できなくなり、コード0401-1421のエラーが返されます。この場合、ユーザーに対して購入制限に達したことを示す情報を表示する必要があります。
ユーザーが利用できるゲームキーの最大値および残りの数量を表示することができます。
キーが販売されると、各パッケージのアップロード済みキーが25%、10%、0%になった時点で、メールで通知されます。アドミンページに以下のロールがある場合に通知されます：
- 開発者
- 所有者
アドミンページでの会社設定 > ユーザーセクションでロールを変更できるのは、プロジェクト所有者のみです。
エクソーラは、制限を超えないようにし、ユーザーが設定された上限を超えてゲームキーを購入することを防ぎます。
決済インターフェースを開き、ゲームキーの代金を支払うと、このキーによるすべての未払い注文が無効になります。
例：ユーザーは、ゲームキーが購入されるまで、いくつかのブラウザータブで購入制限のあるゲームキーの決済フォームを開くことができます。これにより、自動的に同じゲームキーの注文が複数作成されます。1つのタブでゲームキーを購入した後、エクソーラは同じゲームキーの未払い注文をすべて無効にします。
入手方法
アドミンページでゲームキーパッケージを作成する時に購入制限を設定するには、1人のユーザーがこのゲームキーを購入できる回数を制限するのトグルをオンに切り替え、キーの購入可能回数を指定します。
ゲームキーに関する情報を取得するには、ゲームキーメソッドグループからカタログサブセクションのメソッドを使用します。
応答では、ゲームキーに関する情報のほか、以下の情報を受け取ることができます：
- 1ユーザーが購入できる最大ゲームキー数
- ユーザーが購入可能なゲームキーの残数
応答の例：
- json
{
"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
},
}
誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
