# Achats intégrés iOS & Android

> Découvrez comment proposer du contenu supplémentaire via des achats intégrés avec le composant Achat intégré PandaSuite pour les applications mobiles iOS et Android.

https://docs.pandasuite.com/fr/essentials/components/in-app-purchase-ios-and-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 sur Google Play.**

> **Attention**
>
> **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, Multi, Full ou Ultra)
- Créé votre application sur [App Store Connect](https://docs.pandasuite.com/fr/essentials/mobile-publishing/ios/add-a-new-app-to-app-store-connect/) pour iOS
- Créé votre application sur [Google Play Console](https://docs.pandasuite.com/fr/essentials/mobile-publishing/android/create-your-app-on-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.

> **Info**
>
> **Tester les achats intégrés :** Vous pouvez simuler des achats dans
> l'aperçu de PandaSuite Studio ou dans PandaSuite Viewer pour des vérifications
> rapides en phase de conception. Pour un test de bout en bout du parcours
> d'achat, utilisez
> [TestFlight](https://docs.pandasuite.com/fr/essentials/mobile-publishing/ios/test-your-ios-app-with-testflight/)
> sur iOS et une piste de test interne/fermée sur Google Play.

### Apple Store

Rendez-vous sur [App Store Connect](https://appstoreconnect.apple.com/). 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](https://developer.apple.com/in-app-purchase/).

Ajoutez un nom de référence et un identifiant de produit. Cet identifiant de produit sera requis dans le composant Achat intégré.

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](https://play.google.com/console), sélectionnez votre application et choisissez **Monétisation** > **Produits** > **Produits in-app**.

Pour en savoir plus, consultez la [documentation Google Play Billing](https://developer.android.com/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é.

> **Attention**
>
> ⚠️ **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 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`)
- **Est payé** : Booléen qui passe à `true` dès que l'utilisateur actuel dispose d'un achat actif pour ce produit
- **N'est pas payé** : Booléen qui reste à `true` tant que l'utilisateur n'a pas finalisé l'achat (toujours l'inverse de **Est payé**)

### 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)

[Image : Fenêtre Action du composant Achat intégré, placé au niveau du projet : ses six déclencheurs, de Non Acheté à Erreur de paiement, encadrés]

### 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

[Image : Agir sur un composant (Achat intégré) depuis un bouton Unlock all 4 tracks : Acheter, Restaurer l'achat et Gérer les 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** — Pour les achats intégrés consommables et non consommables
  - **Abonnement** — Pour les abonnements à renouvellement automatique

[Image : Composant Achat intégré au niveau du projet : ID Produit com.gardenguide.audio et liste Type ouverte sur Abonnement ou InApp]

> **Astuce**
>
> **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 l'onglet **Actions**.

Choisissez **Tape/Clic** et l'action **Agir sur un composant**. Sélectionnez le composant **Achat intégré** et choisissez l'action **Acheter**. Si le composant est au niveau du projet, cliquez sur l'icône de la maison au-dessus de l'écran, puis sur le composant dans la liste des objets.

[Image : Action du bouton Unlock all 4 tracks : Tape/Clic puis Agir sur un composant (Achat intégré), avec Acheter encadré]

### Débloquer le contenu après l'achat

Sélectionnez le composant **Achat intégré** et ouvrez l'onglet **Actions**.

[Image : Déclencheurs du composant Achat intégré, avec Acheté encadré : il débloque le contenu premium une fois l'achat confirmé]

Choisissez le déclencheur **Acheté** et créez une action pour débloquer votre contenu premium (par ex. **Changer d'écran**, **Ouvrir la 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 :

1. Ajoutez un composant **Texte** à l'endroit où vous souhaitez afficher le prix
2. Sélectionnez le composant texte et ouvrez le panneau **Propriétés**
3. Cliquez sur le libellé **Contenu** pour le lier à une donnée
4. Sélectionnez votre composant **Achat intégré** comme source de données
5. 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.

### Contrôler l'affichage via l'état d'achat

Utilisez ces booléens exposés pour masquer ou remplacer l'interface selon l'état d'achat :

1. Regroupez vos éléments premium dans un même composant parent (groupe, conteneur, état ou pop-up) afin de ne gérer qu'une seule propriété
2. Sélectionnez ce parent, ouvrez le panneau **Propriétés** et réglez **Visible** sur **Non** afin que les non-acheteurs ne le voient pas par défaut
3. Cliquez sur le libellé **Visible** (l'icône de liaison de données apparaît au survol), choisissez votre composant **Achat intégré** et liez la propriété **Est payé**
4. (Optionnel) Liez la bannière d'upsell ou le bouton d'achat à la propriété **N'est pas payé** pour qu'elle apparaisse automatiquement chez les utilisateurs qui doivent encore acheter

[Image : Fenêtre Données de la propriété Visible du bouton Unlock all 4 tracks : chemin Achat intégré › N'est pas payé, un booléen à vrai pour l'instant]

Lors des tests ou après le déclencheur **Acheté**, le composant lié devient visible dès que le store confirme la transaction. Cette méthode survit aussi aux redémarrages, car le composant réévalue automatiquement le booléen au chargement. Besoin d'un rappel sur la liaison de données ? Consultez [Liaison de données](https://docs.pandasuite.com/fr/essentials/data/data-binding/).

## Tester les achats intégrés

### Tester avec PandaSuite Viewer (simulation)

Utilisez le simulateur intégré pour valider votre interface et votre logique sans vous connecter aux stores :

1. Utilisez l'aperçu dans PandaSuite Studio, ou installez la dernière version de PandaSuite Viewer sur votre appareil (iOS/Android) ou utilisez le Viewer web.
2. Dans votre app, déclenchez l'action **Acheter** comme le ferait un utilisateur.
3. Un menu de simulation apparaît ; choisissez l'événement à simuler (succès d'achat, erreur).
4. Vérifiez que vos écrans, conditions et messages réagissent correctement (déblocage du contenu, messages de retour, etc.).

[Image : Menu de simulation d'achat pour test-inapp, pas encore acheté, avec les boutons Achat réussi et Achat annulé/erreur]

> **Info**
>
> La simulation vous aide à itérer rapidement sur le design et la logique. Vous
> devez néanmoins tester les parcours réels des stores iOS et Android via les
> sections ci-dessous. Les achats simulés ne sont pas des transactions réelles.

#### Événements de simulation

Le menu de simulation reflète les déclencheurs du composant afin de tester chaque scénario. Ses boutons, tels que les affiche PandaSuite Viewer sur iOS et Android (dans l'aperçu du Studio et le Viewer web, le menu affiche **Simuler achat réussi** et **Simuler erreur**) :

- **Achat réussi**, qui déclenche **Paiement réussi**, pour confirmer vos écrans de succès et le déclencheur **Acheté**
- **Achat annulé/erreur**, qui déclenche **Erreur de paiement**, pour valider vos messages d'erreur et conserver l'état **Non Acheté**

Chaque option met immédiatement à jour les booléens exposés (**Est payé**, **N'est pas payé**) et les déclencheurs du composant. Vos liaisons de données, états d'écran ou logique du [composant Condition](https://docs.pandasuite.com/fr/essentials/components/condition/) réagissent ainsi comme en production. Relancez l'action **Acheter** dès que vous souhaitez rouvrir le menu et tester un autre parcours, ou utilisez l'action réelle **Restaurer l'achat** pour simuler une restauration.

### Tests iOS avec TestFlight

Tester les achats intégrés sur iOS utilise l'environnement **Sandbox** d'Apple, qui simule l'App Store sans traiter de vrais paiements.

#### Étape 1 : Créer des testeurs Sandbox dans App Store Connect

1. Allez sur [App Store Connect](https://appstoreconnect.apple.com/)
2. Naviguez vers **Utilisateurs et accès** > **Sandbox**
3. Cliquez sur **+** pour ajouter un nouveau compte Sandbox Apple ([documentation Apple](https://developer.apple.com/help/app-store-connect/test-in-app-purchases/create-a-sandbox-apple-account))
4. Entrez une adresse email unique (qui ne doit PAS être associée à un Apple ID existant)
5. Définissez le territoire App Store et créez un mot de passe

> **Info**
>
> Vous pouvez créer jusqu'à 10 000 comptes Sandbox. Ces comptes sont uniquement
> pour les tests et ne peuvent pas accéder au véritable App Store.

#### Étape 2 : Configurer le compte Sandbox sur votre appareil

1. Sur votre appareil iOS, allez dans **Réglages** > **App Store**
2. Faites défiler jusqu'à **Compte Sandbox** et connectez-vous avec vos identifiants Sandbox
3. Vous n'avez PAS besoin de vous déconnecter de votre Apple ID habituel

> **Attention**
>
> La section **Compte Sandbox** n'apparaît que sur les appareils avec le Mode
> développeur activé ou après avoir installé un build de développement via Xcode
> ou TestFlight.

#### Étape 3 : Charger votre app sur TestFlight

1. Compilez et archivez votre app dans Xcode
2. Chargez-la sur [App Store Connect](https://docs.pandasuite.com/fr/essentials/mobile-publishing/ios/test-your-ios-app-with-testflight/)
3. Ajoutez des testeurs et distribuez le build via TestFlight

#### Étape 4 : Tester les achats

1. Installez l'app depuis TestFlight
2. Lancez un achat intégré — l'environnement Sandbox gère la transaction
3. Confirmez avec le mot de passe de votre compte Sandbox (ou Face ID/Touch ID)
4. Vérifiez que votre app débloque correctement le contenu

> **Astuce**
>
> **Les renouvellements d'abonnement sont accélérés** en Sandbox : un abonnement
> mensuel se renouvelle toutes les 5 minutes, et un abonnement annuel se
> renouvelle toutes les heures. Cela vous aide à tester rapidement les scénarios
> de renouvellement.

#### Gérer les paramètres du compte Sandbox

Dans App Store Connect sous **Utilisateurs et accès** > **Sandbox**, vous pouvez ([documentation Apple](https://developer.apple.com/help/app-store-connect/test-in-app-purchases/manage-sandbox-apple-account-settings)) :

- **Effacer l'historique des achats** — Réinitialiser tous les achats pour tester à nouveau l'état « non acheté »
- **Ajuster le taux de renouvellement** — Contrôler la vitesse de renouvellement des abonnements pendant les tests
- **Activer les achats interrompus** — Simuler des scénarios comme les mises à jour de moyen de paiement

> **Astuce**
>
> Testez minutieusement les actions **Acheter** et **Restaurer l'achat**. Apple
> exige une option de restauration visible pour les achats non consommables et
> les abonnements.

### Tests Android avec Google Play

Tester les achats intégrés sur Android nécessite deux configurations distinctes dans Google Play Console : les **Tests de licence** (pour éviter les vrais paiements) et une **piste de test interne** (pour distribuer votre app aux testeurs).

#### Étape 1 : Configurer les Tests de licence (niveau compte)

Les Tests de licence permettent à certains comptes Google d'effectuer des achats de test sans être débités. Ce paramètre s'applique à **toutes les apps** de votre compte développeur ([documentation Google](https://developer.android.com/google/play/billing/test#license-testers)).

1. Allez sur [Google Play Console](https://play.google.com/console)
2. Naviguez vers **Paramètres** > **Tests de licence**
3. Créez une liste d'e-mails avec les comptes Google de vos testeurs (les mêmes comptes utilisés sur leurs appareils de test)
4. Cochez la liste pour l'activer

[Image : Page Tests de licence des paramètres de Google Play Console : la liste d'e-mails PandaSuite est cochée pour en faire des testeurs]

> **Attention**
>
> L'appareil du testeur doit être connecté avec le **compte Google exact**
> ajouté aux Tests de licence. Sinon, de vrais paiements seront effectués.

#### Étape 2 : Configurer le test interne (niveau app)

Le test interne vous permet de distribuer votre app à jusqu'à 100 testeurs qui peuvent l'installer directement depuis Google Play ([documentation Google](https://support.google.com/googleplay/android-developer/answer/9845334)).

1. Dans Play Console, sélectionnez votre app
2. Allez dans **Tests et publication** > **Tests internes**
3. Cliquez sur l'onglet **Testeurs**
4. Créez une liste d'e-mails ou sélectionnez-en une existante avec vos testeurs
5. Chargez un fichier AAB signé dans l'onglet **Versions** et publiez

[Image : Onglet Testeurs des Tests internes dans Google Play Console : la liste d'e-mails PandaSuite est cochée pour choisir ses testeurs]

Une fois publié, partagez l'**URL d'inscription** avec vos testeurs. Ils doivent cliquer sur le lien et accepter de devenir testeurs avant de pouvoir installer l'app depuis Google Play.

> **Info**
>
> Attendez quelques heures après avoir créé de nouveaux produits pour qu'ils se
> propagent. Les informations produit doivent être disponibles avant de tester
> les achats.

#### Étape 3 : Tester les achats

1. Installez l'app depuis Google Play sur l'appareil du testeur (connecté avec un compte Tests de licence)
2. Lancez un achat intégré dans l'app
3. La boîte de dialogue Google Play affiche « Commande test » — aucun paiement réel n'est traité
4. Vérifiez que votre app gère correctement l'achat

> **Astuce**
>
> Les abonnements de test ont des **périodes de renouvellement accélérées** en
> mode test (par ex., un abonnement mensuel se renouvelle toutes les 5 minutes)
> pour vous aider à tester rapidement les scénarios de renouvellement.

### 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** (iOS uniquement) : Testez la fonctionnalité de restauration — requis pour l'App Store
- **Déjà acheté** : Tentez d'acheter à nouveau le même article
- **Achat annulé** : Annulez pendant le flux de paiement

## Dépannage

Utilisez cette checklist lorsque le flux d'achat intégré ne se comporte pas comme prévu sur appareil, dans TestFlight ou pendant la validation App Review.

### Un tap sur **Acheter** ne déclenche pas l'acte d'achat sur iOS

Vérifiez les points suivants dans cet ordre :

1. Confirmez que l'**ID Produit** dans PandaSuite correspond exactement à l'identifiant créé dans App Store Connect
2. Ouvrez **Business** > **Contracts** dans App Store Connect et vérifiez que le contrat des apps payantes est actif ([documentation Apple](https://developer.apple.com/help/app-store-connect/manage-agreements/view-agreements-status), [signer ou mettre à jour les accords](https://developer.apple.com/help/app-store-connect/manage-agreements/sign-and-update-agreements/))
3. Complétez toutes les étapes **Tax**, **Banking** ou d'accord de compte encore en attente dans App Store Connect
4. Pour un premier abonnement, assurez-vous qu'il est bien rattaché à la version de l'app actuellement soumise à Apple ([documentation Apple](https://developer.apple.com/help/app-store-connect/manage-submissions-to-app-review/submit-an-in-app-purchase))
5. Attendez que les changements App Store Connect se propagent avant de tester à nouveau

> **Attention**
>
> Si le contrat des apps payantes ou les accords de compte associés sont
> manquants, StoreKit peut considérer le produit comme indisponible même si
> votre configuration PandaSuite est correcte.

### Le produit est signalé comme invalide ou indisponible

Si les logs de l'appareil mentionnent un identifiant de produit invalide, le problème vient généralement de la configuration du store plutôt que du composant PandaSuite.

Vérifiez que :

- Le même **ID Produit** est utilisé dans PandaSuite, App Store Connect et Google Play Console
- L'identifiant est écrit en minuscules pour rester compatible entre iOS et Android
- Les métadonnées de l'achat intégré sont entièrement enregistrées dans la console du store et que le statut du produit permet sa soumission ou sa revue ([documentation Apple](https://developer.apple.com/help/app-store-connect/reference/in-app-purchase-statuses))
- Le produit est bien rattaché à la bonne application et au bon bundle ID
- Vous testez un vrai flux store avec TestFlight/Sandbox sur iOS ou une piste de test interne sur Google Play

### La popup d'achat s'affiche avec un délai

Un délai peut apparaître pendant que le store charge les détails produit, surtout en environnement sandbox. Pour réduire la sensation de latence :

- Ajoutez le composant **Achat intégré** au niveau du projet afin qu'il soit chargé le plus tôt possible
- Affichez un indicateur de chargement ou désactivez temporairement le bouton d'achat pendant la connexion au store
- Testez sur un appareil réel, car Sandbox et TestFlight peuvent être plus lents que la production

### L'utilisateur ferme la popup Apple ou Google

Fermer la popup de paiement est une action normale. Traitez ce cas comme un achat annulé, et non comme une erreur bloquante :

- Gardez le contenu premium verrouillé
- Laissez l'utilisateur réessayer plus tard
- Évitez d'afficher un message d'erreur alarmant si le seul résultat est une annulation utilisateur

### **Restaurer l'achat** ne débloque pas le contenu

Vérifiez que :

- L'achat a bien été effectué avec le même Apple ID ou compte Google que celui utilisé pour le test
- Le produit est un non consommable ou un abonnement
- Une action visible **Restaurer l'achat** existe dans votre app pour la validation iOS
- Vos écrans premium réagissent soit au déclencheur **Acheté**, soit à la propriété exposée **Est payé**

## Voir aussi

- [Publier sur l'Apple App Store](https://docs.pandasuite.com/fr/essentials/mobile-publishing/ios/publish-on-the-apple-app-store/)
- [Publier sur Google Play Store](https://docs.pandasuite.com/fr/essentials/mobile-publishing/android/publish-on-google-play-store/)
- [Tester votre app iOS avec TestFlight](https://docs.pandasuite.com/fr/essentials/mobile-publishing/ios/test-your-ios-app-with-testflight/)
- [Utiliser PandaSuite Viewer](https://docs.pandasuite.com/fr/essentials/project-management/test-your-project-with-panda-suite-viewer/)
- [Actions interactives](https://docs.pandasuite.com/fr/essentials/interactions/interactive-actions/)
- [Déclencheurs](https://docs.pandasuite.com/fr/essentials/interactions/triggers/)
