Créer une souscription Android Auto-Renewable

Les abonnements renouvelables automatiques fournissent accès à du contenu, des services ou des fonctionnalités premium dans votre application sur une base continue. Cette 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 :

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

Créer un Abonnement

1. Naviguer vers les Abonnements

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

   Cliquez sur Créer un abonnement pour commencer.

   

2. Entrez les informations de base

   Fournissez un nom d'abonnement 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 abonnement. Le plugin native-purchases ne prend en charge qu'un seul plan de base pour maintenir la compatibilité avec iOS.

   Cliquez Ajouter le 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 de facturation: Fréquence à laquelle les utilisateurs sont facturés (hebdomadaire, mensuel, annuel, etc.)
   • Période de grâce: Fenêtre de temps pendant laquelle Google maintient l'abonnement en essayant de réessayer le paiement avant l'annulation

   

5. Paramètres de tarification

   Accédez à la section tarification et sélectionnez tous les pays/regions 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. Vérifier les tarifs régionaux

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

   

8. Enregistrer la configuration

   Enregistrez votre configuration de tarification.

   

9. Activer l'abonnement

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

   

Considérations importantes

Limitation du plan de base

Le plugin native-purchases nécessite exactement un plan de base 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 à sa souscription.

• Les périodes de grâce courantes sont :
• 3 jours pour les abonnements mensuels

7 jours pour les abonnements plus longs

Après la création, votre souscription sera en « État de brouillon » jusqu'à son activation. Vous pouvez tester les brouillons dans le mode sandbox.

Utilisation dans Votre Application

Copier dans le presse-papier

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
}

État de la Souscription

• Créez une offre d'introduction pour attirer de nouveaux abonnés
• Configurez les tests de sandbox pour tester vos abonnements
• Configurez la validation des reçus 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