# Mettre à jour une monnaie virtuelle

Met à jour une monnaie virtuelle.

Endpoint: PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID du projet. Vous trouverez ce paramètre dans le Compte éditeur, à côté du nom du projet, ainsi que dans l'URL affichée dans la barre d'adresse du navigateur lorsque vous utilisez ce projet. L'URL présente le format suivant : https://publisher.xsolla.com//projects/.
    Example: 44056

  - `virtual_currency_sku` (string, required)
    UGS de la monnaie virtuelle.
    Example: "crystal"

## Request fields (application/json):

  - `sku` (string, required)
    ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.

  - `name` (object,null, required)
    Conteneur objet contenant les localisations du nom de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `description` (object,null)
    Conteneur objet contenant les localisations de la description de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `long_description` (object,null)
    Conteneur objet contenant les localisations de la description complète de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `image_url` (string)
    URL de l'image. Pour garantir un affichage correct et un chargement rapide dans l'interface de paiement, consultez les recommandations suivantes pour les images et les URL :Formats pris en charge : WebP (recommandé), PNG, JPG.Taille du fichier : ≤ 50 Kb (WebP) ou ≤ 150 Kb (PNG et JPG).Dimensions : 280 x 280 px.Espace colorimétrique : sRGB.Protocole : HTTPS avec mise en cache longue durée pour les URL versionnées.

  - `media_list` (array)
    Ressources supplémentaires de l'objet, telles que des captures d'écran, des vidéos de gameplay, etc.

  - `media_list.type` (string)
    Type de média : image/video.
    Enum: "image", "video"

  - `media_list.url` (string)
    Fichier de ressources.
    Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"

  - `groups` (array)
    Liste des [ID externes des groupes](/fr/api/catalog/item-groups-admin/admin-get-item-group-list/#!path=groups/external_id&t=response) auxquels l'objet appartient.

Exemple : ["horror", "action"]

  - `attributes` (array)
    Liste des attributs.

Attention. La création de plus de 20 attributs pour un objet n'est pas autorisée. Toute tentative de dépassement entraîne une erreur.

  - `attributes.external_id` (string, required)
    ID unique de l'attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des tirets et des traits bas.

  - `attributes.name` (object)
    Objet contenant des versions localisées du nom de l'attribut. Les clés sont spécifiées selon la norme ISO 3166-1.

  - `attributes.values` (array, required)
    Attention. La création de plus de 6 valeurs pour un attribut n'est pas autorisée. Toute tentative de dépassement entraînera une erreur.
    Example: [{"external_id":"strategy","value":{"en":"Strategy","de":"Strategie"}},{"external_id":"action","value":{"en":"Action","de":"Aktion"}}]

  - `attributes.values.external_id` (string, required)
    ID unique de la valeur d'un attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules, des tirets et des tirets bas.
    Example: "value_external_id"

  - `attributes.values.value` (object, required)
    Objet contenant des versions localisées du nom de la valeur. Les clés sont spécifiées selon la norme ISO 3166-1.

  - `prices` (array)
    Example: [{"currency":"USD","amount":10.5,"is_default":true,"is_enabled":true,"country_iso":"US"}]

  - `prices.currency` (string, required)
    Devise du prix de l'objet. Code à trois lettres selon [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Consultez la documentation pour obtenir des informations détaillées sur les devises [prises en charge par Xsolla](https://developers.xsolla.com/fr/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `prices.amount` (number, required)
    Prix de l'objet en monnaie réelle.
    Example: 10.5

  - `prices.is_default` (boolean)
    Indique s'il s'agit du prix par défaut en devise réelle. Consultez la [documentation](https://developers.xsolla.com/fr/items-catalog/catalog-features/pricing-policy/#pricing_policy_country_determination) pour plus d'informations sur la configuration des prix.
    Example: true

  - `prices.is_enabled` (boolean)
    Indique si ce prix est utilisé pour l'affichage dans le catalogue et pour l'achat de l'objet. Si la valeur est false, ce prix n'est pas utilisé et un autre prix s'applique. Consultez la [documentation](https://developers.xsolla.com/fr/items-catalog/catalog-features/pricing-policy/#pricing_policy_country_determination) pour plus d'informations sur la configuration des prix.
    Example: true

  - `prices.country_iso` (string,null)
    Pays où ce prix est disponible. Code à deux lettres selon la norme [ISO 3166-1 alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Example: "US"

  - `vc_prices` (array,null)
    Tableau des prix des monnaies virtuelles.
    Example: [{"sku":"com.xsolla.gold_1","amount":10,"is_default":true,"is_enabled":true}]

  - `vc_prices.sku` (string, required)
    ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.
    Example: "com.xsolla.gold_1"

  - `vc_prices.amount` (integer, required)
    Prix de l'objet en monnaie virtuelle.
    Example: 10

  - `vc_prices.is_default` (boolean, required)
    Détermine s'il s'agit du prix par défaut en monnaie virtuelle.
    Example: true

  - `vc_prices.is_enabled` (boolean, required)
    Indique si ce prix est utilisé pour l'affichage dans le catalogue et pour l'achat de l'objet. Si la valeur est false, ce prix n'est pas utilisé.
    Example: true

  - `is_enabled` (boolean)
    Indique si l'objet est disponible. Si la valeur est false, l'objet ne peut pas être acheté dans le magasin ni obtenu dans un lot ou dans une campagne marketing. Consultez la [documentation](https://developers.xsolla.com/fr/items-catalog/catalog-features/items-availability/) pour plus d'informations sur la disponibilité des objets.

  - `is_show_in_store` (boolean)
    Indique si l'objet est affiché dans le catalogue. Si la valeur est false et que is_enabled: true, l'objet n'est pas visible dans le catalogue, mais peut être obtenu dans un lot ou dans une campagne marketing. Consultez la [documentation](https://developers.xsolla.com/fr/items-catalog/catalog-features/items-availability/) pour plus d'informations sur la disponibilité des objets.

  - `is_free` (boolean)
    Détermine la gratuité de l'objet.

  - `is_paid_randomized_reward` (boolean)
    Si l’objet est une récompense payante aléatoire (par exemple, une boîte à butin).

  - `order` (integer)
    Ordre d'affichage de l'objet dans le catalogue. Plus la valeur est élevée, plus l'objet apparaît bas dans la liste.
Si les valeurs sont identiques, les objets sont triés par date de création, les plus récents apparaissant en premier.

  - `regions` (array)
    Tableau des régions dans lesquelles l'objet est disponible. Si le tableau est vide ou non fourni, l'objet est disponible dans toutes les régions.

  - `regions.id` (integer)
    ID de la région au sein du projet.

Consultez la [documentation sur les restrictions de vente régionales](https://developers.xsolla.com/fr/items-catalog/catalog-features/regional-restrictions/) et les [appels API de gestion des régions](https://developers.xsolla.com/fr/api/catalog/common-regions) pour plus d'informations.
    Example: 1

  - `limits` (object)
    Limites d'objets.

  - `limits.per_user` (any)
    Limites d'objets pour un utilisateur spécifique.

  - `limits.per_item` (integer,null)
    Limites globales d'objets.

  - `limits.recurrent_schedule` (object,null)
    Délai d'actualisation des limites.

  - `limits.recurrent_schedule.per_user` (any)
    Réinitialisation des limites d'achat effectuée selon l'intervalle de temps spécifié, en heures.

  - `periods` (array,null)
    Période de vente d'objets.

  - `periods.date_from` (string)
    Date de mise en vente de l'objet spécifié.
    Example: "2020-08-11T10:00:00+03:00"

  - `periods.date_until` (string,null)
    Date de retrait de la vente de l'objet spécifié. Peut prendre la valeur null.
    Example: "2020-08-11T20:00:00+03:00"

  - `custom_attributes` (object)
    Un JSON contenant les attributs de l'objet et leurs valeurs. Les attributs permettent d'ajouter des informations supplémentaires aux objets, telles que le niveau requis du joueur pour utiliser l'objet. Les attributs enrichissent la logique interne de votre jeu et sont accessibles via des méthodes GET et des webhooks spécifiques.

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

## Response 422 fields (application/json):

  - `statusCode` (integer)
    Example: 422

  - `errorCode` (integer)
    Example: 1102

  - `errorMessage` (string)
    Example: "[0401-1102]: Unprocessable Entity. The property `property_name` is required"

  - `transactionId` (string)
    Example: "x-x-x-x-transactionId-mock-x-x-x"

  - `errorMessageExtended` (array)


## Response 204 fields