API d'achats intégrés

Vendez des biens numériques et des abonnements dans votre application Android WebView avec Google Play Billing.

Dans certaines applications, vous pouvez acheter des contenus ou services supplémentaires. Ce type d'achats est appelé « achats intégrés ». Ils peuvent constituer une source de revenus attrayante pour les développeurs et sont très pratiques pour les clients, car ils utilisent les comptes et moyens de paiement existants pour le règlement. WebViewGold permet de déclencher des achats intégrés Google Play. Assurez-vous de posséder une licence étendue de WebViewGold si vous prévoyez d'utiliser cette fonctionnalité dans un produit final. Besoin d'une mise à niveau ? Découvrez ici comment effectuer la mise à niveau.

Option 1 (par défaut) : RevenueCat

Créez votre compte RevenueCat gratuit pour commencer. Les informations tarifaires sont disponibles sur leur site web. Configurez ensuite RevenueCat en suivant leurs assistants de configuration et leur documentation (les détails tarifaires sont disponibles sur leur site web). Ajoutez ensuite vos informations dans Config.java. Cette approche prend également en charge le 15% Service Fee Tier Program du Google Play Store et le Small Business Program d'Apple. Si vous participez à ces programmes à frais réduits, informez-en RevenueCat via leurs pages Apple Small Business Program ou Google 15% reduced service fee. Voici à quoi ressemble la configuration dans Config.java :

public static final String REVENUECAT_API_KEY = "xxxxxxxsxxxxxxxxxxxxxxxxxxxxxxxxxx"; //Your RevenueCat API Key (sign up via tinyurl.com/register-revenuecat first, then follow tinyurl.com/api-key-revenuecat how to find it)
public static final String REVENUECAT_PROJECT_ID = "xxxxxxx"; //Your RevenueCat Project ID (sign up via tinyurl.com/register-revenuecat first, then follow tinyurl.com/project-id-revenuecat how to find it)

Assurez-vous que le nom de package de votre APK et de la Google Play Console correspond au projet configuré dans RevenueCat. Déclenchez un achat ou un abonnement à l'aide de :

revenuecat://purchase?external_id=user_123&product=sub_30_days

external_id = identifiant utilisateur, par exemple l'e-mail du client ou son identifiant utilisateur. product = identifiant affiché dans la console RevenueCat. Fonctionne à la fois pour Android et iOS.

Option 2 : Manuel (sans RevenueCat)

Nous nous engageons à aider nos clients WebViewGold à réussir et souhaitons attirer votre attention sur le 15% Service Fee Tier Program du Google Play Store et sur le Small Business Program d'Apple. Ces programmes permettent aux développeurs éligibles de bénéficier d'une commission de 15 %, une réduction significative par rapport aux 30 % standard. La demande est rapide et facile, et peut potentiellement vous faire économiser 50 % de frais en réduisant les taux de commission de Google et d'Apple de 30 % à 15 %. Une fois approuvé, vous bénéficierez du taux de commission réduit pour toutes les applications payantes et achats intégrés effectués par les clients sur les stores concernés. Pour en savoir plus sur le programme Google Play, cliquez ici, et pour le programme Apple, rendez-vous ici.

Après la configuration, pour les produits d'achat intégré, il suffit de créer un lien vers ce type d'URL :

<a href="inapppurchase://?package=purchase_package_identifier_name_here&disableadmob=true&consumable=true&successful_url=https://www.google.com">Buy In-App Purchase</a>
        

• Le « package » est l'identifiant du produit que vous souhaitez vendre.
• La « successful_url » est l'URL que l'application doit charger une fois l'achat terminé.
  • Vous pouvez enregistrer un cookie sur cette page afin que votre application web se souvienne que l'achat a été effectué.
• Incluez « disableadmob=true » si vous souhaitez désactiver les publicités après l'achat du produit.
• Pour permettre que l'utilisateur soit à nouveau facturé pour le même produit d'achat intégré (s'il l'achète une nouvelle fois), définissez l'attribut « consumable » sur true. En revanche, si vous souhaitez empêcher que l'utilisateur soit à nouveau facturé pour le même produit (s'il l'achète une nouvelle fois), définissez « consumable » sur false ou omettez-le totalement (puisque false est la valeur par défaut). Veillez à utiliser WebViewGold pour Android v12.5 ou ultérieure.

<a href="inappsubscription://?package=purchase_package_identifier_name_here&expired_url=https://www.yahoo.com&successful_url=https://www.google.com">Start In-App Subscription</a>
        

