---
title: "Monnaies virtuelles"
description: "Définissez des monnaies intégrées dans Adapty, associez-les à des produits pour créditer automatiquement des points, et suivez le solde de chaque utilisateur."
---

<CustomDocCardList ids={['virtual-currency-quickstart', 'create-virtual-currency', 'grant-initial-balance', 'virtual-currency-balance']} />

Accordez à vos utilisateurs une monnaie virtuelle — tokens IA, crédits ou pièces — lorsqu'ils achètent des produits ou renouvellent des abonnements. Définissez une monnaie une seule fois, associez-la aux produits qui doivent la distribuer, et Adapty crédite chaque utilisateur automatiquement en tenant à jour son solde. Votre application lit et dépense ce solde via l'[API côté serveur](getting-started-with-server-side-api) — par exemple, pour facturer des tokens par génération.

## Comment ça fonctionne \{#how-it-works\}

1. [Créer une devise virtuelle](create-virtual-currency) : Ouvrez **Products** et cliquez sur l'onglet **Virtual currency**. Cliquez sur **New virtual currency**. Définissez une devise avec un code, un nom et une description facultative.
2. **Associer la devise à des produits** : Reliez la devise à des produits à achat unique ou par abonnement, et définissez le nombre de crédits accordés pour chaque achat.
3. **Les crédits sont accordés automatiquement** : Lorsqu'un utilisateur achète un produit à achat unique associé ou renouvelle un abonnement associé, Adapty ajoute les crédits configurés à son solde.
4. **Lire et dépenser le solde** : Votre application lit le solde de chaque utilisateur et accorde ou dépense des crédits via l'API côté serveur. Utilisez la même API pour [accorder un solde initial](grant-initial-balance) aux utilisateurs qui n'ont encore rien acheté.
5. **Suivre chaque modification** : Chaque changement de solde est répertorié dans le [profil de l'utilisateur](virtual-currency-balance).

Pour un guide complet — de la configuration de la devise à l'utilisation des crédits via l'API — suivez le [guide de démarrage rapide sur la monnaie virtuelle](virtual-currency-quickstart).

## Cas d'usage \{#use-cases\}

| Type d'application | Comment utiliser les monnaies virtuelles |
|----------|-------------------------------|
| **Applications IA** (génération d'images, de vidéos ou de texte) | Facturer des crédits par génération. Inclure un quota mensuel de crédits dans l'abonnement et vendre des packs de crédits en tant que produits à achat unique. |
| **Applications de courtes séries et de vidéos** | Facturer des pièces pour déverrouiller un épisode. Accorder aux abonnés un quota récurrent de pièces et vendre des packs de pièces en tant que produits à achat unique. |
| **Apprentissage des langues et éducation** | Donner aux utilisateurs gratuits un quota limité de cœurs ou de vies via l'API côté serveur. Accorder un quota plus important, ou ignorer entièrement la vérification du solde, avec un abonnement payant. |
| **Jeux mobiles** | Utiliser deux monnaies en parallèle (souple et forte) : accorder de l'or pour les parties via l'API côté serveur, vendre des gemmes contre de l'argent et convertir entre les deux dans une transaction atomique unique. |
| **Applications de productivité** | Mesurer les actions coûteuses, comme l'OCR ou les exports, avec des crédits. Donner aux utilisateurs gratuits un petit quota, en accorder davantage avec un abonnement, et vendre des packs de crédits pour les traitements en lot. |

:::tip
Pour les allocations d'abonnement, activez l'[expiration des crédits](create-virtual-currency#link-products). Quand les crédits inutilisés sont réinitialisés à chaque renouvellement, l'allocation reste une raison de conserver l'abonnement, et les utilisateurs intensifs achètent des packs de crédits plutôt que d'épuiser un stock accumulé.
:::

## Limitations \{#limitations\}

- **L'accès multi-appareils nécessite une identification** : un solde appartient à un seul profil. Un utilisateur anonyme ne conserve son solde que sur l'installation où il l'a gagné ; il est donc perdu en cas de réinstallation ou d'ouverture sur un autre appareil. Identifiez vos utilisateurs pour rendre un solde disponible sur tous les appareils et après chaque réinstallation. Voir [Soldes, profils et appareils](virtual-currency-balance#balances-profiles-and-devices).
- **Côté serveur uniquement** : il n'existe pas encore de méthode SDK pour lire ou dépenser un solde, votre application a donc besoin d'un backend. Celui-ci lit les soldes et accorde ou dépense des crédits via l'API côté serveur.
- **Jusqu'à 20 devises par application** : vous pouvez créer jusqu'à 20 monnaies virtuelles dans une seule application.