# LiveOps 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 LiveOps API fournit des endpoints pour stimuler l'engagement des joueurs. 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 [LiveOps API](https://developers.xsolla.com/_bundle/@l10n/fr/api/liveops/index.yaml) ## Communs ### Activer une promotion - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/fr/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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. ## 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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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). ## Gestion ### 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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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 récompenses quotidiennes - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/fr/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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 une liste de chaînes d'offres - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/fr/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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. ## Client ### Lire les chaînes d'offres de l'utilisateur actuel - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/fr/api/liveops/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/liveops/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/liveops/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/liveops/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. ## payment-client-side ### 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/liveops/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. ## 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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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.