• Le « package » est l'identifiant du produit d'abonnement que vous souhaitez vendre.
• La « successful_url » est l'URL que l'application doit charger une fois l'achat terminé.
  • Vous pouvez enregistrer un cookie sur cette page afin que votre application web se souvienne que l'abonnement a été activé.
• La « expired_url » est l'URL que l'application doit charger lorsque l'abonnement n'est plus valide.
  • Vous pouvez mettre à jour/supprimer un cookie sur cette page afin que votre application web se souvienne que l'abonnement a été désactivé.

Gérer/annuler les abonnements : WebViewGold pour Android peut créer un lien direct vers l'écran de gestion des abonnements du Play Store — dirigez simplement votre lien vers cancelinapppurchase:// :

<script>
<a href="cancelinapppurchase://">Manage/cancel subscription in Google Play</a>
<script>

<script>
<a href="restoreinapppurchases://">Restore</a>
<script>

<script>
// Utility function to wait for a variable to be defined
function waitForVariable(variableName, callback, timeout = 5000) {
    const startTime = Date.now();

    (function checkVariable() {
        if (window[variableName] !== undefined) {
            callback(window[variableName]);
        } else if (Date.now() - startTime < timeout) {
            setTimeout(checkVariable, 100);
        } else {
            console.error(`Timeout: ${variableName} was not set within ${timeout} ms`);
        }
    })();
}

// Example: Handling In-App Purchase/Subscription variables
waitForVariable("planID", function(planID) {
    console.log("planID:", planID);
    // Send the Product ID to your server
    sendToServer("planID", planID);
});

waitForVariable("transactionIdentifier", function(transactionIdentifier) {
    console.log("transactionIdentifier:", transactionIdentifier);
    // Send the Transaction ID to your server
    sendToServer("transactionIdentifier", transactionIdentifier);
});

waitForVariable("subreceipts", function(subreceipts) {
    console.log("subreceipts:", subreceipts);
    // Send Subscription Receipt IDs to your server
    sendToServer("subreceipts", subreceipts);
});

// Function to send data to your server for validation
function sendToServer(key, value) {
    fetch("https://example.com/api/validate", {
        method: "POST",
        headers: {
            "Content-Type": "application/json"
        },
        body: JSON.stringify({ [key]: value })
    })
    .then(response => response.json())
    .then(data => console.log(`Server Response for ${key}:`, data))
    .catch(error => console.error(`Error sending ${key}:`, error));
}
</script>

Tarification localisée / Obtenir la localisation du store : Le schéma d'URL getstorelocation:// injecte la localisation du Play Store dans une variable JavaScript. Lorsque getstorelocation:// est appelé/lié, le wrapper WebViewGold récupère le code pays du Play Store, s'il est disponible. Vous pouvez également définir autoInjectVariable sur true dans le fichier de configuration afin d'injecter automatiquement cette valeur (et d'autres) en JavaScript sans avoir besoin d'appeler une URL. Le code pays est alors injecté dans une variable JavaScript storeLocation que votre application web peut utiliser (par exemple pour afficher une tarification localisée). Si le code n'est pas disponible, storeLocation sera défini sur null :

• En cas de succès (exemple États-Unis) : var storeLocation = 'US';
• Si aucun code pays n'est trouvé : var storeLocation = null;

Remarque : Comme pour toute technologie, il est essentiel de mentionner que, même en utilisant notre API, il existe un risque que certains utilisateurs (techniquement avertis) puissent accéder au contenu restreint sans le payer. Cela pourrait par exemple se produire en récupérant et en ouvrant directement le lien Success URL, en désinstallant l'application puis en annulant les produits d'abonnement afin que l'URL d'expiration ne soit jamais appelée (pour minimiser ce risque, vous pouvez donc demander occasionnellement une nouvelle autorisation), ou en utilisant les droits de rétractation et/ou les procédures de rétrofacturation des cartes de crédit. Il convient toutefois de noter qu'un certain niveau de risque existe avec toute approche numérique. De manière générale, notre API constitue une approche pratique et facile à intégrer pour fournir du contenu payant aux utilisateurs d'applications, et nous continuons à travailler sur des moyens de réduire davantage les risques. L'utilisation de notre API se fait toujours à vos risques et sans garantie, mais globalement, bien qu'il soit essentiel d'être conscient du risque d'accès non autorisé/non payé au contenu, les avantages de l'utilisation de notre API l'emportent largement sur les risques pour la plupart des utilisateurs. Il est recommandé de suivre et de comparer les données de vente de la Google Play Store Developer Console avec les activations côté serveur des produits d'achat intégré, afin de garantir une déclaration précise des revenus et d'identifier tout écart potentiel.