Create Android Auto-Renewable Subscription

Les abonnements renouvelables automatiques fournissent accès au contenu, aux services ou aux fonctionnalités premium dans votre application sur une base continue. Ce guide vous aidera à créer et à configurer les abonnements dans Google Play Console.

Vue d'ensemble

Les abonnements se renouvellent automatiquement à la fin de chaque période de facturation jusqu'à ce que l'utilisateur annule. Ils sont idéaux pour :

• L'accès au contenu premium
• Expériences sans publicités
• Stockage sur le cloud
• Services en cours

Créer une Abonnement

1. Naviguer vers les Abonnements

   En Google Play Console, sélectionnez votre application et choisissez Monétiser > Abonnements à partir du menu de gauche.

   Cliquez sur le Créer un abonnement bouton pour commencer.

   

2. Entrer les informations de base

   Fournir un nom de souscription et un ID de produit. L'ID de produit est requis pour la configuration dans votre application et ne peut pas être modifié ultérieurement.

   

3. Créer un Plan de Base

   Google Play exige exactement un plan de base par souscription. Le plugin native-purchases prend en charge uniquement un plan de base pour maintenir la compatibilité avec iOS.

   Cliquez Ajouter un plan de base pour continuer.

   

4. Configurer les détails du plan de base

   Entrer :

   • ID du plan de base: Identifiant unique pour ce plan
   • Période facturation : Combien souvent les utilisateurs sont facturés (hebdomadaire, mensuel, annuel, etc.)
   • Période de grâce : La fenêtre de temps pendant laquelle Google maintient l'abonnement tout en réessayant le paiement avant l'annulation

   

5. Configurer les tarifs

   Accéder à la section tarifs et sélectionner tous les pays/ régions où vous souhaitez proposer l'abonnement

   

6. Configurer le prix

   Définir votre prix de base dans votre devise principale. Google Play convertit automatiquement ce prix en devises locales

   

7. Réviser les tarifs régionaux

   Vérifiez les prix automatiquement convertis pour chaque pays. Vous pouvez ajuster les prix individuels si nécessaire.

   

8. Sauvegarder la Configuration

   Sauvegardez votre configuration de tarifs.

   

9. Activer l'Abonnement

   Cliquez sur le Activer bouton pour rendre votre produit d'abonnement disponible et accessible à l'achat.

   

Considérations importantes

Limitation de la Base Plan

Le plugin native-purchases nécessite exactement une base plan par abonnement pour garantir la cohérence avec la gestion des abonnements iOS. Plusieurs plans de base ne sont pas pris en charge.

Période de Grâce

La période de grâce permet à Google Play de réessayer les paiements échoués tout en maintenant l'accès de l'utilisateur à son abonnement. Les périodes de grâce courantes sont :

• 3 jours pour les abonnements mensuels
• 7 jours pour les abonnements plus longs

État de l'Abonnement

Après création, votre abonnement sera en « État de brouillon » jusqu'à activation. Vous pouvez tester les abonnements de brouillon en mode sandbox.

Utilisation dans Votre Application

Une fois créé, référez-vous à la souscription dans votre application en utilisant l'ID du produit :

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

// Load subscription info
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['com.example.premium.monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

const product = products[0];
console.log(`${product.title} — ${product.priceString}`);

// Purchase (planIdentifier = Base Plan ID from Google Play Console)
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'com.example.premium.monthly',
  planIdentifier: 'monthly-plan', // REQUIRED on Android, ignored on iOS
  productType: PURCHASE_TYPE.SUBS,
});

console.log('Transaction ID', transaction.transactionId);

// Later, check purchase state
const { purchases } = await NativePurchases.getPurchases({
  productType: PURCHASE_TYPE.SUBS,
});

const subscription = purchases.find(
  (purchase) => purchase.productIdentifier === 'com.example.premium.monthly',
);

if (subscription && subscription.purchaseState === 'PURCHASED' && subscription.isAcknowledged) {
  console.log('Subscription active locally');
  // For expiration/cancellation, validate purchaseToken through your backend
}

Étapes suivantes

• Créer une offre d'introduction pour attirer de nouveaux abonnés
• Configurer les tests de sandbox pour tester vos souscriptions
• Configurer la validation des réceptions de paiement côté serveur pour la sécurité

Résolution des problèmes

Abonnement ne s'affiche pas dans l'application :

• Vérifiez que l'ID du produit correspond exactement
• Assurez-vous que l'abonnement est activé
• Vérifiez que votre application a le nom de package correct
• Attendez 2-3 heures après activation pour que les modifications se propagent

Erreurs de plan de base :

• Assurez-vous d'avoir exactement un plan de base
• Vérifiez que tous les champs requis sont remplis
• Vérifiez que la période de facturation est valide

Problèmes de tarification :

• Confirmez qu'au moins un pays est sélectionné
• Vérifiez que le prix de base est supérieur au prix minimum autorisé
• Vérifiez que les taux de conversion de devises sont acceptables

Continuez de Create Android Auto-Renewable Subscription

Si vous utilisez Create Android Auto-Renewable Subscription pour planifier l'approbation et la distribution de l'application, connectez-le à En utilisant @capgo/native-purchases pour la capacité native dans En utilisant @capgo/native-purchases, @capgo/capacitor-in-app-review pour le détail d'implémentation dans @capgo/capacitor-in-app-review, En utilisant @capgo/capacitor-in-app-review pour la capacité native dans En utilisant @capgo/capacitor-in-app-review, @capgo/capacitor-marché-natif pour les détails d'implémentation dans @capgo/capacitor-marché-natif, et En utilisant @capgo/capacitor-marché-natif pour la capacité native dans En utilisant @capgo/capacitor-marché-natif.