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

Tester l'intégration de la bibliothèque Google Play Billing

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Vous devez tester votre intégration tout au long du développement. Pour effectuer des tests pendant la phase de développement, nous vous recommandons d'utiliser des testeurs de licence afin de passer en revue les scénarios décrits dans cet article. Pour configurer ces testeurs de licence, consultez la page Tester la facturation des achats in-app avec les licences d'application.

Les testeurs de licence offrent les avantages suivants :

  • En règle générale, la bibliothèque Google Play Billing n'est pas accessible aux applications qui ne sont pas signées ni importées dans Google Play. Les testeurs de licence peuvent ignorer cette vérification. Vous pouvez télécharger des applications indépendamment pour les tests, même pour des applications qui utilisent des versions de débogage avec des signatures de débogage, sans avoir à les importer dans la nouvelle version de votre application. Notez que le nom du package doit correspondre à celui de l'application configurée pour Google Play et que le compte Google doit être un testeur de licence pour le compte Google Play Console.
  • Les testeurs de licence ont accès à des modes de paiement test qui leur évitent d'avoir à payer de l'argent réel pour les achats. Ces modes de paiement test permettent également de simuler certaines situations (un refus de paiement, par exemple). La figure 1 illustre les modes de paiement test tels qu'ils apparaissent dans le parcours d'achat.
  • Les testeurs de licence peuvent tester rapidement les fonctionnalités d'abonnement.
Les testeurs de licence ont accès à des modes de paiement test.
Figure 1. Les testeurs de licence ont accès à des modes de paiement test

Voici quelques informations supplémentaires sur le processus d'achat en mode test :

  • Les achats en mode test suivent le même processus que les achats réels.
  • Les taxes ne sont pas calculées pour les achats en mode test.
  • Google Play indique les achats en mode via une notification affichée au centre de la boîte de dialogue d'achat.

Pour confirmer le compte qui effectue un achat, développez la boîte de dialogue d'achat. Notez les points suivants :

  • Les comptes de test doivent être installés sur l'appareil Android du testeur.
  • Si l'appareil est associé à plusieurs comptes, l'achat est effectué avec le compte qui a téléchargé l'application.
  • Si aucun des comptes n'a téléchargé l'application, l'achat est effectué avec le premier compte.

Avant de distribuer votre application, vous pouvez utiliser les canaux de test Google Play afin d'effectuer une validation supplémentaire. Par exemple, vous pouvez utiliser des canaux de test pour que votre équipe de contrôle qualité puisse qualifier une nouvelle version.

Avec les canaux de test, les utilisateurs peuvent installer votre application à partir de Google Play et tester une version de votre application qui n'est pas encore accessible à tous. Les utilisateurs peuvent effectuer des achats réels avec n'importe quel mode de paiement sur Google Play.

Pour tester l'intégration de la bibliothèque Google Play Billing à l'aide de canaux de test, procédez comme suit :

  1. Publiez votre application dans un canal de test. Notez que quelques heures peuvent s'écouler avant qu'elle ne soit accessible aux testeurs.
  2. Assurez-vous que chaque testeur active le test de votre application. L'URL d'activation de votre test indique aux testeurs en quoi consiste leur rôle et leur fournit un lien d'activation.

Vous pouvez tester votre intégration sur n'importe quel appareil physique équipé d'Android 1.6 ou version ultérieure. La dernière version de l'application Google Play doit y être installée. Pour obtenir des informations générales sur la configuration d'un appareil destiné au développement d'applications Android, consultez la section Utiliser des appareils physiques.

Tester les produits ponctuels

Tester les produits consommables

Lorsque vous testez des produits consommables, nous vous recommandons de tester différentes situations, y compris les suivantes :

  • Achat réussi pour lequel l'utilisateur reçoit un article. Avec un testeur de licence, vous pouvez utiliser le mode de paiement Instrument de test, toujours approuvé.
  • Achat pour lequel le mode de paiement n'a pas pu être débité et pour lequel l'utilisateur n'a donc pas reçu l'article. Avec un testeur de licence, vous pouvez utiliser le mode de paiement Instrument de test, toujours refusé.
  • Assurez-vous que les articles peuvent être achetés plusieurs fois.

Vous devez également vérifier que les achats sont correctement confirmés, comme décrit dans la section Traiter les achats. Les achats effectués par des testeurs de licence sont remboursés au bout de trois minutes si votre application ne les confirme pas, et vous recevez un e-mail d'annulation. Vous pouvez également consulter l'onglet Commandes dans la Google Play Console pour voir si une commande a été remboursée au bout de trois minutes.

Tester les produits non consommables

Les produits non consommables doivent être testés de la même manière que les produits consommables, mais vous devez vous assurer qu'un article ne peut pas être acheté à nouveau dans votre application. Veillez à vérifier la confirmation d'achat des produits non consommables et des produits consommables (le cas échéant), car la logique de traitement de chacun des deux types d'achats varie.

