# Shop Builder API # Overview * **Version:** 2.0.0 * **Servers**: `https://store.xsolla.com/api` * **[Contact Us by Email](mailto:integration@xsolla.com)** * **Contact URL:** https://xsolla.com/ * **Required TLS version:** 1.2 Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForCart Lors de la vente d'un panier contenant des jeux, vous pouvez [appeler l'endpoint sans autorisation](/fr/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). Pour ce faire: * Ajoutez un identifiant unique au paramètre `x-unauthorized-id` dans l'en-tête pour les jeux. * Ajoutez l'adresse e-mail de l'utilisateur au paramètre `x-user` (encodé en Base64) dans l'en-tête des jeux. Par défaut, JWT utilisateur Xsolla Login (jeton Bearer) est utilisé pour l'autorisation. Vous pouvez essayer d'appeler cet endpoint avec un JWT utilisateur Xsolla Login de test: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Vous pouvez également utiliser le [jeton d'accès Pay Station](https://developers.xsolla.com/fr/api/pay-station/operation/create-token/). Type: http Scheme: bearer ### XsollaLoginUserJWT Par défaut, JWT utilisateur Xsolla Login (jeton Bearer) est utilisé pour l'autorisation. Vous pouvez essayer d'appeler cet endpoint avec un JWT utilisateur Xsolla Login de test : `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Vous pouvez également utiliser le [jeton d'accès Pay Station](https://developers.xsolla.com/fr/api/pay-station/operation/create-token/). Type: http Scheme: bearer Bearer Format: JWT ### basicAuth L'API de Xsolla utilise une authentification d'accès de base. Toutes les requêtes à l'API doivent contenir l'en-tête `Authorization: Basic `, où `your_authorization_basic_key` est la paire `project_id:api_key` encodée en Base64. Vous pouvez utiliser `merchant_id` au lieu de `project_id` si nécessaire. Cela n'affecte pas la fonctionnalité. Accédez au [Compte éditeur](https://publisher.xsolla.com/) pour trouver les valeurs des paramètres : * `merchant_id` s'affiche : * Dans la section **Company settings > Company** ; * Dans l'URL dans la barre d'adresse du navigateur sur n'importe quelle page du Compte éditeur. L'URL présente le format suivant : `https://publisher.xsolla.com/`. * `api_key` apparaît dans le Compte éditeur une seule fois lors de sa création. Elle doit être conservée de votre côté. Vous pouvez créer une nouvelle clé dans la section suivante : * **Company settings > API keys** ; * **Project settings > API keys**. * `project_id` s'affiche : * Dans le Compte éditeur, à côté du nom du projet ; * Dans l'URL dans la barre d'adresse du navigateur lorsque vous travaillez sur un projet dans le Compte éditeur. L'URL présente le format suivant : `https://publisher.xsolla.com//projets/`. Pour plus d'informations sur l'utilisation des clés API, voir la [référence API](https://developers.xsolla.com/fr/api/getting-started/#api_keys_overview). Type: http Scheme: basic ### basicMerchantAuth L'API de Xsolla utilise une authentification d'accès de base. Toutes les requêtes à l'API doivent contenir l'en-tête `Authorization: Basic `, où `your_authorization_basic_key` est la paire `merchant_id:api_key` encodée en Base64. Accédez au [Compte éditeur](https://publisher.xsolla.com/) pour trouver les valeurs des paramètres : * `merchant_id` s'affiche : * Dans la section **Company settings > Company** ; * Dans l'URL dans la barre d'adresse du navigateur sur n'importe quelle page du Compte éditeur. L'URL présente le format suivant : `https://publisher.xsolla.com/`. * `api_key` apparaît dans le Compte éditeur une seule fois lors de sa création. Elle doit être conservée de votre côté. Vous pouvez créer une nouvelle clé dans la section suivante : * **Company settings > API keys** ; * **Project settings > API keys**. Pour plus d'informations sur l'utilisation des clés API, voir la [référence API](https://developers.xsolla.com/fr/api/getting-started/#api_keys_overview). Type: http Scheme: basic ## Download OpenAPI description [Shop Builder API](https://developers.xsolla.com/_bundle/@l10n/fr/api/shop-builder/index.yaml) ## Administrateur ### Lire la liste des attributs (administrateur) - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/fr/api/shop-builder/attribute-admin/admin-get-attribute-list.md): Récupère la liste des attributs au sein d'un projet à des fins d'administration. ### Créer un attribut - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/fr/api/shop-builder/attribute-admin/admin-create-attribute.md): Crée un attribut. ### Supprimer un attribut - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/attribute-admin/delete-attribute.md): Supprime un attribut. NoteSi vous supprimez un attribut de bien, toutes ses données et connexions avec les objets seront perdues. ### Lire un attribut spécifique - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/attribute-admin/admin-get-attribute.md): Récupère des informations sur un attribut spécifique. ### Mettre à jour un attribut - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/attribute-admin/admin-update-attribute.md): Met à jour un attribut. ### Supprimer toutes les valeurs d'un attribut - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/fr/api/shop-builder/attribute-admin/admin-delete-all-attribute-value.md): Supprime toutes les valeurs de l'attribut. NoteSi vous supprimez la valeur d'un attribut, toutes les connexions entre cet attribut et les objets seront perdues. Pour modifier la valeur de l'attribut de bien, utilisez l'appel API Mettre à jour une valeur d'attribut au lieu de supprimer la valeur et d'en créer une nouvelle. ### Créer une valeur d'attribut - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/fr/api/shop-builder/attribute-admin/admin-create-attribute-value.md): Crée une valeur d'attribut. AttentionTous les projets sont soumis à une limite du nombre de valeurs d'attribut. La valeur par défaut et la valeur maximale sont de 20 valeurs par attribut. ### Supprimer une valeur d'attribut - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/fr/api/shop-builder/attribute-admin/admin-delete-attribute-value.md): Supprime une valeur de l'attribut. NoteSi vous supprimez la valeur d'un attribut, toutes les connexions entre cet attribut et les objets seront perdues. Pour modifier la valeur de l'attribut de bien, utilisez l'appel API Mettre à jour une valeur d'attribut au lieu de supprimer la valeur et d'en créer une nouvelle. ### Mettre à jour une valeur d'attribut - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/fr/api/shop-builder/attribute-admin/admin-update-attribute-value.md): Met à jour les valeurs d'un attribut. ## Catalogue personnalisé Cette API permet de spécifier des règles pour les attributs utilisateur. Si l'utilisateur remplit toutes les conditions d'une règle concrète, des objets personnalisés seront affichés. Pour les promotions personnalisées, voir la [section Promotions](/fr/api/shop-builder/tag/promotions-discounts). Pour passer des attributs avant un achat, utilisez [Xsolla Login API](/fr/api/login/operation/update-users-attributes-from-server/) ou passez-les dans la propriété [user.attributes lors de la génération du jeton à l'aide de Pay Station API](/fr/api/pay-station/operation/create-token). ### Lire la liste des règles de filtrage du catalogue - [GET /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/fr/api/shop-builder/personalized-catalog/get-filter-rules.md): Récupère toutes les règles s'appliquant aux attributs utilisateur. ### Créer une règle de filtrage du catalogue - [POST /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/fr/api/shop-builder/personalized-catalog/create-filter-rule.md): Crée une règle pour les attributs utilisateur. ### Lire toutes les règles du catalogue pour une recherche côté client - [GET /v2/project/{project_id}/admin/user/attribute/rule/all](https://developers.xsolla.com/fr/api/shop-builder/personalized-catalog/get-all-filter-rules.md): Récupère une liste de toutes les règles du catalogue pour la recherche côté client. AttentionRenvoie uniquement l'ID et le nom de la règle et is_enabled ### Supprimer une règle de filtrage du catalogue - [DELETE /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/fr/api/shop-builder/personalized-catalog/delete-filter-rule-by-id.md): Supprime une règle spécifique. ### Lire une règle de filtrage du catalogue - [GET /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/fr/api/shop-builder/personalized-catalog/get-filter-rule-by-id.md): Récupère des informations sur une règle spécifique s'appliquant aux attributs utilisateur. ### Appliquer une règle de filtrage de catalogue - [PATCH /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/fr/api/shop-builder/personalized-catalog/patch-filter-rule-by-id.md): Met à jour une règle spécifique s'appliquant aux attributs utilisateur. La valeur actuelle sera utilisée pour une propriété non spécifiée. ### Mettre à jour une règle de filtrage du catalogue - [PUT /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/fr/api/shop-builder/personalized-catalog/update-filter-rule-by-id.md): Met à jour une règle spécifique s'appliquant aux attributs utilisateur. La valeur par défaut sera utilisée pour une propriété non spécifiée (si la propriété n'est pas requise). ## Administrateur ### Lire une liste de lots - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/fr/api/shop-builder/bundles-admin/admin-get-bundle-list.md): Récupère la liste des lots au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Créer un lot - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/fr/api/shop-builder/bundles-admin/admin-create-bundle.md): Crée un lot. ### Lire la liste des lots par external ID d'un groupe spécifique - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): Récupère la liste des lots au sein d'un groupe à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Lire la liste des lots par ID d'un groupe spécifique - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/fr/api/shop-builder/bundles-admin/admin-get-bundle-list-in-group-by-id.md): Récupère la liste des lots au sein d'un groupe à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Supprimer un lot - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/fr/api/shop-builder/bundles-admin/admin-delete-bundle.md): Supprime un lot. ### Lire un lot - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/fr/api/shop-builder/bundles-admin/admin-get-bundle.md): Récupère des informations sur un lot au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour un lot - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/fr/api/shop-builder/bundles-admin/admin-update-bundle.md): Met à jour un lot. ### Masquer un lot dans le catalogue - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/fr/api/shop-builder/bundles-admin/admin-hide-bundle.md): Masque un lot dans un catalogue. ### Afficher un lot dans le catalogue - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/fr/api/shop-builder/bundles-admin/admin-show-bundle.md): Affiche un lot dans un catalogue. ## Catalogue ### Lire une liste de lots - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/fr/api/shop-builder/bundles-catalog/get-bundle-list.md): Récupère une liste de lots pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et maximale est de 50 objets par réponse. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une liste de lots par groupe spécifique - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/bundles-catalog/get-bundle-list-in-group.md): Récupère une liste de lots dans un groupe pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et maximale est de 50 objets par réponse. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire un lot spécifique - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/fr/api/shop-builder/bundles-catalog/get-bundle.md): Récupère des informations sur un lot spécifique. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ## Panier (côté client) ### Lire le panier de l'utilisateur actuel - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/fr/api/shop-builder/cart-client-side/get-user-cart.md): Renvoie le panier de l'utilisateur actuel. ### Supprimer tous les objets du panier actuel - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/fr/api/shop-builder/cart-client-side/cart-clear.md): Supprime tous les objets du panier. ### Remplir le panier d'objets - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/fr/api/shop-builder/cart-client-side/cart-fill.md): Remplit d'objets le panier. Si le panier contient déjà un objet avec la même UGS, l'objet existant sera remplacé par la valeur passée. ### Supprimer un objet du panier actuel - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/cart-client-side/delete-item.md): Supprime un objet du panier. ### Mettre à jour un objet du panier actuel - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/cart-client-side/put-item.md): Met à jour un objet de panier existant ou en crée un nouveau dans le panier. ### Lire le panier par ID de panier - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/fr/api/shop-builder/cart-client-side/get-cart-by-id.md): Renvoie le panier de l'utilisateur par son ID de panier. ### Supprimer tous les objets du panier par ID de panier - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/fr/api/shop-builder/cart-client-side/cart-clear-by-id.md): Supprime tous les objets du panier. ### Remplir un panier spécifique d'objets - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/fr/api/shop-builder/cart-client-side/cart-fill-by-id.md): Remplit d'objets un panier spécifique. Si le panier contient déjà un objet avec la même UGS, l'objet existant sera remplacé par la valeur passée. ### Supprimer un objet du panier par ID de panier - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/cart-client-side/delete-item-by-cart-id.md): Supprime un objet du panier. ### Mettre à jour un objet du panier par ID de panier - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/cart-client-side/put-item-by-cart-id.md): Met à jour un objet de panier existant ou en crée un nouveau dans le panier. ## Panier (côté serveur) ### Remplir le panier d'objets - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/fr/api/shop-builder/cart-server-side/admin-cart-fill.md): Remplit d'objets le panier actuel. Si le panier contient déjà un objet avec la même UGS, l'objet existant sera remplacé par la valeur passée. ### Remplir le panier d'objets par ID de panier - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/fr/api/shop-builder/cart-server-side/admin-fill-cart-by-id.md): Remplit d'objets le panier par son ID. Si le panier contient déjà un objet avec la même UGS, l'objet existant sera remplacé par la valeur passée. ## Paiement (côté client) ### Créer une commande à partir de tous les objets du panier actuel - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/fr/api/shop-builder/payment-client-side/create-order.md): Utilisé pour l'intégration client-serveur. Crée une commande à partir de tous les objets du panier et génère un jeton de paiement pour cette commande. La commande créée aura le statut new. L'adresse IP du client est utilisée pour déterminer le pays de l'utilisateur, qui est ensuite utilisé pour appliquer la devise appropriée et les modes de paiement disponibles pour la commande. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Remarque Étant donné que cette méthode se base sur l'adresse IP pour déterminer le pays de l'utilisateur et sélectionner la devise de la commande, il est important de l'utiliser exclusivement côté client et non côté serveur. L'utilisation de cette méthode côté serveur pourrait entraîner une détermination incorrecte de la devise, ce qui pourrait affecter les modes de paiement dans Pay Station. ### Créer une commande à partir de tous les objets d'un panier spécifique - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/fr/api/shop-builder/payment-client-side/create-order-by-cart-id.md): Utilisé pour l'intégration client-serveur. Crée une commande à partir de tous les objets d'un panier spécifique et génère un jeton de paiement pour cette commande. La commande créée aura le statut new. L'adresse IP du client est utilisée pour déterminer le pays de l'utilisateur, qui est ensuite utilisé pour appliquer la devise appropriée et les modes de paiement disponibles pour la commande. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Remarque Étant donné que cette méthode se base sur l'adresse IP pour déterminer le pays de l'utilisateur et sélectionner la devise de la commande, il est important de l'utiliser exclusivement côté client et non côté serveur. L'utilisation de cette méthode côté serveur pourrait entraîner une détermination incorrecte de la devise, ce qui pourrait affecter les modes de paiement dans Pay Station. ### Créer une commande à partir d'un objet spécifique - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/payment-client-side/create-order-with-item.md): Utilisé pour l'intégration client-serveur. Crée une commande à partir d'un objet spécifique et génère un jeton de paiement pour cette commande. La commande créée aura le statut new. L'adresse IP du client est utilisée pour déterminer le pays de l'utilisateur, qui est ensuite utilisé pour appliquer la devise appropriée et les modes de paiement disponibles pour la commande. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Remarque Étant donné que cette méthode se base sur l'adresse IP pour déterminer le pays de l'utilisateur et sélectionner la devise de la commande, il est important de l'utiliser exclusivement côté client et non côté serveur. L'utilisation de cette méthode côté serveur pourrait entraîner une détermination incorrecte de la devise, ce qui pourrait affecter les modes de paiement dans Pay Station. ### Créer une commande pour une étape payante de la chaîne d'offres - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/fr/api/shop-builder/payment-client-side/order-user-offer-chain-step-reward.md): Crée une commande pour l'objet associé à une étape payante spécifique de la chaîne d'offres. La commande créée obtient le statut new. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Attention Cette méthode doit être utilisée côté client. L'adresse IP de l'utilisateur permet de déterminer son pays, ce qui influence la devise et les modes de paiement disponibles. Utiliser cette méthode côté serveur peut entraîner une détection incorrecte de la devise et affecter les modes de paiement dans Pay Station. Attention Utilisez cet appel uniquement pour les étapes payantes de la chaîne d'offres. Pour les étapes gratuites, utilisez plutôt l'appel Réclamer une étape de chaîne d'offres gratuite. ### Créer une commande pour une étape payante de la chaîne d'offres - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-client/order-user-offer-chain-step-reward.md): Crée une commande pour l'objet associé à une étape payante spécifique de la chaîne d'offres. La commande créée obtient le statut new. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Attention Cette méthode doit être utilisée côté client. L'adresse IP de l'utilisateur permet de déterminer son pays, ce qui influence la devise et les modes de paiement disponibles. Utiliser cette méthode côté serveur peut entraîner une détection incorrecte de la devise et affecter les modes de paiement dans Pay Station. Attention Utilisez cet appel uniquement pour les étapes payantes de la chaîne d'offres. Pour les étapes gratuites, utilisez plutôt l'appel Réclamer une étape de chaîne d'offres gratuite. ## Client ### Créer une commande pour une étape payante de la chaîne d'offres - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/fr/api/shop-builder/payment-client-side/order-user-offer-chain-step-reward.md): Crée une commande pour l'objet associé à une étape payante spécifique de la chaîne d'offres. La commande créée obtient le statut new. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Attention Cette méthode doit être utilisée côté client. L'adresse IP de l'utilisateur permet de déterminer son pays, ce qui influence la devise et les modes de paiement disponibles. Utiliser cette méthode côté serveur peut entraîner une détection incorrecte de la devise et affecter les modes de paiement dans Pay Station. Attention Utilisez cet appel uniquement pour les étapes payantes de la chaîne d'offres. Pour les étapes gratuites, utilisez plutôt l'appel Réclamer une étape de chaîne d'offres gratuite. ### Lire les chaînes d'offres de l'utilisateur actuel - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-client/get-offer-chains-list.md): Récupère les chaînes d'offres de l'utilisateur actuel. AttentionTous les projets sont soumis a une limite de nombre d'objets pouvant être renvoyés dans une seule réponse. La valeur par défaut et la valeur maximale sont de 30 objets par réponse. Pour obtenir plus de données, utilisez les paramètres de requête limit et offset pour la pagination. ### Lire une chaîne d'offres de l'utilisateur actuel par ID - [GET /v2/project/{project_id}/user/offer_chain/{offer_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-client/get-user-offer-chain-by-id.md): Récupère la chaîne d'offres de l'utilisateur actuel par l'ID de la chaîne d'offres. ### Réclamer une étape de chaîne d'offres gratuite - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-client/claim-user-offer-chain-step-reward.md): Termine la progression de l'utilisateur actuel dans l'étape de la chaîne d'offres et attribue la récompense associée. Attention Utilisez cet appel uniquement pour les étapes gratuites de la chaîne d’offres. Pour les étapes nécessitant un paiement en devises réelles, utilisez plutôt l'appel Créer une commande pour une étape payante de la chaîne d'offres. ### Créer une commande pour une étape payante de la chaîne d'offres - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-client/order-user-offer-chain-step-reward.md): Crée une commande pour l'objet associé à une étape payante spécifique de la chaîne d'offres. La commande créée obtient le statut new. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Attention Cette méthode doit être utilisée côté client. L'adresse IP de l'utilisateur permet de déterminer son pays, ce qui influence la devise et les modes de paiement disponibles. Utiliser cette méthode côté serveur peut entraîner une détection incorrecte de la devise et affecter les modes de paiement dans Pay Station. Attention Utilisez cet appel uniquement pour les étapes payantes de la chaîne d'offres. Pour les étapes gratuites, utilisez plutôt l'appel Réclamer une étape de chaîne d'offres gratuite. ## Paiement (côté serveur) ### Créer un jeton de paiement pour un achat - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/fr/api/shop-builder/payment-server-side/admin-create-payment-token.md): Génère une commande et un jeton de paiement pour celle-ci. La commande est générée sur la base des objets passés dans le corps de la requête. Pour ouvrir l'interface de paiement dans une nouvelle fenêtre, utilisez le lien suivant : https://secure.xsolla.com/paystation4/?token={token}, où {token} est le jeton reçu. À des fins de test, utilisez cette URL : https://sandbox-secure.xsolla.com/paystation4/?token={token}. Remarque Le paramètre user.country.value est utilisé pour sélectionner une devise pour la commande. Si le pays de l'utilisateur est inconnu, fournir l'adresse IP de l'utilisateur dans l'en-tête X-User-Ip est une option alternative. L'une de ces deux options est nécessaire au bon fonctionnement de cette méthode. La devise sélectionnée est utilisée pour les méthodes de paiement sur Pay Station. ## Commande ### Lire une commande - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/fr/api/shop-builder/order/get-order.md): Récupère des informations sur une commande spécifique. ### Lire la liste des commandes pour la période spécifiée - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/fr/api/shop-builder/order/admin-order-search.md): Récupère la liste des commandes, triées par date de création dans un ordre croissant. ## Biens gratuits ### Créer une commande à partir d'un panier gratuit - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/fr/api/shop-builder/free-item/create-free-order.md): Crée une commande à partir de tous les objets d'un panier gratuit. La commande créée aura le statut done. ### Créer une commande à partir d'un panier gratuit spécifique - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/fr/api/shop-builder/free-item/create-free-order-by-cart-id.md): Crée une commande à partir de tous les biens d'un panier gratuit spécifique. La commande créée aura le statut done. ### Créer une commande à partir d'un bien gratuit spécifique - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/free-item/create-free-order-with-item.md): Crée une commande à partir d'un bien gratuit spécifique. La commande créée aura le statut done. ## Webhooks ### Lire les informations sur les paramètres du webhook - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/fr/api/shop-builder/common-webhooks/get-webhook.md): Récupère les informations sur les paramètres du webhook dans Store. Consultez la documentation sur les webhooks pour en savoir plus. ### Mettre à jour les informations sur les paramètres du webhook - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/fr/api/shop-builder/common-webhooks/update-webhook.md): Récupère les informations sur les paramètres du webhook dans Store. Consultez la documentation sur les webhooks pour en savoir plus. ## Pré-commandes ### Supprimer une quantité de la limite de pré-commande pour un objet - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/common-pre-orders/remove-pre-order-limit.md): Supprime une quantité de la limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section Administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Lire des informations sur la limite de pré-commande d'un objet - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/common-pre-orders/get-pre-order-limit.md): Récupère des information sur la limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section Administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Ajouter une quantité à la limite de pré-commande pour un objet - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/common-pre-orders/add-pre-order-limit.md): Ajoute une quantité à la limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section Administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Définir une quantité de la limite de pré-commande pour un objet - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/common-pre-orders/set-pre-order-limit.md): Définit une quantité de limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section Administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Supprimer toute la quantité de la limite de pré-commande pour un objet - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/fr/api/shop-builder/common-pre-orders/remove-all-pre-order-limit.md): Supprime toute la quantité de limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Basculer la limite de pré-commande pour un objet - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/fr/api/shop-builder/common-pre-orders/toggle-pre-order-limit.md): Active/désactive la limite de pré-commande pour un objet. L'API des limites de précommande vous permet de vendre un objet en quantité limitée. Pour configurer la pré-commande, accédez à la section administrateur du module de l'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots Alias pour cet endpoint : * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ## Commerçant ### Lire les projets - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/fr/api/shop-builder/common-merchant/get-projects.md): Récupère la liste des projets du commerçant. RemarqueCet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour configurer l'autorisation. ## Catalogue Cette API permet de récupérer tout type d'objet vendable ou tout objet spécifique. ### Lire une liste d'objets vendables - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/fr/api/shop-builder/common-catalog/get-sellable-items.md): Récupère une liste d'objets vendables pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une liste d'objets vendables par groupe spécifique - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/common-catalog/get-sellable-items-group.md): Récupère une liste d'objets vendables à partir d'un groupe spécifié pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire un objet vendable par ID - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/fr/api/shop-builder/common-catalog/get-sellable-item-by-id.md): Récupère des informations sur un objet vendable par son ID. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ### Lire un objet vendable par UGS - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/fr/api/shop-builder/common-catalog/get-sellable-item-by-sku.md): Récupère des informations sur un objet vendable par son UGS pour la constitution d'un catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ## Régions communes ### Lire la liste des régions - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/fr/api/shop-builder/common-regions/admin-get-regions.md): Récupère la liste des régions. Utilisez les régions pour gérer les restrictions régionales. ### Créer une région - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/fr/api/shop-builder/common-regions/admin-create-region.md): Crée une région. Utilisez les régions pour gérer les restrictions régionales. ### Supprimer une région - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/fr/api/shop-builder/common-regions/admin-delete-region.md): Supprime une région spécifique. ### Lire une région - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/fr/api/shop-builder/common-regions/admin-get-region.md): Récupère des informations sur une région spécifique. Utilisez les régions pour gérer les restrictions régionales. ### Mettre à jour une région - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/fr/api/shop-builder/common-regions/admin-update-region.md): Met à jour les informations sur une région spécifique. Utilisez les régions pour gérer les restrictions régionales. ## Catalogue ### Lire une liste de jeux - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/fr/api/shop-builder/game-keys-catalog/get-games-list.md): Récupère une liste de jeux pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire la liste des DRM - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/fr/api/shop-builder/game-keys-catalog/get-drm-list.md): Récupère la liste des DRM disponibles. ### Lire une liste de jeux par groupe spécifique - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-catalog/get-games-group.md): Récupère une liste de jeux à partir d'un groupe spécifié pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une liste de clés de jeu par groupe spécifique - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-catalog/get-game-keys-group.md): Récupère une liste de clés de jeu à partir d'un groupe spécifié pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une clé de jeu pour le catalogue - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-catalog/get-game-key-by-sku.md): Récupère des informations sur une clé de jeu pour le catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ### Lire un jeu pour le catalogue - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-catalog/get-game-by-sku.md): Récupère des informations sur un jeu pour le catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ## Droit ### Accorder un droit (administrateur) - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/fr/api/shop-builder/game-keys-entitlement/grant-entitlement-admin.md): Accorde un droit à l'utilisateur. AttentionSeuls les codes de jeu ou les jeux pour une plateforme sans DRM peuvent être accordés. ### Révoquer un droit (administrateur) - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/fr/api/shop-builder/game-keys-entitlement/revoke-entitlement-admin.md): Retire les droits à l'utilisateur. AttentionSeuls les codes de jeu ou les jeux pour une plateforme sans DRM peuvent être retirés. ### Lire la liste des jeux qu'un utilisateur détient - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/fr/api/shop-builder/game-keys-entitlement/get-user-games.md): Récupère la liste des jeux que l'utilisateur détient. La réponse contiendra un tableau de jeux qu'un utilisateur spécifique détient. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 10 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. ### Échanger un code de jeu côté client - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/fr/api/shop-builder/game-keys-entitlement/redeem-game-pin-code.md): Accorde le droit associé au code de jeu fourni. AttentionSeuls les codes pour une plateforme sans DRM peuvent être échangés. ## Administrateur ### Lire la liste des jeux (administrateur) - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-get-game-list.md): Récupère la liste des jeux au sein d'un projet à des fins d'administration. Le jeu consiste en des clés de jeu qui peuvent être achetées par un utilisateur. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Créer un jeu - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-create-game.md): Crée un jeu dans le projet. ### Supprimer un jeu par ID - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-delete-game-by-id.md): Supprime un jeu du projet par son ID. ### Lire un jeu par ID (administrateur) - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-get-game-by-id.md): Récupère des informations sur un jeu au sein d'un projet à des fins d'administration. Le jeu consiste en des clés de jeu qui peuvent être achetées par un utilisateur. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour un jeu par ID - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-update-game-by-id.md): Met à jour les informations d'un jeu dans le projet par son ID. ### Supprimer des codes par ID - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-delete-codes-by-id.md): Supprime tous les codes par ID de clé de jeu. ### Supprimer les codes - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-delete-codes-by-sku.md): Supprime tous les codes par UGS de clé de jeu. ### Lire des codes par ID - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-get-codes-by-id.md): Récupère un certain nombre de codes par ID de clé de jeu. ### Lire des codes - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-get-codes-by-sku.md): Récupère un certain nombre de codes par UGS de clé de jeu. ### Télécharger des codes par ID - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-upload-codes-by-id.md): Télécharge des codes par ID de clé de jeu. ### Lire des informations sur la session de chargement des codes - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-get-codes-session.md): Récupère des informations sur la session de chargement des codes. ### Télécharger des codes - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-upload-codes-by-sku.md): Télécharge des codes par UGS de clé de jeu. ### Supprimer un jeu par UGS - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-delete-game-by-sku.md): Supprime un jeu dans le projet par UGS. ### Lire un jeu (administrateur) - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-get-game-by-sku.md): Récupère des informations sur un jeu au sein d'un projet à des fins d'administration. Le jeu consiste en des clés de jeu qui peuvent être achetées par un utilisateur. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour un jeu par UGS - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/game-keys-admin/admin-update-game-by-sku.md): Met à jour les informations d'un jeu dans le projet par UGS. ## Communs ### Activer une promotion - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/fr/api/shop-builder/promotions-common/activate-promotion.md): Active une promotion. ### Désactiver une promotion - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/deactivate](https://developers.xsolla.com/fr/api/shop-builder/promotions-common/deactivate-promotion.md): Désactive une promotion. ### Vérifier un code promotionnel - [GET /v2/project/{project_id}/promotion/code/{code}/verify](https://developers.xsolla.com/fr/api/shop-builder/promotions-common/verify-promotion-code.md): Détermine si le code est un code promo ou un code de coupon et si l'utilisateur peut l'appliquer. ### Lire la liste de toutes les promotions - [GET /v3/project/{project_id}/admin/promotion](https://developers.xsolla.com/fr/api/shop-builder/promotions-common/get-promotion-list.md): Récupère la liste des promotions d'un projet. ### Lire une promotion utilisable par code - [GET /v3/project/{project_id}/admin/promotion/redeemable/code/{code}](https://developers.xsolla.com/fr/api/shop-builder/promotions-common/get-redeemable-promotion-by-code.md): Récupère des informations sur la promotion par un code promo ou un code de coupon. ## Coupons Cette API permet de gérer les coupons. ### Lire les limites pour les code de coupon uniques - [GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/get-coupon-code-limit.md): Récupère le nombre restant de fois que les codes peuvent être utilisés. Pour filtrer les codes, utilisez le paramètre de requête codes. Pour configurer la limite de codes elle-même, accédez à la section Administrateur : * Codes promo ### Activer une promotion par coupon - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/activate-coupon.md): Active une promotion par coupon. Par défaut, une promotion par coupon créée est désactivée. Pour permettre l'échange de coupons, vous devez l'activer. Utilisez cet endpoint pour activer une promotion par coupon. ### Lire les codes de coupon - [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/get-coupon-codes.md): Récupère les codes de coupon. ### Créer un code de coupon - [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/create-coupon-code.md): Crée un code de coupon. ### Générer des codes de coupon - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/generate-coupon-codes.md): Génère des codes de coupon. ### Désactiver une promotion par coupon - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/deactivate-coupon.md): Désactive une promotion par coupon. Par défaut, une promotion par coupon créée est désactivée. Pour permettre l'échange de coupons, vous devez l'activer. Utilisez cet endpoint pour désactiver une promotion par coupon. ### Lire la limite de coupon pour un utilisateur spécifique - [GET /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/get-coupon-user-limit.md): Récupère le nombre restant de fois qu'un utilisateur spécifique peut utiliser le coupon. L'API des limites utilisateur vous permet de limiter le nombre de fois que les utilisateurs peuvent utiliser un coupon. Pour configurer les limites utilisateur, référez-vous à la section Administrateur : * Coupons ### Lire les récompenses d'un coupon - [GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/get-coupon-rewards-by-code.md): Récupère les récompenses associées au coupon par son code. Peut être utilisé pour permettre aux utilisateurs de choisir l'un des nombreux objets proposés comme bonus. Le cas habituel est le choix d'un DRM si le coupon contient un jeu comme bonus (type=unit). ### Échanger un code de coupon - [POST /v2/project/{project_id}/coupon/redeem](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/redeem-coupon.md): Échange un code de coupon. L'utilisateur reçoit un bonus après l'échange. ### Lire la liste des promotions par coupon - [GET /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/get-coupons.md): Récupère la liste des promotions par coupon d'un projet. ### Créer une promotion par coupon - [POST /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/admin-create-coupon.md): Crée une promotion par coupon. ### Supprimer une promotion par coupon - [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/delete-coupon-promotion.md): Supprime la promotion par coupon. Les conséquences suivantes s'en suivent : * La promotion disparaît de la liste des promotions configurées dans votre projet ; * Elle n'est plus appliquée au catalogue des objets. L'utilisateur ne peut plus obtenir d'objets bonus à travers cette promotion. Après la suppression, la promotion ne peut pas être restaurée. Les coupons de la promotion supprimée peuvent être ajoutés à des promotions existantes. ### Lire une promotion par coupon - [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/get-coupon.md): Récupère des informations sur une promotion par coupon spécifique. ### Mettre à jour une promotion par coupon - [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-coupons/update-coupon-promotion.md): Met à jour une promotion par coupon ## Codes promo Cette API permet de gérer les codes promo. ### Lire les limites pour les codes promo - [GET /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/get-promo-code-code-limit.md): Récupère le nombre restant de fois que les codes peuvent être utilisés. Pour filtrer les codes, utilisez le paramètre de requête codes. Pour configurer la limite de codes elle-même, accédez à la section Administrateur : * Codes promo ### Activer une promotion par code promo - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/activate](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/activate-promo-code.md): Active une promotion par code promo. Par défaut, une promotion par code promo créée est désactivée. Pour permettre l'échange de coupons, vous devez l'activer. Utilisez cet endpoint pour activer une promotion par code promo. ### Lire les codes d'une promotion par code promo - [GET /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/get-promocode-codes.md): Récupère les codes d'une promotion par code promo. ### Créer un code pour une promotion par code promo - [POST /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/create-promo-code-code.md): Crée un code pour une promotion par code promo. ### Générer des codes pour une promotion par code promo - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/code/generate](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/generate-promo-code-codes.md): Génère des codes pour une promotion par code promo. ### Désactiver une promotion par code promo - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/deactivate](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/deactivate-promo-code.md): Désactive une promotion par code promo. Par défaut, une promotion par code promo créée est désactivée. Pour permettre l'échange de coupons, vous devez l'activer. Utilisez cet endpoint pour désactiver une promotion par code promo. ### Lire la limite de code promo pour un utilisateur spécifique - [GET /v2/project/{project_id}/admin/user/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/get-promo-code-user-limit.md): Récupère le nombre de fois restant qu'un utilisateur spécifique peut utiliser le code promo. L'API des limites utilisateur vous permet de limiter le nombre de fois que les utilisateurs peuvent utiliser un code promo. Pour configurer les limites utilisateur, référez-vous à la section Administrateur : * Codes promo ### Lire les récompenses d'un code promo - [GET /v2/project/{project_id}/promocode/code/{promocode_code}/rewards](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/get-promo-code-rewards-by-code.md): Récupère les récompenses associées au code promo par son code. Peut être utilisé pour permettre aux utilisateurs de choisir l'un des nombreux objets proposés comme bonus. Le cas habituel est le choix d'un DRM si le code promo contient un jeu comme bonus (type=unit). ### Échanger un code promo - [POST /v2/project/{project_id}/promocode/redeem](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/redeem-promo-code.md): Échange un code d'une promotion par code promo. Après avoir échangé un code de promo, l'utilisateur reçoit des biens gratuits et/ou le prix du panier et/ou des objets spécifiques sera réduit. ### Supprimer un code promo du panier - [PUT /v2/project/{project_id}/promocode/remove](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/remove-cart-promo-code.md): Supprime un code promo d'un panier. Après la suppression du code promo, le prix total de tous les objets du panier sera recalculé sans les bonus et les remises accordés par un code promo. ### Lire la liste des promotions par code promo - [GET /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/get-promo-codes.md): Récupère la liste des codes promo d'un projet. ### Créer une promotion par code promo - [POST /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/create-promo-code.md): Crée une promotion par code promo. ### Supprimer une promotion par code promo - [DELETE /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/delete-promo-code.md): Supprime la promotion par code promo. Les conséquences suivantes s'en suivent : * La promotion disparaît de la liste des promotions configurées dans votre projet ; * Elle n'est plus appliquée au catalogue des objets ni au panier. L'utilisateur ne peut plus obtenir d'objets bonus ou acheter des objets à travers cette promotion. Après la suppression, la promotion ne peut pas être restaurée. Les codes promo de la promotion supprimée peuvent être ajoutés à des promotions existantes. ### Lire une promotion par code promo - [GET /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/get-promo-code.md): Récupère des informations sur une promotion par code promo spécifique. ### Mettre à jour une promotion par code promo - [PUT /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-promo-codes/update-promo-code.md): Met à jour une promotion par code promo. ## Offres uniques du catalogue Cette API permet de gérer les offres uniques du catalogue. ### Activer une offre promotionnelle unique du catalogue - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/activate](https://developers.xsolla.com/fr/api/shop-builder/promotions-unique-catalog-offers/activate-unique-catalog-offer.md): Active une offre promotionnelle unique du catalogue. Une offre promotionnelle unique créée dans le catalogue est désactivée par défaut. Elle ne peut pas être utilisée tant que vous ne l'avez pas activée. Utilisez cet endpoint pour activer une promotion par coupon. ### Lire les codes d'une offre unique du catalogue - [GET /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/fr/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offer-codes.md): Récupère les codes d'une offre unique du catalogue. ### Créer un code pour une offre unique du catalogue - [POST /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/fr/api/shop-builder/promotions-unique-catalog-offers/create-unique-catalog-offer-code.md): Crée un code pour une offre unique du catalogue ### Générer des codes pour une offre unique du catalogue - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code/generate](https://developers.xsolla.com/fr/api/shop-builder/promotions-unique-catalog-offers/generate-unique-catalog-offer-codes.md): Génère des codes pour une offre unique du catalogue. ### Désactiver une offre promotionnelle unique du catalogue - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/deactivate](https://developers.xsolla.com/fr/api/shop-builder/promotions-unique-catalog-offers/deactivate-unique-catalog-offer.md): Désactive une offre promotionnelle unique du catalogue. Une offre promotionnelle unique créée dans le catalogue est désactivée par défaut. Elle ne peut pas être utilisée tant que vous ne l'avez pas activée. Utilisez cet endpoint pour désactiver une promotion par coupon. ### Lire la liste des offres promotionnelles uniques du catalogue - [GET /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/fr/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offers.md): Récupère la liste des offres promotionnelles uniques d'un projet. ### Créer une offre promotionnelle unique dans le catalogue - [POST /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/fr/api/shop-builder/promotions-unique-catalog-offers/admin-create-unique-catalog-offer.md): Crée une offre promotionnelle unique dans le catalogue. ### Supprimer une promotion par offre unique du catalogue - [DELETE /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-unique-catalog-offers/delete-unique-catalog-offer-promotion.md): Supprime la promotion par offre unique du catalogue. Les conséquences suivantes s'en suivent : * La promotion disparaît de la liste des promotions configurées dans votre projet ; * Elle n'est plus appliquée au catalogue des objets ni au panier. L'utilisateur ne peut plus acheter d'objets à travers cette promotion. Après la suppression, la promotion ne peut pas être restaurée. ### Lire une promotion par offre unique du catalogue - [GET /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offer.md): Récupère une promotion par offre unique du catalogue spécifique. ### Mettre à jour une promotion par offre unique du catalogue - [PUT /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/promotions-unique-catalog-offers/update-unique-catalog-offer-promotion.md): Met à jour une promotion par offre unique du catalogue. ## Remises Cette API permet de gérer les promotions par réduction ### Lire la liste des promotions sur des objets - [GET /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/fr/api/shop-builder/promotions-discounts/get-item-promotion-list.md): Récupère la liste des promotions sur les objets d'un projet. Les promotions offrent une remise (%) sur les objets. La remise s'applique à tous les prix des objets spécifiés. ### Créer une promotion par réduction pour un objet - [POST /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/fr/api/shop-builder/promotions-discounts/create-item-promotion.md): Crée une promotion par réduction pour un objet. Les promotions offrent une remise (%) sur les objets. La remise s'applique à tous les prix des objets spécifiés. ### Supprimer une promotion sur les objets - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/fr/api/shop-builder/promotions-discounts/delete-item-promotion.md): Supprime la promotion par réduction. Les conséquences suivantes s'en suivent : * La promotion disparaît de la liste des promotions configurées dans votre projet ; * Elle n'est plus appliquée au catalogue des objets ni au panier. L'utilisateur ne peut plus acheter d'objets à travers cette promotion. Après la suppression, la promotion ne peut pas être restaurée. ### Lire une promotion sur les objets - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/fr/api/shop-builder/promotions-discounts/get-item-promotion.md): Récupère des informations sur les promotions qui s'appliquent à des objets spécifiques. Les promotions offrent une remise (%) sur des objets. La remise s'applique à tous les prix des objets spécifiés. ### Mettre à jour une promotion sur les objets - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/fr/api/shop-builder/promotions-discounts/update-item-promotion.md): Met à jour la promotion. NoteLes nouvelles données remplaceront les anciennes. Si vous souhaitez mettre à jour une promotion partiellement, assurez-vous de passer toutes les données requises dans la requête. Les promotions offrent une remise (%) sur les objets. La remise s'applique à tous les prix des objets spécifiés. ## Bonus Cette API permet de gérer les promotions par bonus. ### Lire la liste des promotions par bonus - [GET /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/fr/api/shop-builder/promotions-bonuses/get-bonus-promotion-list.md): Récupère la liste des promotions par bonus au sein d'un projet. La promotion ajoute des objets bonus gratuits à l'achat effectué par l'utilisateur. La promotion peut être appliquée à chaque achat au sein d'un projet ou à un achat comprenant des objets particuliers. ### Créer une promotion par bonus - [POST /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/fr/api/shop-builder/promotions-bonuses/create-bonus-promotion.md): Crée une promotion par bonus. La promotion ajoute des objets bonus gratuits à l'achat effectué par l'utilisateur. La promotion peut être appliquée à chaque achat au sein d'un projet ou à un achat comprenant des objets particuliers. ### Supprimer une promotion par bonus - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/fr/api/shop-builder/promotions-bonuses/delete-bonus-promotion.md): Supprime la promotion par bonus. Les conséquences suivantes s'en suivent : * La promotion disparaît de la liste des promotions configurées dans votre projet ; * Elle n'est plus appliquée au catalogue des objets ni au panier. L'utilisateur ne peut plus obtenir d'objets bonus à travers cette promotion. Après la suppression, la promotion ne peut pas être restaurée. ### Lire une promotion par bonus - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/fr/api/shop-builder/promotions-bonuses/get-bonus-promotion.md): Récupère des informations sur une promotion par bonus. La promotion ajoute des objets bonus gratuits à l'achat effectué par l'utilisateur. La promotion peut être appliquée à chaque achat au sein d'un projet ou à un achat comprenant des objets particuliers. ### Mettre à jour une promotion par bonus - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/fr/api/shop-builder/promotions-bonuses/update-bonus-promotion.md): Met à jour une promotion. NoteLes nouvelles données remplaceront les anciennes. Si vous souhaitez mettre à jour une promotion partiellement, assurez-vous de passer toutes les données requises dans la requête. La promotion ajoute des objets bonus gratuits à l'achat effectué par l'utilisateur. La promotion peut être appliquée à chaque achat au sein d'un projet ou à un achat comprenant des objets particuliers. ## Administrateur ### Lire la liste des monnaies virtuelles - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): Récupère la liste des monnaies virtuelles au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Créer une monnaie virtuelle - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-currency.md): Crée une monnaie virtuelle. ### Lire la liste des packages de monnaie virtuelle (administrateur) - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): Récupère la liste des packages de monnaie virtuelle au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Créer un package de monnaie virtuelle - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-currency-package.md): Crée un package de monnaie virtuelle. ### Supprimer un package de monnaie virtuelle - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): Supprime un package de monnaie virtuelle. ### Lire un package de monnaie virtuelle - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency-package.md): Récupère des informations sur un package de monnaie virtuelle au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour un package de monnaie virtuelle - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-currency-package.md): Met à jour un package de monnaie virtuelle. ### Supprimer une monnaie virtuelle - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-currency.md): Supprime une monnaie virtuelle. ### Lire une monnaie virtuelle - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency.md): Récupère des informations sur une monnaie virtuelle au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour une monnaie virtuelle - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-currency.md): Met à jour une monnaie virtuelle. ### Lire la liste des objets virtuels - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list.md): Récupère la liste des objets virtuels au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Créer un objet virtuel - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-item.md): Crée un objet virtuel. ### Lire la liste des objets virtuels par external ID d'un groupe spécifique - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): Récupère la liste des objets virtuels au sein d'un groupe à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Lire la liste des objets virtuels par ID d'un groupe spécifique - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): Récupère la liste des objets virtuels au sein d'un groupe à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Supprimer un objet virtuel - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-item.md): Supprime un objet virtuel. ### Lire un objet virtuel - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-item.md): Récupère des informations sur un objet virtuel au sein d'un projet à des fins d'administration. NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin. ### Mettre à jour un objet virtuel - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-item.md): Met à jour un objet virtuel. ## Catalogue ### Lire la liste des groupes d'objets - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-catalog/get-item-groups.md): Récupère une liste de groupes d'objets pour la constitution d'un catalogue. ### Lire une liste de monnaies virtuelles - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency.md): Récupère une liste de monnaies virtuelles pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une liste de packages de monnaie virtuelle - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-package.md): Récupère une liste de packages de monnaie virtuelle pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire un package de monnaie virtuelle par UGS - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): Récupère des informations sur un package de monnaie virtuelle par son UGS pour la constitution d'un catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ### Lire une monnaie virtuelle par UGS - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-sku.md): Récupère des informations sur une monnaie virtuelle par son UGS pour la constitution d'un catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ### Lire une liste d'objets virtuels - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-catalog/get-virtual-items.md): Récupère une liste d'objets virtuels pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire la liste de tous les objets virtuels - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-catalog/get-all-virtual-items.md): Récupère une liste de tous les objets virtuels à rechercher côté client. AttentionRenvoie uniquement l'UGS, le nom, les groupes et la description. RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation. ### Lire une liste d'objets par groupe spécifique - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-catalog/get-virtual-items-group.md): Récupère une liste d'objets au sein d'un groupe spécifique pour la constitution d'un catalogue. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation permet d'enrichir la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ### Lire un objet virtuel par UGS - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-items-currency-catalog/get-virtual-items-sku.md): Récupère des informations sur un objet virtuel par son UGS pour la constitution d'un catalogue. NoteCet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites et les promotions disponibles pour l'utilisateur. ## Paiement virtuel ### Créer une commande à partir d'un objet spécifique en monnaie virtuelle - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/fr/api/shop-builder/virtual-payment/create-order-with-item-for-virtual-currency.md): Crée l'achat d'un objet en utilisant de la monnaie virtuelle. ## Gestion ### Actualiser toutes les limites d'achat pour un utilisateur spécifique - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/reset-all-user-items-limit.md): Actualise toutes les limites d'achat de tous les objets pour un utilisateur spécifique afin qu'il puisse à nouveau acheter ces objets. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Réduire le nombre d'objets offerts pour un utilisateur spécifique - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/remove-user-item-limit.md): Réduit le nombre restant d'objets offerts pour un utilisateur spécifique dans la limite appliquée. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Lire le nombre d'objets offerts pour un utilisateur spécifique - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/get-user-item-limit.md): Récupère le nombre restant d'objets disponibles pour un utilisateur spécifique dans la limite appliquée. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Augmenter le nombre d'objets offerts pour un utilisateur spécifique - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/add-user-item-limit.md): Augmente le nombre restant d'objets disponibles pour un utilisateur spécifique dans la limite appliquée. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Définir le nombre d'objets offerts pour un utilisateur spécifique - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/set-user-item-limit.md): Définit le nombre d'objets qu'un utilisateur spécifique peut acheter dans la limite appliquée après une augmentation ou une diminution. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Actualiser la limite d'achat - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/reset-user-item-limit.md): Actualise les limites d'achat pour un objet afin que l'utilisateur puisse l'acheter à nouveau. Si le paramètre user est défini sur null, cet appel actualise ces limites pour tous les utilisateurs. L'API des limites utilisateur vous permet de vendre un objet en quantité limitée. Pour configurer les limites d'achat, accédez à la section Administrateur du module du type d'objet souhaité : * Clés de jeu * Objets et monnaie virtuels * Lots ### Actualiser toutes les limites de promotion pour un utilisateur spécifique - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/all](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/reset-all-user-promotions-limit.md): Actualise toutes les limites de toutes les promotions pour un utilisateur spécifique afin qu'il puisse à nouveau utiliser ces promotions. L'API des limites utilisateur vous permet de limiter le nombre de fois qu'un utilisateur peut utiliser une promotion. Pour configurer les limites utilisateur, accédez à la section Administrateur du type de promotion souhaité : * Promotions par réduction * Promotions par bonus ### Réduire la limite de promotion pour un utilisateur spécifique - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/remove-user-promotion-limit.md): Réduit le nombre de fois qu'un utilisateur spécifique peut utiliser une promotion dans la limite appliquée. L'API des limites utilisateur vous permet de limiter le nombre de fois qu'un utilisateur peut utiliser une promotion. Pour configurer les limites utilisateur, accédez à la section Administrateur du type de promotion souhaité : * Promotions par réduction * Promotions par bonus ### Lire la limite de promotion pour un utilisateur spécifique - [GET /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/get-user-promotion-limit.md): Récupère le nombre de fois qu'un utilisateur spécifique peut utiliser la promotion dans la limite appliquée. L'API des limites utilisateur vous permet de limiter le nombre de fois qu'un utilisateur peut utiliser une promotion. Pour configurer les limites utilisateur, accédez à la section Administrateur du type de promotion souhaité : * Promotions par réduction * Promotions par bonus ### Augmenter la limite de promotion pour un utilisateur spécifique - [POST /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/add-user-promotion-limit.md): Augmente le nombre de fois qu'un utilisateur spécifique peut utiliser la promotion dans la limite appliquée. L'API des limites utilisateur vous permet de limiter le nombre de fois qu'un utilisateur peut utiliser une promotion. Pour configurer les limites utilisateur, accédez à la section Administrateur du type de promotion souhaité : * Promotions par réduction * Promotions par bonus ### Définir la limite de promotion pour un utilisateur spécifique - [PUT /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/set-user-promotion-limit.md): Définit le nombre de fois qu'un utilisateur spécifique peut utiliser une promotion dans la limite appliquée après une augmentation ou une diminution. L'API des limites utilisateur vous permet de limiter le nombre de fois qu'un utilisateur peut utiliser une promotion. Pour configurer les limites utilisateur, accédez à la section Administrateur du type de promotion souhaité : * Promotions par réduction * Promotions par bonus ### Actualiser la limite d'une promotion pour les utilisateurs - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all](https://developers.xsolla.com/fr/api/shop-builder/user-limits-admin/reset-user-promotion-limit.md): Actualise la limite de la promotion afin que l'utilisateur puisse à nouveau utiliser cette promotion. Si le paramètre user est défini sur null, cet appel actualise cette limite pour tous les utilisateurs. L'API des limites utilisateur vous permet de limiter le nombre de fois qu'un utilisateur peut utiliser une promotion. Pour configurer les limites utilisateur, accédez à la section Administrateur du type de promotion souhaité : * Promotions par réduction * Promotions par bonus ## Administrateur ### Lire la liste des points de valeur - [GET /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-get-value-points-list.md): Récupère la liste des points de valeur au sein d'un projet à des fins d'administration.e ### Créer un point de valeur - [POST /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-create-value-points.md): Crée un point de valeur. ### Supprimer des points de valeur - [DELETE /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-delete-value-point.md): Supprime un point de valeur spécifique par son UGS. ### Lire un point de valeur - [GET /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-get-value-point.md): Récupère des informations sur un point de valeur par son UGS au sein d'un projet à des fins d'administration. ### Mettre à jour un point de valeur - [PUT /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-update-value-point.md): Met à jour un point de valeur spécifique par son UGS. ### Supprimer les points de valeur des objets - [DELETE /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-delete-items-value-point-reward.md): Supprime les récompenses en points de valeur de TOUS les objets. ### Lire la liste des objets ayant des points de valeur - [GET /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-get-items-value-point-reward.md): Récupère la liste de tous les objets ayant des points de valeur au sein d'un projet à des fins d'administration. ### Mettre à jour partiellement les points de valeur des objets - [PATCH /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-patch-items-value-point-reward.md): Met à jour partiellement le nombre de points de valeur pour un ou plusieurs objets par UGS. Les utilisateurs reçoivent ces points de valeur après l'achat des objets spécifiés. Principes de mise à jour des points de valeur : * Si un objet ne possède pas encore de points de valeur, l'envoi d'une valeur non nulle dans le champ amounten crée. * Si un objet possède déjà des points de valeur, l'envoi d'une valeur non nulle dans le champ amount les met à jour. * Si le champ amount est fixé à 0, les points de valeur existants pour cet objet sont supprimés. Contrairement à la méthode PUT (Définir des points de valeur pour les objets), cette méthode PATCH n'écrase pas tous les points de valeur existants du projet, elle met uniquement à jour les objets spécifiés. Une seule requête peut mettre à jour jusqu'à 100 objets. Les UGS en double ne sont pas autorisés dans la même requête. ### Définir des points de valeur pour les objets - [PUT /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-set-items-value-point-reward.md): Attribue des points de valeur à un ou plusieurs objets par UGS. Les utilisateurs reçoivent des points de valeur en achetant ces objets. Notez que cette requête PUT écrase tous les points de valeur précédemment définis pour les objets du projet. Pour éviter la suppression involontaire de points de valeur, incluez tous les objets et leurs points de valeur respectifs dans chaque requête PUT. Si vous souhaitez uniquement mettre à jour les points de valeur d'un objet spécifique tout en préservant les points de valeur des autres objets, vous devez récupérer l'ensemble actuel des points de valeur à l'aide d'une requête GET, modifier les points de valeur de l'objet souhaité, puis renvoyer l'ensemble modifié des points de valeur avec les points de valeur mis à jour pour l'objet spécifique. ### Lire une liste de chaînes de récompenses - [GET /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-get-reward-chains.md): Récupère une liste de chaînes de récompenses. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 10 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. ### Créer une chaîne de récompenses - [POST /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-create-reward-chain.md): Crée une chaîne de récompenses. ### Supprimer une chaîne de récompenses - [DELETE /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-delete-reward-chain.md): Supprime une chaîne de récompenses spécifique. ### Lire une chaîne de récompenses - [GET /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-get-reward-chain.md): Récupère des informations sur une chaîne de récompenses spécifique. ### Mettre à jour une chaîne de récompenses - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-update-reward-chain.md): Met à jour une chaîne de récompenses spécifique. ### Réinitialiser la chaîne de récompenses - [POST /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/reset](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-reset-reward-chain.md): Réinitialise les points de valeur et la progression de tous les utilisateurs dans la chaîne de récompenses. Après la réinitialisation, vous pouvez mettre à jour la période de validité de la chaîne de récompenses et l'utilisateur peut à nouveau progresser dans la chaîne. Avis Ne réinitialisez pas la chaîne de récompenses pendant sa période de validité. Dans ce cas, les utilisateurs risquent de perdre des points de valeur gagnés avant de réclamer leur récompense. ### Basculer une chaîne de récompenses - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/toggle](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-value-points-admin/admin-toggle-reward-chain.md): Active/désactive la chaîne de récompenses. ## Client ### Lire les chaînes de récompenses de l'utilisateur actuel - [GET /v2/project/{project_id}/user/reward_chain](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-client/get-reward-chains-list.md): Endpoint client. Récupère des informations sur les chaînes de récompenses de l'utilisateur actuel. AttentionTous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont de 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset. ### Lire le solde de points de valeur de l'utilisateur actuel - [GET /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/balance](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-client/get-user-reward-chain-balance.md): Endpoint client. Récupère le solde de points de valeur de l'utilisateur actuel. ### Réclamer la récompense d'une étape - [POST /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/step/{step_id}/claim](https://developers.xsolla.com/fr/api/shop-builder/reward-chain-client/claim-user-reward-chain-step-reward.md): Endpoint client. Réclame la récompense de l'utilisateur actuel pour l'étape de la chaîne de récompenses. ## Client clans ### Lire les 10 premiers contributeurs à la chaîne de récompense au sein du clan - [GET /v2/project/{project_id}/user/clan/contributors/{reward_chain_id}/top](https://developers.xsolla.com/fr/api/shop-builder/clan-reward-chain-client/get-user-clan-top-contributors.md): Récupère la liste des 10 premiers contributeurs à la chaîne de récompense spécifique sous le clan de l'utilisateur actuel. Si l'utilisateur n'appartient pas à un clan, l'appel renvoie un tableau vide. ### Mise à jour du clan de l'utilisateur actuel - [PUT /v2/project/{project_id}/user/clan/update](https://developers.xsolla.com/fr/api/shop-builder/clan-reward-chain-client/user-clan-update.md): Met à jour le clan de l'utilisateur actuel via les attributs utilisateur. Récupère toutes les récompenses non réclamées des chaînes de récompenses associées à un clan précédent et les renvoie dans la réponse. Si l'utilisateur quitte un clan, son appartenance sera révoquée. En cas de changement de clan, le nouveau clan sera mis à jour. ## Administrateur ### Lire une liste de chaînes d'offres - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-admin/admin-get-offer-chains.md): Récupère une liste de chaînes d'offres à des fins d'administration. AttentionTous les projets sont soumis à une limite de nombre d'objets pouvant être renvoyés dans une seule réponse. La valeur par défaut et la valeur maximale sont de 10 objets par réponse. Pour obtenir plus de données, utilisez les paramètres de requête limit et offset pour la pagination. ### Créer une chaîne d'offres - [POST /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-admin/admin-create-offer-chain.md): Crée une chaîne d'offres ### Supprimer une chaîne d'offres - [DELETE /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-admin/admin-delete-offer-chain.md): Supprime une chaîne d'offres spécifique. Après la suppression :Toutes les récompenses déjà reçues par les utilisateurs sont conservées.Les étapes non achevées deviennent indisponibles et les récompenses correspondantes ne peuvent plus être obtenues. Contrairement à la désactivation de la chaîne d'offres via l'appel Activer/désactiver une chaîne d'offres, la suppression est irréversible et la progression de l'utilisateur n'est pas préservée. ### Lire une chaîne d'offre - [GET /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-admin/admin-get-offer-chain.md): Récupère une chaîne d'offres spécifique à des fin d'administration. ### Mettre à jour une chaîne - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-admin/admin-update-offer-chain.md): Met à jour une chaîne d'offres spécifique. ### Activer/désactiver une chaîne d'offres - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}/toggle](https://developers.xsolla.com/fr/api/shop-builder/offer-chain-admin/admin-toggle-offer-chain.md): Active ou désactive une chaîne d'offres. Lorsque la chaîne d'offres est désactivée, les utilisateurs n'y ont temporairement plus accès, mais leur progression est préservée. Lorsque la chaîne d'offres est réactivée, les utilisateurs peuvent continuer à partir de l'étape où ils se sont arrêtés. ## Administrateur ### Lire une liste de récompenses quotidiennes - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/fr/api/shop-builder/daily-chain-admin/admin-get-daily-chains.md): Récupère une liste de récompenses quotidiennes pour administration. RemarqueLa méthode renvoie une liste paginée d'objets. La valeur maximale et par défaut est de 50 objets par réponse. Pour obtenir d'autres objets de la liste, utilisez les paramètres limit et offset, et récupérez d'autres pages. Par exemple, avec limit = 25 et offset = 100, la réponse renvoie 25 objets à partir du 101e objet de la liste globale. ### Créer une récompense quotidienne - [POST /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/fr/api/shop-builder/daily-chain-admin/admin-create-daily-chain.md): Crée une récompense quotidienne. ### Supprimer la récompense quotidienne - [DELETE /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/daily-chain-admin/admin-delete-daily-chain.md): Supprime une récompense quotidienne spécifique. ### Lire une récompense quotidienne - [GET /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/daily-chain-admin/admin-get-daily-chain.md): Récupère une récompense quotidienne spécifique pour administration. ### Mettre à jour la récompense quotidienne - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/daily-chain-admin/admin-update-daily-chain.md): Met à jour une récompense quotidienne spécifique. ### Réinitialiser la récompense quotidienne - [POST /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/reset](https://developers.xsolla.com/fr/api/shop-builder/daily-chain-admin/admin-reset-daily-chain.md): Réinitialise la progression de tous les utilisateurs pour cette récompense quotidienne. Applicable uniquement aux récompenses de type rolling. ### Basculer une récompense quotidienne - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/toggle](https://developers.xsolla.com/fr/api/shop-builder/daily-chain-admin/admin-toggle-daily-chain.md): Active ou désactive une récompense quotidienne. ## Client ### Lire les récompenses quotidiennes de l'utilisateur actuel - [GET /v2/project/{project_id}/user/daily_chain](https://developers.xsolla.com/fr/api/shop-builder/daily-chain-client/get-daily-chains-list.md): Endpoint client. Récupère les récompenses quotidiennes de l'utilisateur actuel. RemarqueLa méthode renvoie une liste paginée d'objets. La valeur maximale et par défaut est de 50 objets par réponse. Pour obtenir d'autres objets de la liste, utilisez les paramètres limit et offset, et récupérez d'autres pages. Par exemple, avec limit = 25 et offset = 100, la réponse renvoie 25 objets à partir du 101e objet de la liste globale. ### Lire la récompense quotidienne de l'utilisateur actuel par son ID - [GET /v2/project/{project_id}/user/daily_chain/{daily_chain_id}](https://developers.xsolla.com/fr/api/shop-builder/daily-chain-client/get-user-daily-chain-by-id.md): Endpoint client. Récupère la récompense quotidienne de l'utilisateur actuel par son ID. ### Réclamer une étape de récompense quotidienne - [POST /v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/fr/api/shop-builder/daily-chain-client/claim-user-daily-chain-step-reward.md): Endpoint client. Réclame la récompense d'une étape d'une récompense quotidienne de l'utilisateur actuel. Les étapes doivent être réclamées dans l'ordre séquentiel. Une récompense d'étape manquée ne peut être récupérée ni en monnaie virtuelle ou réelle, ni en regardant une publicité. ## Administrateur ### Lire les informations sur les ventes incitatives dans le projet - [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/fr/api/shop-builder/upsell-admin/get-upsell-configurations-for-project-admin.md): Récupère les informations relatives à la vente incitative dans le projet : si elle est activée, le type de vente incitative et la liste des UGS des objets concernés par cette vente. ### Créer une vente incitative - [POST /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/fr/api/shop-builder/upsell-admin/post-upsell.md): Crée une vente incitative pour un projet. ### Mettre à jour une vente incitative - [PUT /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/fr/api/shop-builder/upsell-admin/put-upsell.md): Mettre à jour une vente incitative pour un projet. ### Activer/désactiver la vente incitative d'un projet - [PUT /v2/project/{project_id}/admin/items/upsell/{toggle}](https://developers.xsolla.com/fr/api/shop-builder/upsell-admin/put-upsell-toggle-active-inactive.md): Modifie l'état d'une vente incitative dans un projet en activant ou désactivant la promotion. ## Client ### Lire la liste des objets de vente incitative dans le projet - [GET /v2/project/{project_id}/items/upsell](https://developers.xsolla.com/fr/api/shop-builder/upsell-client/get-upsell-for-project-client.md): Récupère la liste des objets de vente incitative d'un projet s'ils ont déjà été configurés. ## Administrateur ### Lire le statut de l'importation d'objets - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/fr/api/shop-builder/connector-admin/get-items-import-status.md): Récupère des informations sur la progression de l'importation d'objets dans le projet. Cet appel API récupère des données sur la dernière importation effectuée par le biais de l'API ou du Compte éditeur. ### Importer des objets via un fichier JSON - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/fr/api/shop-builder/connector-admin/import-items-from-external-file.md): Importe des objets dans le magasin à partir d'un fichier JSON via l'URL spécifiée. Pour plus d'informations, consultez la documentation.