Limites d’achat d’objets
Comment ça marche
Vous pouvez définir une limite d’achat par utilisateur et programmer la réinitialisation de ces limites.
La configuration des limites est disponible pour les scénarios suivants :
- vente d’objets en jeu — objets virtuels, packages de monnaie virtuelle et lots
- vente de jeux et de DLC via des clés de jeu
Vous pouvez activer des réinitialisations périodiques des limites pour :
- autoriser les achats répétés
- synchroniser les données avec votre système lorsque des objets sont vendus sur plusieurs plateformes de publication de jeux
Pour afficher correctement la quantité disponible pour un utilisateur, vous devez configurer l’authentification.
Les utilisateurs non authentifiés voient toujours la quantité maximale d’objets qu’ils peuvent acheter. Pour afficher la quantité restante d’objets pour un utilisateur avec la limite active appliquée, incluez les données d’autorisation de l’utilisateur lors de la requête :
- le catalogue des objets à l’aide des appels de la sous-section Catalog du groupe Virtual Items & Currency
- le catalogue des jeux à l’aide des appels de la sous-section Catalog du groupe Game Keys
Xsolla applique des limites et empêche les utilisateurs d’acheter plus d’objets que la limite fixée :
- Lorsque l’interface de paiement est ouverte et qu’un objet est payé, toutes les commandes non payées contenant ce même objet deviennent invalides.
- Exemple : un utilisateur ouvre le formulaire de paiement pour un objet soumis à une limite de quantité dans plusieurs onglets ou navigateurs avant de finaliser l'achat, ce qui génère plusieurs commandes pour le même objet. Une fois l'achat effectué dans un onglet, Xsolla annule toutes les commandes non payées pour cet objet.
- Lorsqu’un paiement est remboursé ou qu’une commande est annulée, les limites ne sont pas réinitialisées. Vous pouvez les réinitialiser en utilisant les appels API suivants : Refresh all purchase limits for specified user et Refresh all promotion limits for specified user.
- Exemple : un utilisateur peut acheter un objet soumis à des limites d’achat, l’utiliser dans le jeu, puis demander un remboursement. Si les limites étaient réinitialisées automatiquement, l’utilisateur pourrait acheter à nouveau l’objet, l’utiliser et répéter ce cycle, contournant ainsi les limites prévues. Pour éviter cela, les limites ne sont pas réinitialisées lorsqu’un paiement est remboursé ou qu’une commande est annulée.
Pour configurer des limites d’utilisation des promotions, consultez les instructions.
Configurer et mettre à jour les limites
Configurer et mettre à jour dans le Compte éditeur
- Le processus ci-dessous est illustré avec des objets virtuels.
- Avant de configurer des objets virtuels, il est recommandé de créer des groupes. Les groupes vous permettent de construire un catalogue à plusieurs niveaux et de gérer l’affichage des objets dans votre magasin.
- Dans le Compte éditeur, vous pouvez mettre à jour les limites d’un objet spécifique pour tous les utilisateurs. Des options de configuration avancées sont disponibles via des appels API.
Pour créer un objet soumis à une limite de quantité :
- Ouvrez votre projet dans le Compte éditeur et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez votre projet dans le compte pour les jeux mobiles, puis accédez à la section Catalog.
- Cliquez sur Create manually, puis sélectionnez Virtual item dans la liste déroulante.
- Dans la section General settings, indiquez les éléments suivants :
- SKU
- Un ou plusieurs groupes auxquels l’objet doit appartenir (facultatif)
- Nom
- Description courte
- Description détaillée — pour l’ajouter, activez la bascule correspondante (facultatif)
- Dans la section Media, téléchargez une ou plusieurs images ou vidéos (facultatif) — depuis votre appareil ou via un lien. Dans le magasin créé avec l’éditeur de site Xsolla, toutes les fiches d’objet affichent le fichier marqué Main, tandis que les autres fichiers ne sont disponibles que dans celles qui incluent une galerie de médias. Le fichier marqué Main est également renvoyé dans les réponses des appels API de récupération du catalogue.
- Dans la section Price settings, définissez des prix ou créez un objet gratuit :
- Pour définir un prix, sélectionnez Paid item, activez la bascule Real currency prices et/ou Virtual currency prices, puis indiquez le prix. Si nécessaire, configurez les prix régionaux.
- Pour créer un objet gratuit, sélectionnez Free item.
Un objet peut avoir des prix dans plusieurs devises réelles et monnaies virtuelles. Dans ce cas, vous devez spécifier une devise par défaut pour chaque type — une parmi les devises réelles et une parmi les monnaies virtuelles.
Vous pouvez indiquer un prix en monnaie virtuelle uniquement si la monnaie virtuelle a déjà été créée dans le projet.
- Pour limiter le nombre d’objets disponibles à l’achat :
- Activez la bascule dans la section Limits et indiquez la quantité.
- Configurez la fréquence de réinitialisation de la limite. Pour cela, sélectionnez une période dans la liste déroulante :
- Daily.
- Weekly.
- Monthly.
- Custom interval. L’intervalle est calculé à partir de la date de début d’affichage de l’objet dans le magasin.
- No regular refresh.
- Définissez le planning de réinitialisation en précisant les paramètres correspondant à la période sélectionnée.
Pour configurer une durée d’affichage limitée pour l’objet (facultatif) :
- Activez la bascule dans la section Add specific display period.
- Indiquez le fuseau horaire ainsi que le début et la fin de la période.
Pour laisser la fin de la période d’affichage indéfinie, activez la bascule No end date.
- Configurez les attributs à l’aide de l’une des options suivantes (facultatif) :
- Si l’objet payant est utilisé dans un mécanisme de récompense aléatoire (par exemple, loot boxes ou gacha), activez la bascule Mark as paid randomized reward.
Cliquez sur Create.
Dans la fenêtre qui s’ouvre, sélectionnez le statut de l’objet et cliquez sur Continue.
L’objet créé apparaît dans la section All items.
Pour configurer ou mettre à jour les limites d’un objet existant :
- Ouvrez votre projet dans le Compte éditeur et accédez à la section Items catalog > All items > Virtual items.
Configurer et mettre à jour dans votre compte
- Le processus ci-dessous est illustré avec des objets virtuels.
- Avant de configurer des objets virtuels, il est recommandé de créer des groupes. Les groupes vous permettent de construire un catalogue à plusieurs niveaux et de gérer l’affichage des objets dans votre magasin.
- Dans votre compte, vous pouvez mettre à jour les limites d’un objet spécifique pour tous les utilisateurs. Des options de configuration avancées sont disponibles via des appels API.
Pour créer un objet soumis à une limite de quantité :
- Ouvrez votre projet dans le Compte éditeur et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez votre projet dans le compte pour les jeux mobiles, puis accédez à la section Catalog.
- Cliquez sur Create manually, puis sélectionnez Virtual item dans la liste déroulante.
- Dans la section General settings, indiquez les éléments suivants :
- SKU
- Un ou plusieurs groupes auxquels l’objet doit appartenir (facultatif)
- Nom
- Description courte
- Description détaillée — pour l’ajouter, activez la bascule correspondante (facultatif)
- Dans la section Media, téléchargez une ou plusieurs images ou vidéos (facultatif) — depuis votre appareil ou via un lien. Dans le magasin créé avec l’éditeur de site Xsolla, toutes les fiches d’objet affichent le fichier marqué Main, tandis que les autres fichiers ne sont disponibles que dans celles qui incluent une galerie de médias. Le fichier marqué Main est également renvoyé dans les réponses des appels API de récupération du catalogue.
- Dans la section Price settings, définissez des prix ou créez un objet gratuit :
- Pour définir un prix, sélectionnez Paid item, activez la bascule Real currency prices et/ou Virtual currency prices, puis indiquez le prix. Si nécessaire, configurez les prix régionaux.
- Pour créer un objet gratuit, sélectionnez Free item.
Un objet peut avoir des prix dans plusieurs devises réelles et monnaies virtuelles. Dans ce cas, vous devez spécifier une devise par défaut pour chaque type — une parmi les devises réelles et une parmi les monnaies virtuelles.
Vous pouvez indiquer un prix en monnaie virtuelle uniquement si la monnaie virtuelle a déjà été créée dans le projet.
- Pour limiter le nombre d’objets disponibles à l’achat :
- Activez la bascule dans la section Limits et indiquez la quantité.
- Configurez la fréquence de réinitialisation de la limite. Pour cela, sélectionnez une période dans la liste déroulante :
- Daily.
- Weekly.
- Monthly.
- Custom interval. L’intervalle est calculé à partir de la date de début d’affichage de l’objet dans le magasin.
- No regular refresh.
- Définissez le planning de réinitialisation en précisant les paramètres correspondant à la période sélectionnée.
Pour configurer une durée d’affichage limitée pour l’objet (facultatif) :
- Activez la bascule dans la section Add specific display period.
- Indiquez le fuseau horaire ainsi que le début et la fin de la période.
Pour laisser la fin de la période d’affichage indéfinie, activez la bascule No end date.
- Configurez les attributs à l’aide de l’une des options suivantes (facultatif) :
- Si l’objet payant est utilisé dans un mécanisme de récompense aléatoire (par exemple, loot boxes ou gacha), activez la bascule Mark as paid randomized reward.
Cliquez sur Create.
Dans la fenêtre qui s’ouvre, sélectionnez le statut de l’objet et cliquez sur Continue.
L’objet créé apparaît dans la section All items.
Pour configurer ou mettre à jour les limites d’un objet existant :
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
Configurer et mettre à jour dans votre compte
- Le processus ci-dessous est illustré avec des objets virtuels.
- Avant de configurer des objets virtuels, il est recommandé de créer des groupes. Les groupes vous permettent de construire un catalogue à plusieurs niveaux et de gérer l’affichage des objets dans votre magasin.
- Dans votre compte, vous pouvez mettre à jour les limites d’un objet spécifique pour tous les utilisateurs. Des options de configuration avancées sont disponibles via des appels API.
Pour créer un objet soumis à une limite de quantité :
- Ouvrez votre projet dans le Compte éditeur et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez le projet dans votre compte et accédez à la section Items catalog > All items > Virtual items.
- Ouvrez votre projet dans le compte pour les jeux mobiles, puis accédez à la section Catalog.
- Cliquez sur Create manually, puis sélectionnez Virtual item dans la liste déroulante.
- Dans la section General settings, indiquez les éléments suivants :
- SKU
- Un ou plusieurs groupes auxquels l’objet doit appartenir (facultatif)
- Nom
- Description courte
- Description détaillée — pour l’ajouter, activez la bascule correspondante (facultatif)
- Dans la section Media, téléchargez une ou plusieurs images ou vidéos (facultatif) — depuis votre appareil ou via un lien. Dans le magasin créé avec l’éditeur de site Xsolla, toutes les fiches d’objet affichent le fichier marqué Main, tandis que les autres fichiers ne sont disponibles que dans celles qui incluent une galerie de médias. Le fichier marqué Main est également renvoyé dans les réponses des appels API de récupération du catalogue.
- Dans la section Price settings, définissez des prix ou créez un objet gratuit :
- Pour définir un prix, sélectionnez Paid item, activez la bascule Real currency prices et/ou Virtual currency prices, puis indiquez le prix. Si nécessaire, configurez les prix régionaux.
- Pour créer un objet gratuit, sélectionnez Free item.
Un objet peut avoir des prix dans plusieurs devises réelles et monnaies virtuelles. Dans ce cas, vous devez spécifier une devise par défaut pour chaque type — une parmi les devises réelles et une parmi les monnaies virtuelles.
Vous pouvez indiquer un prix en monnaie virtuelle uniquement si la monnaie virtuelle a déjà été créée dans le projet.
- Pour limiter le nombre d’objets disponibles à l’achat :
- Activez la bascule dans la section Limits et indiquez la quantité.
- Configurez la fréquence de réinitialisation de la limite. Pour cela, sélectionnez une période dans la liste déroulante :
- Daily.
- Weekly.
- Monthly.
- Custom interval. L’intervalle est calculé à partir de la date de début d’affichage de l’objet dans le magasin.
- No regular refresh.
- Définissez le planning de réinitialisation en précisant les paramètres correspondant à la période sélectionnée.
Pour configurer une durée d’affichage limitée pour l’objet (facultatif) :
- Activez la bascule dans la section Add specific display period.
- Indiquez le fuseau horaire ainsi que le début et la fin de la période.
Pour laisser la fin de la période d’affichage indéfinie, activez la bascule No end date.
- Configurez les attributs à l’aide de l’une des options suivantes (facultatif) :
- Si l’objet payant est utilisé dans un mécanisme de récompense aléatoire (par exemple, loot boxes ou gacha), activez la bascule Mark as paid randomized reward.
Cliquez sur Create.
Dans la fenêtre qui s’ouvre, sélectionnez le statut de l’objet et cliquez sur Continue.
L’objet créé apparaît dans la section All items.
Pour configurer ou mettre à jour les limites d’un objet existant :
- Ouvrez le projet dans votre compte pour les jeux mobiles et accédez à la section Catalog > Virtual items.
Ouvrez le groupe contenant l’objet.
Dans la ligne de l’objet, cliquez sur ••• et choisissez Edit dans la liste déroulante.
Dans la section Limits for single user, définissez la limite et/ou sélectionnez la fréquence de réinitialisation de la limite, puis indiquez l’heure et le fuseau horaire.
- Cliquez sur Save changes.
Configurer et mettre à jour via des appels API
Pour configurer les limites d’achat d’objets via l’API, utilisez l’objet limits dans les méthodes suivantes :
Pour configurer l’actualisation des limites (quotidiennes, hebdomadaires ou mensuelles), passez l’objet limits.recurrent_schedule.
Si une période d’actualisation des limites est configurée, vous pouvez aussi décider si l’objet reste visible dans le catalogue une fois la limite d’achat atteinte. Pour ce faire, passez le paramètre “limits.per_user.limit_exceeded_visibility”: “show”.
Si aucune actualisation périodique n’est configurée, l’objet est masqué du catalogue une fois la limite atteinte, quelle que soit la valeur du paramètre.
Pour mettre à jour et gérer les limites via l’API, utilisez les méthodes de la sous-section Gestion du groupe de méthodes Limites.
| Fonction | Appel API |
|---|---|
| Actualiser les limites pour un objet spécifié pour tous les utilisateurs ou des utilisateurs donnés. | Refresh purchase limit. |
| Réinitialiser toutes les limites d’objets pour un utilisateur spécifié. | Refresh all purchase limits for specified user. |
| Modifier la limite d’achat d’un objet spécifié pour un utilisateur spécifié. | Set number of items available to specified user. |
| Récupérer les informations sur les limites configurées pour un objet spécifié et un utilisateur spécifié. | Get number of items available to specified user. |
| Augmenter le nombre d’objets pouvant être achetés par un utilisateur spécifié. | Increase number of items available to specified user. |
| Diminuer le nombre d’objets pouvant être achetés par un utilisateur spécifié. | Decrease number of items available to specified user. |
Afficher les limites dans le catalogue des objets
Les limites de vente des objets s’affichent dans le catalogue selon leur mode d’implémentation — via le Site Builder ou via l’API.
Afficher via le Site Builder
Si vous utilisez le constructeur de site, les limites s’affichent automatiquement : la carte de l’objet indique un compteur du nombre d’objets disponibles pour l’utilisateur.
Récupérer les informations de limite via l’API
Si le catalogue est implémenté via API, les informations sur les limites sont renvoyées dans le tableau items.limits lors des appels API suivants liés au catalogue :
- Get virtual items list
- Get virtual currency list
- Get virtual currency packages list
- Get bundles list
- Get games list
Les objets pour lesquels l’utilisateur a atteint sa limite d’achat sont renvoyés avec can_be_bought = false.
Vous pouvez mettre à jour ces limites selon vos besoins.
Ces données peuvent être utilisées pour afficher les limites dans le catalogue, par exemple pour indiquer le nombre maximal d’objets disponibles à l’achat.
Liens utiles
Dernière mise à jour: 15 Mai 2026Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.