Tester les achats en attente

Vous devez tester les achats en attente. Dans ce cas, l'article est accordé lorsque l'état de l'achat passe à PURCHASED. Les testeurs de licence ont accès à deux instruments de test pour les modes de paiement retardés. Le paiement est effectué ou annulé automatiquement au bout de quelques minutes.

  1. Effectuez un achat avec un mode de paiement retardé "Carte test lente, refus après quelques minutes", comme illustré dans la figure 2. Redémarrez l'application et vérifiez que l'achat n'a pas été accordé.

    Tester un achat avec une carte test lente refusée
    Figure 2. Tester un achat avec une carte test lente refusée

  2. Effectuez un achat avec un mode de paiement retardé "Carte test lente, approbation après quelques minutes", comme illustré dans la figure 3. Attendez quelques minutes, puis vérifiez que l'achat a été accordé.

    Tester un achat avec une carte test lente approuvée
    Figure 3. Tester un achat avec une carte test lente approuvée

Pour en savoir plus, consultez Gérer les transactions en attente.

Tester les fonctionnalités spécifiques aux abonnements

Le parcours d'achat des produits ponctuels et des abonnements est similaire. Toutefois, les abonnements présentent des scénarios supplémentaires, comme le renouvellement ou le refus. Pour tester les renouvellements, vous pouvez utiliser les modes de paiement Instrument de test, toujours approuvé et Instrument de test, toujours refusé disponibles pour les testeurs de licence, comme indiqué dans la figure 1. Utilisez ces instruments de paiement pour tester des scénarios au-delà du scénario d'abonnement réussi.

Comme avec les produits ponctuels, vous devez également vérifier que les achats sont correctement confirmés, tel que décrit dans la section Traiter les achats. Les achats effectués par des testeurs de licence sont remboursés au bout de trois minutes si votre application ne les confirme pas, et vous recevez un e-mail d'annulation. Vous pouvez également consulter l'onglet "Commandes" dans la Google Play Console pour voir si une commande a été remboursée au bout de trois minutes.

Périodes de renouvellement

Les abonnements de test sont renouvelés plus rapidement que les abonnements réels, et peuvent être renouvelés jusqu'à six fois.

Le tableau suivant répertorie les délais de renouvellement des tests pour des abonnements de différentes durées. Ces délais sont approximatifs. Vous pourrez constater de légères variations de la durée exacte d'un événement. Pour compenser ces variations, appelez l'API afin d'afficher l'état actuel après chaque date d'expiration de l'abonnement.

Période de l'abonnement en production Renouvellement de l'abonnement test
1 semaine 5 minutes
1 mois 5 minutes
3 mois 10 minutes
6 mois 15 minutes
1 an 30 minutes

Les fonctionnalités d'abonnement limitées dans le temps, telles que les essais gratuits, sont également raccourcies pour les tests. Le tableau suivant identifie les périodes de test associées à ces fonctionnalités :

Fonctionnalité Période de test
Confirmation d'achat 5 minutes
Essai gratuit 3 minutes
Période du prix découverte Identique à la période de test de l'abonnement
Délai de grâce (3 et 7 jours) 5 minutes
Blocage de compte 10 minutes
Suspension (1 mois) 5 minutes
Suspension (2 mois) 10 minutes
Suspension (3 mois) 15 minutes

Scénarios de test

Cliquez sur Afficher/Masquer pour développer la section suivante et afficher les scénarios de test à utiliser pour vérifier l'intégration de votre abonnement.

Tester les codes promotionnels

Vous pouvez utiliser la Google Play Console afin de créer des codes pour vos propres tests. N'oubliez pas que vous ne pouvez créer que 500 codes promotionnels par trimestre pour tous les produits gérés d'une application.

Vous devez tester les scénarios d'utilisation des codes promotionnels suivants :

  • Scénario où le code promotionnel est saisi dans la boîte de dialogue d'achat lancée dans votre application
  • Scénario où le code promotionnel est utilisé dans l'application Google Play Store
  • Scénario où le code promotionnel est utilisé sur la page https://play.google.com/store via le bouton Utiliser dans le menu de navigation de gauche

Dans ces scénarios, testez l'utilisation des codes de toutes les manières possibles. Nous vous recommandons d'effectuer au moins les tests suivants :

  • Utilisation d'un code avant l'installation de l'application.
  • Utilisation d'un code lorsque l'application est exécutée au premier plan. Notez que dans ce cas, vous avez besoin d'un autre appareil afin de tester l'utilisation de l'application Google Play Store. Assurez-vous de tester l'utilisation des codes promotionnels sur différents écrans de votre application.
  • Utilisation d'un code avec le mode multifenêtre pour afficher votre application et l'application Google Play Store en même temps.

Pour chaque test, assurez-vous que l'article est correctement détecté et que l'utilisateur est notifié.