@capgo/native-purchases

Aperçu

@capgo/native-purchases encapsule StoreKit 2 et Google Play Billing avec un seul Capacitor API pour les abonnements, les consommables et les flux de restauration. Chargez les métadonnées des produits depuis les stores, effectuez des achats in-app et rafraîchissez les droits d'accès sans maintenir de bridges natifs séparés.

Choisissez ce plugin si vous voulez une facturation first party sans SDK d'abonnement tiers.

Offres Android exactes

Passer offerToken de la même getProducts() résultat que vous avez affiché purchaseProduct() facture cette offre. Voir Offres d’abonnement Android.

Période de facturation facultative

Product.subscriptionPeriod est facultatif. Android l’omet pour les offres prépayées. Utilisez product.subscriptionPeriod?.unit.

Cycles de versements

Les plans de versements Android peuvent inclure subscriptionBillingCycles depuis le nombre de paiements d’engagement de versement de Play.

Ces détails d’offre et de produit Android sont documentés pour capacitor-native-purchases#245.

Support des plateformes

Plateforme	Stack de facturation
iOS	StoreKit 2
Android	Google Play Billing 7+

Fonctionnalités clés

• Achats et abonnements in-app natifs avec StoreKit 2 et Google Play Billing.
• Métadonnées des produits chargées directement depuis les stores, y compris titres et prix localisés.
• Tokens d’offre Android, périodes d’abonnement optionnelles et nombre de cycles de facturation en plusieurs fois. Voir offres d’abonnement Android.
• Conditions tarifaires StoreKit iOS pour les abonnements mensuels avec engagement de 12 mois.
• Flux d’achat, de restauration, de rafraîchissement des droits et de gestion native des abonnements.
• Aides à la transaction d’application pour la migration depuis d’anciens modèles économiques.

API public

Méthode	Description
restorePurchases	Restaure l’achat précédent d’un utilisateur et lie ses appUserIDs à ceux d’autres utilisateurs utilisant également ces .
getAppTransaction	Récupère les informations de la transaction d’application, qui indiquent quand l’utilisateur a initialement téléchargé ou acheté l’application.
isEntitledToOldBusinessModel	Compare la version d’application originale de la transaction avec une version cible pour déterminer si l’utilisateur a droit aux fonctionnalités d’un modèl’économique antérieur.
purchaseProduct	Démarre le flux d’achat natif. Sur Android, passez offerToken pour facturer une offre exacte depuis getProducts(), ou planIdentifier pour la première offre de ce plan de base. Sur les versions iOS prises en charge, passez billingPlanType: 'monthly' pour acheter un plan de facturation mensuel avec un engagement de 12 mois.
getProducts	Récupère les informations produit associées aux identifiants de produit. Sur les versions iOS prises en charge, les produits d’abonnement peuvent inclure pricingTerms. Sur Android, les produits d’abonnement peuvent inclure subscriptionPeriod et subscriptionBillingCycles lorsque Play les expose.
getProduct	Récupère les informations produit pour un identifiant de produit unique.
isBillingSupported	Vérifie si la facturation est prise en charge sur l’appareil actuel.
getPluginVersion	Récupère la version du plugin natif Capacitor.
getPurchases	Récupère tous les achats de l’utilisateur (achats in-app et abonnements). Cette méthode interroge l’historique d’achat de la plateforme pour l’utilisateur actuel.
manageSubscriptions	Ouvre la page de gestion des abonnements native de la plateforme. Cela permet aux utilisateurs de consulter, modifier ou annuler leurs abonnements.
acknowledgePurchase	Confirmer/terminer manuellement une transaction d’achat.
consumePurchase	Consommer un achat in-app sur Android.
addListener	Écoutez les mises à jour des transactions StoreKit transmises par Transaction.updates d’Apple. Se déclenche au lancement de l’application s’il existe des transactions inachevées, puis pour toute mise à jour ultérieure. iOS uniquement.
addListener	Écoute les échecs de vérification des transactions StoreKit transmis par Transaction.updates d’Apple. Se déclenche lorsque le résultat de vérification est unverified. iOS uniquement.
removeAllListeners	Supprimez tous les écouteurs enregistrés.

Source de vérité

Cette référence est synchronisée depuis src/definitions.ts dans capacitor-native-purchases.

Poursuivre depuis @capgo/native-purchases

Si vous utilisez @capgo/native-purchases pour planifier les paiements et les achats, connectez-l’à Utiliser @capgo/native-purchases pour la capacité native dans Utiliser @capgo/native-purchases Tarifs Capgo pour le workflow produit dans Capgo Tarifs, Système de paiement pour les détails d'implémentation du système de paiement, Prise en main pour les détails d'implémentation dans Getting Started, et Playbook revenus pour les détails d'implémentation dans le Revenue Playbook.