` est le jeton utilisateur. Le jeton identifie l'utilisateur et donne accès aux données personnalisées. Vous pouvez également utiliser un [jeton pour ouvrir l'interface de paiement](/fr/api/pay-station/token/create-token).\n\n2. **Mode simplifié sans en-tête Authorization.** Ce mode est réservé aux utilisateurs non authentifiés et peut être utilisé uniquement pour la [vente de clés de jeu](/fr/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). Au lieu d'un jeton, la requête doit inclure les en-têtes suivants :\n - `x-unauthorized-id` avec un identifiant de requête\n - `x-user` avec l'adresse e-mail de l'utilisateur encodée en Base64\n\n## Liens utiles\n\n- [Appels API par modèle d'interaction](https://developers.xsolla.com/fr/api/catalog/)\n- [Types de enpoints](https://developers.xsolla.com/fr/api/catalog/)\n- [Gestion des erreurs](https://developers.xsolla.com/fr/api/catalog/)\n- [Clés API](https://developers.xsolla.com/fr/api/catalog/)\n\n# Structure de l'entité principale\n\nLes objets de tous types (objets virtuels, lots, monnaie virtuelle et clés) partagent une structure de données similaire. Comprendre cette structure de base facilite l’utilisation de l'API et la navigation dans la documentation.\n\nNote
Certains appels peuvent inclure des champs supplémentaires, mais ils ne modifient pas la structure de base.
\n\n**Identification**\n\n- `merchant_id` — ID de l'entreprise dans le [Compte éditeur](https://publisher.xsolla.com/)\n- `project_id` — ID de projet dans le Compte éditeur\n- `sku` — UGS de l'objet, unique au sein du projet\n\n**Affichage en magasin**\n\n- `name` — nom de l'objet\n- `description` — description de l'objet\n- `image_url` — URL de l'image\n- `is_enabled` — disponibilité de l'objet\n- `is_show_in_store` — affichage de l'objet dans le catalogue\n\nPour plus d'informations sur la gestion de la disponibilité des objets dans le catalogue, consultez la [documentation](/fr/items-catalog/catalog-features/items-availability/).\n\n**Organisation**\n\n- `type` — type d'objet, par exemple, un objet virtuel (`virtual_item`) ou un lot (`bundle`)\n- `groups` — groupes auxquels l'objet appartient\n- `order` — ordre d'affichage dans le catalogue\n\n**Conditions de vente**\n\n- `prices` — prix en devise réelle ou monnaie virtuelle\n- `limits` — limites d'achat\n- `periods` — périodes de disponibilité\n- `regions` — restrictions régionales\n\n**Exemple de structure d'entité principale :**\n\n```json\n{\n \"attributes\": [],\n \"bundle_type\": \"virtual_currency_package\",\n \"content\": [\n {\n \"description\": {\n \"en\": \"Main in-game currency\"\n },\n \"image_url\": \"https://.../image.png\",\n \"name\": {\n \"en\": \"Crystals\",\n \"de\": \"Kristalle\"\n },\n \"quantity\": 500,\n \"sku\": \"com.xsolla.crystal_2\",\n \"type\": \"virtual_currency\"\n }\n ],\n \"description\": {\n \"en\": \"Crystals x500\"\n },\n \"groups\": [],\n \"image_url\": \"https://.../image.png\",\n \"is_enabled\": true,\n \"is_free\": false,\n \"is_show_in_store\": true,\n \"limits\": {\n \"per_item\": null,\n \"per_user\": null,\n \"recurrent_schedule\": null\n },\n \"long_description\": null,\n \"media_list\": [],\n \"name\": {\n \"en\": \"Medium crystal pack\"\n },\n \"order\": 1,\n \"periods\": [\n {\n \"date_from\": null,\n \"date_until\": \"2020-08-11T20:00:00+03:00\"\n }\n ],\n \"prices\": [\n {\n \"amount\": 20,\n \"country_iso\": \"US\",\n \"currency\": \"USD\",\n \"is_default\": true,\n \"is_enabled\": true\n }\n ],\n \"regions\": [],\n \"sku\": \"com.xsolla.crystal_pack_2\",\n \"type\": \"bundle\",\n \"vc_prices\": []\n}\n```\n\n# Processus d'achat de base\n\nL'API Xsolla vous permet d'implémenter la logique de magasin en jeu, notamment la récupération du catalogue des objets, la gestion du panier, la création de commandes et le suivi de leur statut. Selon le scénario d'intégration, les appels API sont répartis en sections **Administrateur** et **Catalogue**, qui utilisent différents [schémas d'authentification](/fr/api/catalog/section/authentication).\n\nL'exemple suivant montre un processus de base pour configurer et exploiter un magasin, de la création d'objets à l'achat.\n\n## Création d'objets et de groupes (Administrateur)\n\nCréez un catalogue des objets pour votre magasin, tels que des objets virtuels, des lots ou de la monnaie virtuelle.\n\nExemples d'appels API :\n- [Créer un objet virtuel](/fr/api/catalog/virtual-items-currency-admin/admin-create-virtual-item)\n- [Créer un lot](/fr/api/catalog/bundles-admin/admin-create-bundle)\n- [Créer une monnaie virtuelle](/fr/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency)\n\n## Configuration de promotions, chaînes et limites (Administrateur)\n\nConfigurez des outils d'acquisition d'utilisateurs et de monétisation, tels que des remises, des bonus, des récompenses quotidiennes ou des chaînes d'offres.\n\nExemples d'appels API :\n- [Créer une promotion de bonus](/fr/api/liveops/promotions-bonuses/create-bonus-promotion)\n- [Créer une récompense quotidienne](/fr/api/liveops/daily-chain-admin/admin-create-daily-chain)\n- [Créer une offre de catalogue unique](/fr/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer)\n\n## Récupération d'informations sur un objet (Client)\n\nConfigurez l'affichage des objets dans l'application.\n\n\n
Remarque\n N'utilisez pas les appels API de la sous-section Administrateur pour créer un catalogue utilisateur. Ces appels API présentent des
limites de taux et ne sont pas destinés au trafic utilisateur.\n
\n\nExemples d'appels API :\n- [Lire la liste des objets virtuels](/fr/api/catalog/virtual-items-currency-catalog/get-virtual-items)\n- [Lire la liste des groupes d'objets](/fr/api/catalog/virtual-items-currency-catalog/get-item-groups)\n- [Lire la liste des lots](/fr/api/catalog/bundles-catalog/get-bundle-list)\n- [Lire la liste des objets vendables](/fr/api/catalog/common-catalog/get-sellable-items)\n\n\n Note
\n Par défaut, les appels API du catalogue renvoient les objets disponibles dans la boutique au moment de la requête. Pour récupérer les objets inactifs ou à durée limitée, ajoutez le paramètre \"show_inactive_time_limited_items\": 1 dans la requête du catalogue.\n
\n\n## Vente des objets\n\nVous pouvez vendre des objets en utilisant les méthodes suivantes :\n- Achat rapide — vendre une UGS plusieurs fois.\n- Achat via le panier — l'utilisateur ajoute des objets au panier, supprime des objets et modifie les quantités dans une seule commande.\n\nSi un objet est acheté en utilisant de la monnaie virtuelle au lieu des devises réelles, utilisez l'appel API [Créer une commande à partir d'un objet spécifique en monnaie virtuelle](/fr/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency). L'interface de paiement n'est pas requise, car le coût est traité lors de l'exécution de l'appel API.\n\nPour l'achat d'un objet gratuit, utilisez l'appel API [Créer une commande avec un bien gratuit spécifique](/fr/api/catalog/free-item/create-free-order-with-item) ou l'appel API [Créer une commande à partir d'un panier gratuit](/fr/api/catalog/free-item/create-free-order). L'interface de paiement n'est pas requise, la commande est immédiatement définie sur le statut done.\n\n### Achat rapide\n\nUtilisez l'appel API côté client pour [créer une commande à partir d'un objet spécifique](/fr/api/catalog/payment-client-side/create-order-with-item). L'appel renvoie un jeton utilisé pour ouvrir l'interface de paiement.\n\n\n Note
\n Les informations sur les remises sont disponibles pour l'utilisateur uniquement dans l'interface de paiement. Les codes promo ne sont pas pris en charge.\n
\n\n### Achat via le panier\n\nLa configuration et les achats du panier peuvent être gérés côté client ou côté serveur.\n\n**Configuration et achat du panier côté client**\n\nImplémentez vous-même la logique d'ajout et de suppression des objets. Avant d'appeler l'API pour configurer un panier, vous ne disposerez pas d'informations sur les promotions qui s'appliqueront à l'achat. Le coût total ainsi que les informations des objets bonus ajoutés ne seront donc pas encore connus.\n\nImplémentez la logique suivante pour le panier :\n1. Après que le joueur a rempli un panier, utilisez l'appel API [Remplir le panier d'objets](/fr/api/shop-builder/operation/cart-fill/). L'appel renvoie les informations actuelles sur les objets sélectionnés (prix avant et après remises, objets bonus).\n2. Mettez à jour le contenu du panier en fonction des actions utilisateur :\n - Pour ajouter un objet ou modifier la quantité de l'objet, utilisez l'appel API [Mettre à jour un objet du panier par ID de panier](/fr/api/shop-builder/operation/put-item-by-cart-id/).\n - Pour supprimer un objet, utilisez l'appel API [Supprimer un objet du panier par ID de panier](/fr/api/shop-builder/operation/delete-item-by-cart-id/).\n\n\n Note
\n Pour obtenir le statut actuel du panier, utilisez l'appel API Lire le panier de l'utilisateur actuel.\n
\n\n3. Utilisez l'appel API [Créer une commande à partir de tous les objets du panier actuel](/fr/api/shop-builder/operation/create-order/). L'appel renvoie l'ID de commande et le jeton de paiement. La commande nouvellement créée est définie sur le statut new par défaut.\n\n**Configuration et achat du panier côté serveur**\n\nCette approche peut nécessiter davantage de temps pour configurer le panier, car chaque modification doit être effectuée via des appels API.\n\nImplémentez la logique suivante pour le panier :\n1. Après que le joueur a rempli un panier, utilisez l'appel API [Remplir le panier d'objets](/fr/api/catalog/cart-server-side). L'appel renvoie les informations à jour sur les objets sélectionnés (prix avant et après remises, objets bonus).\n2. Utilisez l'appel API [Créer une commande à partir de tous les objets du panier actuel](/fr/api/shop-builder/operation/create-order/). L'appel renvoie l'ID de commande et le jeton de paiement. La commande nouvellement créée est définie sur le statut new par défaut.\n\n## Ouverture de l'interface de paiement\n\nUtilisez le jeton renvoyé pour ouvrir l'interface de paiement dans une nouvelle fenêtre. D'autres méthodes d'ouverture de l'interface de paiement sont décrites dans la [documentation](/fr/payment-ui-and-flow/payment-ui/how-to-open-payment-ui/#open_payment_ui).\n\n| Action | Endpoint |\n|:--------------------------------|:--------------------------------------------------------------------------|\n| Ouverture dans l'environnement de production. | https://secure.xsolla.com/paystation4/?token={token} |\n| Ouverture en mode bac à sable. | https://sandbox-secure.xsolla.com/paystation4/?token={token} |\n\n\n
Note\n Utilisez le mode bac à sable pendant le développement et les tests. Les achats de test n'entraînent aucun débit sur des comptes réels. Vous pouvez utiliser des
cartes bancaires de test.\n\n Après le premier paiement réel, une politique stricte du mode bac à sable s'applique. Les paiements en mode bac à sable sont disponibles uniquement pour les utilisateurs spécifiés dans la section [Company settings > Users](https://publisher.xsolla.com/0/settings/users) du Compte éditeur.\n\n L'achat de monnaie virtuelle et d'objets en devise réelle n'est possible qu'après la signature d'un contrat de licence avec Xsolla. Pour cela, dans le [Compte éditeur](https://publisher.xsolla.com/), accédez à **Agreements & Taxes > Agreements**, complétez le formulaire et attendez la validation. Le traitement du contrat peut prendre jusqu'à 3 jours ouvrés.\n