Vendre des produits intégrés (IAP)

1📥 Obtenez le guide + l'application de démonstration fonctionnelle#

Tout ce guide existe aussi en PDF à lire hors ligne, ainsi qu'une application de démonstration complète que vous pouvez compiler et exécuter dès aujourd'hui.

Touchez ci-dessous et les deux sont enregistrés sur votre téléphone dans Téléchargements/AppMint/Guides :

• AppMint-InApp-Purchases-Guide.pdf - le guide complet, avec les étapes de la Play Console et les exemples React / Next.js
• iap-demo-index.html - un petit jeu qui vend trois choses : suppression des publicités (ponctuelle), un pack de niveaux (ponctuel) et un pass de saison mensuel

Pour essayer la démo : compressez iap-demo-index.html seul, importez-le dans l'assistant et suivez le guide. C'est le moyen le plus rapide de voir un vrai achat fonctionner de bout en bout avant de toucher à votre propre application.

2De quoi s'agit-il ? (en termes simples)#

Votre application peut vendre des choses (une mise à niveau Pro, des niveaux supplémentaires, un abonnement) et Google encaisse l'argent et vous le verse chaque mois.

NOUS ALLONS CONSTRUIRE ENSEMBLE UN EXEMPLE, tout au long de ce guide :

A game that sells two things
  • 'Levels 11-20'      ₹99  paid once, kept forever
  • 'Remove ads'        ₹49  every month

Vous finirez par ajouter quatre lignes à votre page. C'est tout le travail : il n'y a aucun code d'achat à écrire, et même si vous ne l'avez jamais fait, vous vous en sortirez très bien.

Vous n'avez PAS besoin de savoir programmer au-delà du copier-coller, ni d'un serveur, d'une base de données ou d'un compte chez un prestataire de paiement. Google Play s'occupe des parties difficiles :

• Affiche l'écran de paiement (carte / UPI / facturation opérateur)
• Convertit votre prix dans la devise de chaque pays
• Mémorise qui a acheté quoi, même après une réinstallation
• Envoie l'argent sur votre compte bancaire

AppMint prélève 0 % : la vente va directement sur VOTRE compte Google Play.

Fonctionne de la même façon pour Site web → APK, ZIP → APK et les applications créées par l'IA.

3Ce qu'il vous faut avant de commencer#

Seulement quatre choses :

1. Votre site web ou application HTML/ZIP (ce que vous transformez en APK).
2. Quelque chose à vendre : décidez de ce que reçoivent les acheteurs (par ex. « Version Pro » : sans limites, contenu supplémentaire).
3. Un compte développeur Google Play : frais uniques de 25 $ sur play.google.com/console. Il est nécessaire pour publier N'IMPORTE QUELLE application sur le Play Store, pas seulement les payantes.
4. Environ 1 heure au total, répartie sur les étapes ci-dessous.

Important à savoir d'emblée : les achats intégrés ne fonctionnent que lorsque votre application est installée DEPUIS le Play Store. C'est une règle de Google pour tout le monde, pas une limite d'AppMint.

4Étape 1 - Inventez votre ID de produit#

Un ID de produit est simplement un nom court que vous inventez pour ce que vous vendez. Vous saisirez ce même nom à deux endroits plus tard (votre page + la Play Console), alors gardez-le simple et notez-le.

Règles : uniquement des lettres minuscules, des chiffres et des tirets bas. Doit commencer par une lettre ou un chiffre.

Copiez l'un de ceux-ci :

