Rappel : À compter du 2 août 2023, toutes les nouvelles applications devront utiliser la bibliothèque Billing version 5 ou ultérieure. D'ici le 1er novembre 2023, toutes les mises à jour apportées aux applications existantes devront utiliser la bibliothèque Billing version 5 ou ultérieure. En savoir plus

Présentation du système de facturation de Google Play

Le système de facturation de Google Play est un service qui vous permet de vendre des produits et des contenus numériques dans votre application Android.

Types de produits

Vous pouvez utiliser Google Play pour vendre les types de produits suivants :

  • Produits ponctuels : un produit ponctuel est un article que les utilisateurs peuvent acheter contre le paiement d'un montant non récurrent. Il peut s'agir, entre autres, de niveaux de jeu supplémentaires, de loot boxes premium et de fichiers multimédias. Les produits ponctuels peuvent être consommables ou non consommables :

    • Produit consommable : produit qu'un utilisateur doit consommer pour recevoir du contenu dans le jeu. Lorsqu'un utilisateur consomme votre produit, vous mettez à sa disposition les avantages ou effets associés dans un processus appelé provisionnement. Par exemple, un utilisateur peut acheter une monnaie en jeu, telle qu'une pile de pièces. Lorsqu'il consomme le produit, votre application lui distribue un nombre fixe de pièces, et la pile de pièces achetée n'est plus disponible. Les produits consommables peuvent être achetés plusieurs fois.
    • Produit non consommable : produit acheté une seule fois et offrant un avantage permanent. Une fois achetés, ces produits sont associés indéfiniment au compte Google de l'utilisateur. Les éditions premium et les packs de niveaux sont des exemples de produits non consommables.

    La Google Play Console utilise la désignation produits gérés pour faire référence aux produits ponctuels, tandis que la bibliothèque Google Play Billing les appelle produits "INAPP".

  • Abonnements : un abonnement est un ensemble d'avantages auxquels les utilisateurs peuvent accéder pendant une période donnée. Plusieurs abonnements peuvent être proposés dans la même application, soit pour représenter des avantages complètement différents (par exemple, une application de vidéos en streaming peut inclure des abonnements "actualités" et "sports" distincts), soit pour différents niveaux d'un même ensemble d'avantages (par exemple, des abonnements 100 Go, 1 To ou 10 To dans une application de stockage cloud).

    Les utilisateurs bénéficient d'un accès (ou droit d'accès) à un abonnement lorsqu'ils achètent un forfait de base ou une offre dans l'application ou sur Google Play.

    Un abonnement contient un ou plusieurs forfaits de base, chacun correspondant à un ensemble unique d'attributs pour une période de facturation et un type de renouvellement donnés. Vous pouvez indiquer si le forfait de base se renouvelle automatiquement ou s'il est prépayé (sans renouvellement automatique).

    Les utilisateurs éligibles peuvent acheter une offre pour bénéficier d'un essai et/ou d'un prix découverte. Tous les utilisateurs peuvent souscrire un forfait de base, mais les offres sont réservées à ceux répondant aux critères d'éligibilité que vous définissez.

    Dans la bibliothèque Google Play Billing, les abonnements sont appelés SUBS.

Jetons d'achat et ID de commande

Google Play effectue le suivi des produits et des transactions à l'aide des jetons d'achat et des ID de commande.

  • Un jeton d'achat est une chaîne qui représente le droit d'un utilisateur à acheter un produit sur Google Play. Il indique qu'un utilisateur Google est autorisé à accéder à un produit spécifique représenté par un objet d'achat. Vous pouvez utiliser le jeton d'achat avec l'API Google Play Developer.
  • Un ID de commande est une chaîne représentant une transaction financière sur Google Play. Cette chaîne est incluse dans un reçu envoyé par e-mail à l'acheteur.

Les ID de commande sont créés à chaque transaction financière. Les jetons d'achat ne sont générés que lorsqu'un utilisateur effectue un parcours d'achat.

  • Pour les produits ponctuels, chaque achat crée un jeton d'achat. La plupart des achats génèrent également un nouvel ID de commande, sauf quand l'utilisateur ne doit rien payer, comme décrit dans la section Codes promotionnels.
  • Pour les abonnements, un achat initial crée un jeton d'achat et un ID de commande. Pour chaque renouvellement automatique, le jeton d'achat reste le même, et un nouvel ID de commande est émis. Le passage à un abonnement de niveau supérieur ou inférieur, les remplacements d'abonnement, ainsi que les réinscriptions génèrent tous des jetons d'achat et des ID de commande.

Veuillez noter les points suivants concernant les abonnements :

  • Le passage à un abonnement de niveau supérieur ou inférieur, ainsi que les autres parcours d'achat d'abonnements génèrent des jetons d'achat qui doivent remplacer un jeton d'achat précédent. Vous devez invalider les jetons d'achat qui apparaissent dans le champ linkedPurchaseToken de l'API Google Play Developer. Pour en savoir plus, consultez la section Implémenter correctement l'élément linkPurchaseToken afin d'éviter les abonnements en double.
  • Les numéros de commande des renouvellements d'abonnement contiennent un entier supplémentaire qui représente une instance de renouvellement spécifique. Par exemple, l'ID de commande d'un abonnement initial peut être GPA.1234-5678-9012-34567, et les ID de commande suivants GPA.1234-5678-9012-34567..0 (premier renouvellement), GPA.1234-5678-9012-34567..1 (deuxième renouvellement), etc.

Premiers pas

Pour commencer à intégrer le système de facturation de Google Play à votre application, consultez la section Préparation.

En savoir plus

Pour en savoir plus sur l'intégration du système de facturation de Google Play dans votre application, consultez les articles suivants :