Documentation Steamworks
QueryRefundAllowed/v0001
Méthode appelée par Steam quand quelqu'un consulte le site du Support et cherche à obtenir plus d'informations à propos d'un achat en jeu. La réponse indique l'état actuel des items associés à un achat et précise si chaque item peut actuellement faire l'objet d'une demande d'un remboursement ou non.

Méthode appelée par : le service de remboursements Steam

Méthode HTTP : GET

Paramètres :

NomTypeRequisDescription
keystringIl s'agit de la « clé du serveur de ressources » que vous avez indiquée dans les paramètres de l'économie Steam de votre application sur le site des partenaires.
appiduint32L'AppID 32 bits de l'application associée à l'achat. Il s'agit de l'AppID de votre jeu.
steamiduint64Le SteamID 64 bits de la personne qui a effectué l'achat.
languagestringCode de langue ISO 639-1 et code pays au format ISO 3166-1 alpha 2 de la langue dans laquelle renvoyer les chaines de caractères.
Quelques exemples : en_US, de_DE, zh_CN, ko_KR. Valeur par défaut : en_US.
orderiduint64L'identifiant unique 64 bits de la commande. Il s'agit du même identifiant de commande qui nous a été fourni lors de l'appel de ISteamMicroTxn/InitTxn.

Éléments renvoyés :

Les données de sortie de cette méthode doivent être encodées au format JSON.

Réponse :
  • result
    • success : vaut true si la méthode a réussi. Si le serveur de ressources renvoie false, il doit affecter à error une chaine de caractères qui explique pourquoi.
    • error : chaine de caractères décrivant la raison de l'échec de cet appel. Ce message sera enregistré dans le journal d'erreurs, disponible sous le menu Économie de l'onglet Communauté sur le site de Steamworks.
    • assets  : un ensemble des items achetés.
      • itemtypeid : identifiant de l'item du jeu. Il s'agit de la valeur de itemid qui nous a été fournie dans l'appel de ISteamMicroTxn/InitTxn.
      • allow_refund : doit être true sauf si l'item acheté a été consommé, modifié ou transféré.
      • in_inventory : vaut true si la personne qui a acheté l'item le possède toujours.
      • bundle : si l'item que la personne a acheté est en fait un bundle qui contient d'autres items, assignez la valeur true à ce paramètre et incluez également les items du bundle dans les entrées suivantes du tableau d'assets.
      • current_state : chaine de caractères explicite qui indique l'état actuel de l'item. Cette chaine est visible par la personne. Elle doit donc être traduite si possible. Essayez de faire preuve de la plus grande précision : cela vaut mieux, surtout quand allow_refund vaut false. Cela peut être par exemple : « Item utilisé pour en fabriquer un autre le 25 mars 2015 » ou « Dans votre inventaire ».
      • item_name : nom de l'item. Cette chaine est visible par la personne. Elle doit donc être traduite si possible.
      • amount : quantité de cet item qui a été achetée. Tous les items doivent avoir le même id (sauf si votre jeu ne prend pas en charge nos API de l'économie Steam). Si plusieurs items ont été achetés, mais ont différentes valeurs pour id, ajoutez alors plusieurs entrées dans le tableau d'assets au lieu d'utiliser ce champ amount.

        REMARQUE : les champs suivants ne s'appliquent que si votre jeu prend en charge les API de l'économie Steam.
      • id : identifiant de ressource (assetid) ou de devise (currencyid) de l'item qui a été donné.
      • contextid : identifiant du contexte (contextid) dans lequel l'item a été placé.
      • currency : vaut true si id est un identifiant de devise (currencyid).
      • class : tableau d'identifiants de classes de ressources définis par le jeu. Ce paramètre doit être identique au paramètre class retourné par GetAssetClass/v0001.

Exemple de sortie

{ "result": { "assets": [ { "itemtypeid": 594, "contextid": 2, "currency": false, "amount": 1, "id": 3837860447, "class": [ { "name": "def_index", "value": "594" }, { "name": "flags", "value": "16" }, { "name": "origin", "value": "2", "instance": true }, { "name": "@tradable after date", "value": "1434493482", "instance": true } ] , "allow_refund": true, "in_inventory": true, "bundle": false, "current_state": "In your inventory", "item_name": "The Phlogistinator" }, { "itemtypeid": 214, "contextid": 2, "currency": false, "amount": 1, "id": 3837860448, "class": [ { "name": "def_index", "value": "214" }, { "name": "flags", "value": "16" }, { "name": "origin", "value": "2", "instance": true }, { "name": "@tradable after date", "value": "1434493482", "instance": true } ] , "allow_refund": true, "in_inventory": true, "bundle": false, "current_state": "In your inventory", "item_name": "The Powerjack" } ] , "success": true } }