• pro_unlock - mise à niveau « version Pro » (bon choix par défaut : le code ci-dessous l'utilise déjà)
• remove_ads - mise à niveau sans publicités
• level_pack_2 - pack de contenu supplémentaire
• coins_100 - pack de monnaie de jeu
• premium_monthly - abonnement mensuel

Le prix ne fait PAS partie de l'ID : vous le fixerez à l'étape 5 et pourrez le changer à tout moment sans toucher à votre code.

5Étape 2 - Étiquetez votre bouton (aucun code à écrire)#

Vous n'écrivez AUCUN code d'achat. Votre application contient déjà le moteur d'achat : vous étiquetez simplement votre propre HTML pour qu'il sache quoi vendre.

Copiez le bloc ci-dessous dans votre page et modifiez uniquement :

(1) pro_unlock → votre ID de produit, dans data-iap-buy
(2) les mots sur le bouton et dans la section payante

C'est tout. Le bouton affiche alors le vrai prix de Google dans la devise de l'acheteur, ouvre l'écran de paiement de Google au toucher, révèle la section payante après le paiement (et à chaque lancement pour ceux qui ont déjà acheté), la retire si un abonnement expire ou si un paiement est remboursé, et affiche un message clair en cas de problème.

LES QUATRE LIBELLÉS :

• data-iap-buy="id" - fait de ce bouton le bouton d'achat (obligatoire)
• data-iap-label="…{price}…" - texte du bouton ; {price} devient le vrai prix Google
• data-iap-owned="…" - texte du bouton après l'achat
• data-iap-show - une section qui n'apparaît qu'après l'achat (démarrez-la en « hidden »)

Également disponibles : data-iap-hide (disparaît après l'achat), data-iap-container (un conteneur qui n'apparaît que dans l'application), data-iap-text (à placer sur le <span> qui contient le texte si votre bouton comporte aussi des icônes).

VOUS VENDEZ PLUSIEURS CHOSES DIFFÉRENTES ? Ajoutez un bouton pour chacune. Elles sont indépendantes : une application peut supprimer les publicités ET vendre des packs de niveaux ET proposer un abonnement, et l'achat de l'un n'affecte jamais les autres. Associez une section à un produit avec data-iap-show="level_pack_2".

Seuls les ID que vous saisissez dans « Supprimer les publicités (IAP) → ID de produit » désactivent les publicités. Tout le reste de ce que vous vendez débloque ce que votre page en fait, et les publicités continuent.

DEUX FORMULES POUR LA MÊME CHOSE (mensuelle et à vie) ? Donnez aux deux boutons le même data-iap-group="adfree" : acheter l'une masque l'autre, et personne ne paie deux fois. Sans groupe, rien n'est masqué, ce qui convient à des produits sans lien.

<!-- (1) CHANGE pro_unlock to your product ID -->
<button data-iap-buy="pro_unlock"
        data-iap-label="Unlock Pro — {price}"
        data-iap-owned="✓ Unlocked">
  Unlock Pro
</button>

<!-- (2) CHANGE the words. Appears only after buying. -->
<div data-iap-show hidden>
  🎉 Pro content here — visible after buying.
</div>

<!-- Optional: disappears after buying -->
<div data-iap-hide>
  Upgrade to remove the ads.
</div>

<!-- DIFFERENT THINGS: independent — buying one never affects the others -->
<button data-iap-buy="remove_ads"   data-iap-label="Remove ads — {price}">Remove ads</button>
<button data-iap-buy="level_pack_2" data-iap-label="Levels 11-20 — {price}">Get levels</button>

<div data-iap-show="level_pack_2" hidden>Levels 11-20 unlocked!</div>

<!-- SAME THING, TWO PLANS: one group, so buying either hides the other -->
<button data-iap-buy="remove_ads_monthly"  data-iap-group="adfree"
        data-iap-label="Remove ads — {price}/month"
        data-iap-owned="✓ Ad-free (monthly)">Remove ads monthly</button>

<button data-iap-buy="remove_ads_lifetime" data-iap-group="adfree"
        data-iap-label="Remove ads forever — {price}"
        data-iap-owned="✓ Ads removed forever">Remove ads forever</button>

6Les 4 choses que les gens vendent le plus souvent#

Choisissez celle qui vous correspond. La seule différence entre elles est l'endroit où vous créez le produit dans la Play Console ; le code de votre page garde toujours la même forme.

1. SUPPRIMER LES PUBLICITÉS, PAYÉ UNE FOIS (pour toujours)

Créez-le sous : Produits intégrés
Saisissez aussi l'identifiant dans : Supprimer les publicités (IAP) → ID de produit

1. SUPPRIMER LES PUBLICITÉS, CHAQUE MOIS

Créez-le sous : Abonnements
Saisissez aussi l'identifiant dans : Supprimer les publicités (IAP) → ID de produit

1. DÉBLOQUER DES NIVEAUX / DU CONTENU, PAYÉ UNE FOIS

Créez-le sous : Produits intégrés
Ne le saisissez PAS dans la case Supprimer les publicités : vos publicités continueraient de s'afficher.

1. DÉBLOQUER DES NIVEAUX / DU CONTENU, CHAQUE MOIS

Créez-le sous : Abonnements
Ne le saisissez PAS dans la case Supprimer les publicités : vos publicités continueraient de s'afficher.

Vous pouvez vendre LES QUATRE dans la même application, et autant de produits que vous le souhaitez. L'achat de l'un n'affecte jamais les autres.

<!-- 1. remove ads, paid once -->
<button data-iap-buy="remove_ads_lifetime"
        data-iap-label="Remove ads forever — {price}"
        data-iap-owned="✓ Ads removed">Remove ads forever</button>

<!-- 2. remove ads, monthly -->
<button data-iap-buy="remove_ads_monthly"
        data-iap-label="Remove ads — {price}/month"
        data-iap-owned="✓ Ad-free">Remove ads monthly</button>

<!-- 3. levels, paid once -->
<button data-iap-buy="level_pack_2"
        data-iap-label="Levels 11-20 — {price}"
        data-iap-owned="✓ Unlocked">Get levels 11-20</button>

<!-- 4. all levels, monthly -->
<button data-iap-buy="all_levels_monthly"
        data-iap-label="All levels — {price}/month"
        data-iap-owned="✓ Subscribed">Subscribe</button>

7Quels achats suppriment les publicités ?#

C'est la seule chose sur laquelle les gens se trompent, alors elle mérite 30 secondes.

Vos publicités ne font PAS partie de votre page web. Ce sont de vraies publicités Android placées par-dessus, donc rien dans votre page ne peut les désactiver. Une seule chose le peut :

wizard Step 3 → Remove Ads (IAP) → Product ID

Tout identifiant que vous saisissez dans cette case supprime les publicités lorsque quelqu'un l'achète. Tout autre identifiant que vous vendez débloque simplement ce que votre page en fait, et les publicités continuent.

Vous vendez à la fois un forfait sans publicités ET des packs de niveaux ? Saisissez uniquement l'identifiant du forfait sans publicités dans cette case. Dans notre exemple :

Product ID box:  remove_ads_monthly
NOT in the box:  level_pack_2

Vous proposez deux forfaits sans publicités (mensuel ET à vie) ? Mettez les deux dans cette même case, séparés par une virgule : posséder l'un ou l'autre supprime les publicités :

remove_ads_monthly,remove_ads_lifetime

Vous ne vendez pas du tout la suppression des publicités ? Laissez complètement cette option désactivée et utilisez simplement « 💰 Vendre des produits intégrés ».

Selling levels only:
  Remove Ads (IAP)          OFF
  Sell In-App Products      ON

Selling ad removal only:
  Remove Ads (IAP)          ON   → Product ID: remove_ads_monthly
  Sell In-App Products      ON

Selling both, with two ad-free plans:
  Remove Ads (IAP)          ON   → Product ID: remove_ads_monthly,remove_ads_lifetime
  Sell In-App Products      ON
  (level_pack_2 stays out of the box)

8Exemple complet - page HTML simple#

Voici notre application d'exemple complète : elle vend « Niveaux 11-20 » une fois, et « Supprimer les publicités » chaque mois. Copiez-la, changez les deux identifiants et les textes, et c'est terminé.

Lisez ce que fait chaque libellé :

• data-iap-buy → ce que vend ce bouton
• data-iap-label → le texte ; {price} devient le vrai prix Google
• data-iap-owned → le texte une fois le paiement effectué
• data-iap-show="level_pack_2" → ce bloc n'apparaît qu'après l'achat de CE produit
• data-iap-hide → ce bloc disparaît dès que quoi que ce soit est acheté

Remarquez qu'il n'y a ni <script> ni code d'achat. Votre application le contient déjà.

<h2>Get more levels</h2>

<button data-iap-buy="level_pack_2"
        data-iap-label="Levels 11-20 — {price}"
        data-iap-owned="✓ Levels 11-20 unlocked">
  Levels 11-20
</button>

<div data-iap-show="level_pack_2" hidden>
  🎉 Levels 11 to 20 are yours. Have fun!
</div>


<h2>Tired of ads?</h2>

<button data-iap-buy="remove_ads_monthly"
        data-iap-label="Remove ads — {price}/month"
        data-iap-owned="✓ No more ads">
  Remove ads
</button>

<div data-iap-hide>
  Ads help keep this game free.
</div>

9Exemple complet - React ou Next.js#

LA MÉTHODE FACILE : les mêmes libellés fonctionnent dans React et Next.js, car ce n'est que du balisage. Pas de useState, pas de useEffect, pas de 'use client'. Les boutons que React ajoute plus tard sont pris en compte automatiquement.

C'est tout ce dont la plupart des applications ont besoin : utilisez le premier bloc ci-dessous et arrêtez-vous là.

LA MÉTHODE CONTRÔLÉE (second bloc) : uniquement si vous voulez que React lui-même affiche le prix et change d'écran. Alors :

• Avec Next.js, mettez 'use client' en ligne 1 du fichier, sinon la compilation échoue.
• Ne touchez à window.AppMintIAP que dans useEffect : dans le corps du composant, il s'exécute côté serveur, où window n'existe pas.
• onChange(fn) vous donne l'état tout de suite et à chaque changement, et renvoie la fonction de désabonnement que React attend.
• Avec Next.js, compilez en export statique : output: 'export' dans next.config.js.

// ── EASY WAY — just JSX, nothing else ──────────────────────────
export default function Shop() {
  return (
    <>
      <button data-iap-buy="level_pack_2"
              data-iap-label="Levels 11-20 — {price}"
              data-iap-owned="✓ Unlocked">Levels 11-20</button>

      <div data-iap-show="level_pack_2" hidden>🎉 Levels 11-20 are yours!</div>
    </>
  );
}


// ── CONTROLLED WAY — React draws everything ───────────────────
'use client';                       // Next.js: must be line 1
import { useEffect, useState } from 'react';

export default function Shop() {
  const [iap, setIap] = useState({ available: false, products: {} });

  useEffect(() => {
    if (typeof window === 'undefined' || !window.AppMintIAP) return;
    window.AppMintIAP.start({
      plans: [{ id: 'level_pack_2' }, { id: 'remove_ads_monthly' }]
    });
    return window.AppMintIAP.onChange(setIap);
  }, []);

  if (!iap.available) return null;   // outside the app there is nothing to buy

  const levels = iap.products?.level_pack_2;   // always optional-chain
  return levels?.owned
    ? <p>🎉 Levels 11-20 are yours!</p>
    : <button onClick={() => window.AppMintIAP.buy('level_pack_2')}>
        Levels 11-20 {levels?.price}
      </button>;
}

10Vérification rapide dans votre navigateur#

Ouvrez votre page dans un navigateur normal (Chrome sur votre PC ou votre téléphone).

Vous devriez voir le bouton d'achat là, sans rien faire, et votre section payante toujours masquée. Les deux sont corrects : en dehors de l'application, il n'y a rien à acheter, donc rien ne peut être acheté par accident.

Dans l'application, c'est une tout autre page : le bouton reçoit le vrai prix, ouvre l'écran de paiement de Google et se masque dès que l'acheteur le possède. Votre site web continue de fonctionner normalement pour les visiteurs ordinaires dans les deux cas.

Vous voulez que l'offre disparaisse complètement sur le web ? Placez-la dans un <div data-iap-container hidden> : ce conteneur n'est révélé que dans l'application.

11Étape 3 - Activez les achats dans l'ASSISTANT#

⚠️ NE SAUTEZ PAS CETTE ÉTAPE. Si vous la sautez, vos boutons apparaissent quand même, mais chaque toucher répond « Les achats intégrés ne sont pas activés dans cette application. » et vous n'encaissez rien.

L'ASSISTANT désigne les écrans Étape 1 → Étape 2 → Étape 3 que vous utilisez pour créer votre application. Les achats se trouvent à l'ÉTAPE 3 DE L'ASSISTANT.

FAITES-LE DANS L'ORDRE :

1. Ouvrez l'assistant et allez à l'ÉTAPE 3 DE L'ASSISTANT (l'écran avec Publicités, Notifications et Autorisations).

STEPPER STEP 3 — what to set

  Ads ......................... ON  (needed to see the card below)
  💰 Sell In-App Products ..... ON  ← REQUIRED for selling anything

  Selling ad removal too?
  Remove Ads (IAP) ............ ON
  Play Store Product ID ....... remove_ads_monthly
         (two plans) .......... remove_ads_monthly,remove_ads_lifetime
  License Key ................. paste from Play Console

  Export ...................... AAB  (not APK)

12Étape 4 - Mettez votre application sur Google Play#

Dans votre Play Console (le site où les développeurs gèrent leurs applications) :

1. « Créer une application » → renseignez le nom et les questions de base.
2. Dans le menu de gauche : « Test » → « Test interne » → « Créer une version » → importez votre fichier AAB → « Enregistrer » et déployez-la.
3. Toujours dans Test interne → onglet « Testeurs » → ajoutez votre propre adresse Gmail → copiez le lien « rejoindre » pour plus tard.

Le test interne est une zone privée : personne ne peut encore voir votre application. Il existe pour que VOUS puissiez essayer les achats avant la publication.

Ouvrir la Play Console →

13Étape 5 - Créez votre produit et fixez le prix#

Dites maintenant à Google ce que vous vendez. Le menu à utiliser dépend de si les clients paient une fois ou chaque mois.

PAYÉ UNE FOIS (niveaux, Pro, pièces, suppression définitive des publicités)

1. Play Console → votre application → « Monétiser » → « Produits » → « Produits intégrés ».
2. « Créer le produit ».
3. ID de produit : saisissez EXACTEMENT l'identifiant de votre page - level_pack_2. Même orthographe, même casse. Google ne vous laisse jamais le modifier ni le réutiliser.
4. Nom : ce que voient les acheteurs, par ex. « Niveaux 11-20 ». Description : une ligne.
5. Fixez votre prix dans votre propre devise : Google le convertit pour chaque pays.
6. Appuyez sur « Activer ».

CHAQUE MOIS (suppression mensuelle des publicités, abonnement à tous les niveaux)

1. Play Console → « Monétiser » → « Produits » → « Abonnements ».
2. « Créer un abonnement ». ID de produit : remove_ads_monthly.
3. Enregistrez, puis ajoutez un PLAN DE BASE : type « Renouvellement automatique », période de facturation « Mensuelle », votre prix.
4. Appuyez sur « Activer » pour le plan de base ET pour l'abonnement lui-même. Si vous en oubliez un, votre application ne pourra pas le voir.

Répétez pour chaque identifiant utilisé. Le code de votre page ne change pas : l'application demande à Google de quel type est chaque identifiant.

VOUS VOULEZ DU MENSUEL *ET* DE L'ANNUEL ? Créez DEUX abonnements distincts (all_levels_monthly et all_levels_yearly) plutôt que deux plans de base dans un seul abonnement. Un abonnement avec plusieurs plans de base propose toujours le premier, sans moyen de choisir.

Modifiez un prix plus tard dans la Play Console : votre application affiche le nouveau prix toute seule, sans nouvelle compilation.

14Étape 6 - Testez (vous ne serez pas débité)#

1. Play Console → menu de gauche « Configuration » → « Test de licence » → ajoutez votre Gmail à la liste des testeurs.
2. Sur votre téléphone : ouvrez le lien d'accès au test interne de l'étape 4, acceptez, et installez votre application DEPUIS le Play Store.
3. Ouvrez l'application. Votre bouton d'achat apparaît avec le vrai prix.
4. Touchez-le : la fenêtre de paiement de Google s'ouvre et indique « Carte de test, toujours approuvée ». Achetez. Votre contenu pro apparaît. Vous ne payez rien.
5. Vérification bonus : désinstallez et réinstallez l'application : le contenu pro se débloque tout seul au lancement. C'est Google qui restaure l'achat.

⚠️ Si vous installez l'APK directement (sideload) au lieu de passer par le Play Store, le bouton d'achat n'apparaîtra PAS. C'est normal : testez toujours via le lien du Play Store.

15Étape 7 - Mettez en ligne et soyez payé#

1. Quand les tests sont concluants : Play Console → « Production » → créez une version avec le même AAB → déployez. (Les nouvelles applications passent par la validation de Google, généralement quelques jours.)
2. Les utilisateurs achètent dans votre application → Google encaisse l'argent.
3. Google verse l'argent sur votre compte bancaire chaque mois (Play Console → « Profil de paiements »). Google prélève ses frais de service habituels (15 % pour la plupart des développeurs). AppMint ne prélève rien.

Pour ajouter d'autres produits plus tard : ajoutez le nouvel ID dans le code de votre page, compilez une fois, et créez l'ID dans la Play Console. Les changements de prix n'exigent jamais de nouvelle compilation.

16Si quelque chose ne fonctionne pas#

Votre application vous dit ce qui n'a pas fonctionné au lieu d'échouer en silence. Trouvez le message que vous voyez :

« Les achats intégrés ne sont pas activés dans cette application. »
→ « 💰 Vendre des produits intégrés » était DÉSACTIVÉ à l'ÉTAPE 3 DE L'ASSISTANT lors de la compilation. Activez-le et compilez à nouveau.

« Cet article n'est pas encore disponible sur Google Play. »
→ Google ne reconnaît pas cet identifiant. Vérifiez-le lettre par lettre dans la Play Console, confirmez que le produit est ACTIF (pour un abonnement, le plan de base ET l'abonnement doivent tous deux être activés), et assurez-vous d'avoir installé l'application depuis le lien de testeur Play.

« Google Play n'a pas pu démarrer le paiement. »
→ L'application n'a pas été installée depuis le Play Store, ou a été signée avec une clé différente de celle que vous avez importée.

« Paiement en attente - il se débloquera automatiquement dès que Google confirmera. »
→ Rien à faire. Les modes de paiement lents (bons en espèces, certains UPI) prennent quelques minutes ; le déblocage arrive tout seul, même après un redémarrage de l'application.

AUCUN MESSAGE, rien ne se passe au toucher
→ Presque toujours une faute de frappe dans data-iap-buy, ou l'application n'est pas installée depuis Play. Toute autre cause affiche l'un des messages ci-dessus.

LE PAIEMENT A FONCTIONNÉ MAIS LES PUBLICITÉS SONT TOUJOURS LÀ
→ Cet identifiant de produit ne figure pas à l'ÉTAPE 3 DE L'ASSISTANT → « Supprimer les publicités (IAP) » → « ID de produit Play Store ». Ajoutez-le (séparez plusieurs par des virgules) et compilez à nouveau.

LE BOUTON D'ACHAT N'APPARAÎT JAMAIS DANS L'APPLICATION
→ « 💰 Vendre des produits intégrés » était désactivé lors de la compilation. Dans un navigateur web normal, les boutons sont masqués VOLONTAIREMENT : il n'y a rien à acheter en dehors de l'application.

RIEN NE S'EST PASSÉ APRÈS AVOIR FERMÉ LA FENÊTRE DE PAIEMENT DE GOOGLE
→ C'est une annulation normale. Touchez à nouveau et terminez le paiement.

LE PRIX SEMBLE ANCIEN
→ Play met les prix en cache sur un appareil pendant quelques heures. Une nouvelle installation affiche toujours le nouveau prix.

17React, Next.js ou JavaScript simple#

REACT ET NEXT.JS N'ONT BESOIN DE RIEN DE SPÉCIAL. Les libellés ci-dessus ne sont que du balisage, donc la même ligne fonctionne aussi là : pas de useState, pas de useEffect, pas de 'use client' :

<button data-iap-buy="pro_unlock"

      data-iap-label="Unlock Pro — {price}">Unlock Pro</button>

Les boutons que React monte plus tard sont trouvés automatiquement, et le remontage est sans danger. Avec Next.js, compilez en export statique (output: 'export').

Vous préférez le code aux libellés ? Une seule ligne fait le même travail :

AppMintIAP.sell('pro_unlock', '#buy-btn');

Troisième argument facultatif : {label:'Débloquer Pro - {price}', owned:'✓ Débloqué', show:'#thanks', hide:'.upsell'}. Appelez-la une fois par produit.

UNIQUEMENT SI VOUS VOULEZ QUE REACT AFFICHE LUI-MÊME LE PRIX, sinon passez cette partie :

const [iap, setIap] = useState({ available: false, products: {} });

useEffect(() => {

if (typeof window === 'undefined' || !window.AppMintIAP) return;
window.AppMintIAP.start({ plans: [{ id: 'pro_unlock' }] });
return window.AppMintIAP.onChange(setIap);

}, []);

const pro = iap.products?.pro_unlock; // toujours en chaînage optionnel

if (!iap.available) return null; // rien à acheter en dehors de l'application
if (pro?.owned) return <p>Merci !</p>;
return <button onClick={() => window.AppMintIAP.buy('pro_unlock')}>

       Unlock Pro {pro?.price}
     </button>;

DEUX HABITUDES ÉVITENT QUE CELA NE SE CASSE :

1. Lisez les droits PAR PRODUIT - iap.products?.<id>?.owned. Le iap.owned de premier niveau signifie « quelque chose est acquis » et change de sens le jour où vous vendez un second produit.
2. Utilisez le chaînage optionnel sur tout le chemin, pour qu'un champ inattendu ne puisse jamais provoquer d'erreur pendant que React affiche.

onChange vous donne {available, adFree, owned, ownedIds, products} immédiatement et à chaque changement, et renvoie une fonction de désabonnement : un acheteur qui revient est donc déjà débloqué au premier affichage. Avec Next.js, ajoutez 'use client' en ligne 1 et compilez avec output: 'export'.

Aussi : AppMintIAP.available, .isOwned(id), .owned(), .buy(id), .state(), .refresh(). Les libellés data-iap-buy fonctionnent aussi en JSX, et les boutons que React monte plus tard sont pris en compte automatiquement.

Vous préférez piloter vous-même le pont brut ? Tout ce qui précède repose sur ceci :

• iap.isOwned(id) - vrai/faux instantané, fonctionne hors ligne
• iap.getOwnedProducts() - tableau JSON de tous les ID acquis
• iap.getProducts(reqId, idsJson) - prix en direct ; le résultat arrive via l'événement 'appmint:products' {requestId, products:[{productId, title, price, currency, type, owned}]}
• iap.purchase(id) - produits ponctuels ET abonnements (détection automatique)
• Événements : 'appmint:purchase' {productId} (n'accordez QU'ICI : toucher un produit déjà acquis le redéclenche), 'appmint:owned-changed' {products} (la restauration au lancement est terminée, ou un remboursement a retiré quelque chose : relisez les droits),'appmint:purchase-failed' {reason: disabled | not_found | billing_error | pending}

Vous ne vendez qu'une seule mise à niveau « supprimer les publicités » ? Utilisez plutôt le duo intégré plus simple : activez « Supprimer les publicités (IAP) » à l'étape 3 de l'assistant :

var iap = window.WebToApk;

if (iap && !iap.isPremium()) {
  showRemoveAdsButton(function onTap() {
    iap.startRemoveAdsPurchase();
  });
}

window.addEventListener('appmint:premium', function (e) {
  if (e.detail.premium) hideRemoveAdsButton();
});

1Créer un produit géré#

Dans le tableau de bord de votre Google Play Console :

• Allez dans « Monétisation » > « Produits intégrés »
• Cliquez sur « Créer le produit »
• Saisissez un ID de produit (par ex. « remove_ads_premium »)
• Définissez un nom (par ex. « Supprimer toutes les publicités ») et une description
• Fixez le prix et cliquez sur « Enregistrer »
• Cliquez sur « Activer » pour le rendre disponible aux tests

Vous vendez la suppression des publicités sous forme d'ABONNEMENT ? Créez-la sous « Monétisation » > « Abonnements » avec un plan de base à renouvellement automatique, et activez le plan de base ET l'abonnement. L'absence de publicités dure alors tant que l'abonnement est actif, et les publicités reviennent automatiquement à son expiration.

Ouvrir la Play Console →

2Obtenez votre clé de licence#

Google Play exige une clé publique RSA pour vérifier les achats en toute sécurité.

Dans la Play Console :

• Allez dans « Monétisation » > « Configuration de la monétisation »
• Sous « Licences », copiez la « clé publique RSA encodée en Base64 »
• ⚠️ IMPORTANT : vous devrez coller ceci plus tard dans le générateur.

Example Key Format:
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...

3Configuration dans le générateur WebToApk#

Dans l'application du générateur :

1. Activez l'option « Supprimer les publicités (IAP) » à l'étape 3
2. Saisissez EXACTEMENT le même « ID de produit » que celui créé à l'étape 1
3. Collez votre « clé de licence Base64 » de l'étape 2
4. Générez votre APK/AAB

Vous proposez plus d'un forfait sans publicités (par ex. un abonnement mensuel ET un déblocage à vie) ? Mettez chaque ID de produit dans ce seul champ, séparés par des virgules : en posséder N'IMPORTE LEQUEL supprime les publicités. Le premier ID listé est celui qu'achète l'élément de menu intégré « Supprimer les publicités », alors placez votre forfait par défaut en premier.

Product ID: remove_ads_premium

Two plans:
remove_ads_monthly,remove_ads_lifetime

4Configurer les testeurs de licence#

Pour tester les achats sans dépenser d'argent réel :

• Dans la Play Console, allez dans « Configuration » > « Test de licence »
• Ajoutez votre adresse Gmail à la liste des « Testeurs de licence »
• Vérifiez que « Réponse de licence » est définie sur « RESPOND_NORMALLY »

Configurer les testeurs de licence →

5Testez en piste interne ou fermée#

Les achats intégrés ne fonctionnent QUE lorsque l'application est installée via le Play Store (pistes de test) :

1. Importez votre AAB généré dans la piste « Test interne » ou « Test fermé »
2. Partagez le lien d'accès des testeurs avec vos comptes de test
3. Téléchargez l'application depuis le Play Store
4. Touchez le bouton « Supprimer les publicités » dans votre application pour tester le déroulement !

Note: Purchases will show a 'Test instrument, always approves' message for license testers.