Achats intégrés iOS & Android
Offrez un contenu additionnel après un achat intégré directement depuis votre application et publiez votre app sur l’App Store d’Apple et de Google.
Compatible uniquement sur mobile : Ce composant ne fonctionne que pour une application mobile déployée sur l’App Store d’Apple et le Play Store.
Prérequis
Avant de configurer les achats intégrés, vous devez avoir :
- Une formule PandaSuite qui prend en charge la publication d’applications mobiles (formule Single, Full ou Multi)
- Créé votre application sur App Store Connect pour iOS
- Créé votre application sur Google Play Console pour Android
Créer un achat intégré
Chaque achat intégré possède un identifiant unique associé à votre application. Cet identifiant doit être créé sur App Store Connect et Google Play.
Tester les achats intégrés : Vous ne pouvez pas tester les transactions d’achat dans PandaSuite Viewer. Pour iOS, vous devez utiliser TestFlight pour tester l’expérience utilisateur complète. Pour Android, vous devez tester avec un fichier APK signé.
Apple Store
Rendez-vous sur App Store Connect. Sélectionnez votre app et dans le menu de gauche sous Achats intégrés, cliquez sur Gestion.
Cliquez sur le + pour ajouter un achat intégré.
Choisissez le type d’achat intégré :
- Consommable
- Non consommable
- Abonnement avec renouvellement automatique
- Abonnement sans renouvellement automatique.
Si vous ne savez pas lequel choisir, veuillez vous référer à la documentation Apple sur les achats intégrés.
Ajoutez un nom de référence et un identifiant de produit. Cet identifiant de produit sera requis dans le composant Achat intégré.
⚠️ Attention à ne pas utiliser de majuscules pour l’identifiant de produit
Sur Google Play, seuls les identifiants entièrement en minuscules et sans caractères spéciaux sont autorisés. Pour éviter tout problème de compatibilité lors d’une future publication sur Android, nous vous conseillons donc de définir vos identifiants d’achats intégrés directement en minuscules, y compris pour la version iOS.
Choisissez le tarif dans la liste : 0,99/1,99/2,99/3,99…
Cliquez sur Sauvegarder.
Connect Play Developer
Rendez-vous sur Google Play Console, sélectionnez votre application et choisissez Monétisation > Produits > Produits in-app.
Pour en savoir plus, consultez la documentation Google Play Billing.
Cliquez sur Add new product et choisissez entre : Managed Product, Unmanaged product et Subscription.
Remplissez le champ Product ID et choisissez le même qu’Apple. Pour rappel, cet identifiant de produit sera requis dans le composant Achat intégré.
Choisissez le prix.
Caractéristiques du composant
Propriétés
- ID Produit : L’identifiant unique de votre achat intégré, créé dans App Store Connect et Google Play Console
- Type : Le type d’achat intégré (InApp pour les achats standards, Abonnement pour les abonnements)
Propriétés exposées
Le composant expose les données suivantes qui peuvent être liées à d’autres composants :
- Prix : Le prix du produit formaté avec la devise locale de l’utilisateur (par ex. “2,99 €”, “$2.99”)
Déclencheurs
- Non Acheté : Le contenu n’a pas été acheté (état persistant qui reflète l’état d’achat actuel)
- Non Acheté (en attente) : L’achat est en attente de confirmation (Android uniquement, pour les méthodes de paiement différé comme les virements bancaires)
- Acheté : L’achat est confirmé (état persistant qui reflète l’état d’achat actuel)
- Paiement réussi : Une transaction de paiement vient de réussir (événement ponctuel déclenché immédiatement après le paiement)
- Paiement en attente : Le paiement est en cours de traitement (Android uniquement, pour les méthodes de paiement asynchrones nécessitant une approbation)
- Erreur de paiement : Une transaction de paiement a échoué (événement ponctuel déclenché en cas d’échec du paiement)
Actions
- Acheter : Lance le flux d’achat intégré
- Restaurer l’achat : Restaure les achats précédents (requis pour la validation iOS)
- Gérer les abonnements : Ouvre la page de gestion des abonnements
Implémenter l’achat intégré dans votre application
Ajouter le composant Achat intégré
Préparez vos écrans pour votre flux d’achat intégré.
Cliquez sur Composants et ajoutez le composant Achat intégré. C’est un composant non graphique, il apparaît uniquement dans la liste des Objets.
Dans le panneau Propriétés, configurez les éléments suivants :
- ID Produit : L’identifiant unique que vous avez créé dans App Store Connect et Play Developer Console
- Type : Sélectionnez le type qui correspond à votre configuration d’achat intégré :
- InApp (par défaut) - Pour les achats intégrés consommables et non consommables
- Abonnement - Pour les abonnements à renouvellement automatique
Bonne pratique : Ajoutez le composant Achat intégré au niveau du projet (et non dans un écran spécifique). Cela garantit que le composant est toujours chargé et que l’état d’achat est disponible sur tous les écrans, peu importe où l’utilisateur navigue dans votre application.
Déclencher l’acte d’achat
Sélectionnez le bouton ou l’élément interactif qui déclenchera l’achat et ouvrez le panneau Interactivités.
Choisissez Simple tap et l’action Agir sur le composant. Sélectionnez le composant Achat intégré et choisissez l’action Acheter.
Débloquer le contenu après l’achat
Sélectionnez le composant Achat intégré et rendez-vous dans le panneau Interactivités.
Choisissez le déclencheur Acheté et créez une action pour débloquer votre contenu premium (par ex. Aller à un écran, Ouvrir une pop-up).
Vous pouvez également utiliser les déclencheurs Paiement réussi et Erreur de paiement pour afficher des messages de retour à l’utilisateur.
Afficher le prix localisé
Pour afficher le prix du produit dans votre application :
- Ajoutez un composant Texte à l’endroit où vous souhaitez afficher le prix
- Sélectionnez le composant texte et ouvrez le panneau Propriétés
- Cliquez sur l’icône Liaison de données à côté de la propriété Texte
- Sélectionnez votre composant Achat intégré comme source de données
- Choisissez Prix parmi les propriétés disponibles
Le prix se mettra à jour automatiquement une fois que les informations du produit seront chargées depuis le store.
Tester les achats intégrés
Vous ne pouvez pas tester les achats intégrés dans PandaSuite Viewer. Les tests doivent être effectués avec des builds compilés sur des appareils réels ou simulateurs en utilisant les méthodes ci-dessous.
Tests iOS avec TestFlight
Pour tester les achats intégrés sur iOS :
- Chargez votre app sur TestFlight
- Créez des utilisateurs de test sandbox dans App Store Connect sous Utilisateurs et accès > Testeurs sandbox (documentation Apple)
- Utilisez un email unique qui n’est PAS associé à un Apple ID existant
- Ces comptes sont uniquement pour les tests et ne peuvent pas accéder au véritable App Store
- Déconnectez-vous de votre Apple ID habituel sur votre appareil de test (Réglages > App Store)
- Installez l’application via TestFlight
- Lorsqu’un achat est demandé, connectez-vous avec votre compte de test sandbox
- Complétez le flux d’achat (aucun frais réel ne sera prélevé)
Les comptes de test sandbox peuvent effectuer des achats de test illimités. Vous pouvez réinitialiser les achats d’un testeur sandbox dans App Store Connect pour tester à nouveau l’état “non acheté”.
Tests Android
Pour tester les achats intégrés sur Android :
- Créez un fichier APK ou AAB signé
- Chargez-le dans la Play Console en tant que test interne ou test fermé
- Ajoutez des utilisateurs de test sous Configuration > Tests de licence (documentation Google)
- Les utilisateurs de test interne doivent être ajoutés à votre liste de testeurs
- Les tests fermés nécessitent que les utilisateurs acceptent un lien d’invitation
- Attendez quelques heures pour que les informations produit se propagent (surtout pour les nouveaux produits)
- Installez l’application depuis le Play Store sur votre appareil de test
- Testez le flux d’achat avec votre compte de test
Les testeurs de licence peuvent effectuer des achats de test sans frais réels. Vous pouvez également tester avec des cartes de test pour des scénarios de paiement plus réalistes.
Scénarios de test importants
Testez les scénarios suivants pour garantir une gestion appropriée :
- Flux d’achat : Complétez un achat standard avec succès
- Restaurer les achats : Testez la fonctionnalité de restauration (requise pour l’approbation sur l’App Store iOS)
- Déjà acheté : Tentez d’acheter à nouveau le même article
- Achat annulé : Annulez pendant le flux de paiement
- Interruption réseau : Testez avec une mauvaise connectivité
- Paiements en attente : Pour Android, testez avec des méthodes de paiement asynchrones si applicable
Testez minutieusement les actions Acheter et Restaurer l’achat. Apple exige une option de restauration visible pour les achats non consommables et les abonnements.