@capgo/native-purchases

Übersicht

@capgo/native-purchases kapselt StoreKit 2 und Google Play Billing mit einer einzigen Capacitor API für Abonnements, Verbrauchsgüter und Restore-Flows. Lade Produkt-Metadaten aus den Stores, kaufe in der App und aktualisiere Berechtigungen, ohne separate native Bridges pflegen zu müssen.

Wähle dieses Plugin, wenn du First-Party-Billing ohne Drittanbieter-Abonnement SDK möchtest.

Plattformunterstützung

Plattform	Billing-Stack
iOS	StoreKit 2
Android	Google Play Billing 7+

Kernfunktionen

• Native In-App-Käufe und Abonnements mit StoreKit 2 und Google Play Billing.
• Produkt-Metadaten werden direkt aus den Stores geladen, einschließlich lokalisierter Titel und Preise.
• iOS StoreKit-Preisbedingungen für monatliche Abonnements mit 12-Monats-Bindung.
• Kauf-, Restore-, Berechtigungs-Refresh- und native Abo-Verwaltungsfunktionen.
• App-Transaktions-Helfer für die Migration von älteren Geschäftsmodellen.

Öffentliches API

Methode	Beschreibung
restorePurchases	Stellt frühere Käufe eines Nutzers wieder her und verknüpft deren appUserIDs mit denen anderer Nutzer, die dieselben verwenden.
getAppTransaction	Ruft die App-Transaktionsinformationen ab, die Details darüber liefern, wann der Nutzer die App ursprünglich heruntergeladen oder gekauft hat.
isEntitledToOldBusinessModel	Vergleicht die ursprüngliche App-Version aus der App-Transaktion mit einer Zielversion, um zu ermitteln, ob der Nutzer Anspruch auf Features aus einem früheren Geschäftsmodell hat.
purchaseProduct	Startet den nativen Kaufprozess. Bei unterstützten iOS-Versionen übergeben Sie billingPlanType: 'monthly' um einen monatlichen Abrechnungsplan mit 12-monatiger Bindung abzuschließen.
getProducts	Ruft Produktinfos zu Produkt-IDs ab. Bei unterstützten iOS-Versionen können Abonnementprodukte auch Folgendes enthalten pricingTerms.
getProduct	Ruft die Produktinfos für eine einzelne Produkt-ID ab.
isBillingSupported	Prüft, ob die Abrechnung auf dem aktuellen Gerät unterstützt wird.
getPluginVersion	Die native Capacitor Plugin-Version abrufen.
getPurchases	Ruft alle Käufe des Nutzers ab (sowohl In-App-Käufe als auch Abonnements). Diese Methode fragt den Kaufverlauf der Plattform für den aktuellen Nutzer ab.
manageSubscriptions	Öffnet die native Abonnement-Verwaltung der Plattform. So können Nutzer ihre Abonnements einsehen, ändern oder kündigen.
acknowledgePurchase	Bestätigt oder schließt eine Kauftransaktion manuell ab.
consumePurchase	Verbraucht einen In-App-Kauf auf Android.
addListener	Lauscht auf StoreKit-Transaktions-Updates von Apples Transaction.updates. Wird beim App-Start ausgelöst, falls noch nicht abgeschlossene Transaktionen vorliegen, sowie bei allen weiteren Updates. Nur iOS.
addListener	Lauscht auf Fehler bei der StoreKit-Transaktionsverifizierung von Apples Transaction.updates. Wird ausgelöst, wenn das Verifizierungsergebnis unverified ist. Nur iOS.
removeAllListeners	Alle registrierten Listener entfernen.

Source of Truth

Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-native-purchases.

Weiter geht's mit @capgo/native-purchases

Wenn du es nutzt @capgo/native-purchases um Zahlungen und Käufe zu planen, verbinde es mit @capgo/native-purchases verwenden für die native Funktionalität bei der Nutzung von @capgo/native-purchases, Capgo Preise für den Produkt-Workflow auf der Preisseite von Capgo, Zahlungssystem für die Implementierungsdetails im Zahlungssystem, Erste Schritte für die Implementierungsdetails in Getting Started und Umsatz-Playbook für das Implementierungsdetail im Revenue Playbook.