@capgo/native-purchases

Panoramica

@capgo/native-purchases incapsula StoreKit 2 e Google Play Billing con un unico Capacitor API per abbonamenti, consumabili e flussi di ripristino. Carica i metadati dei prodotti dagli store, acquista in-app e aggiorna gli entitlement senza mantenere bridge nativi separati.

Scegli questo plugin se vuoi un billing first party senza un SDK per gli abbonamenti di terze parti.

Offerte Android esatte

Passa offerToken dalla stessa getProducts() risultato che hai visualizzato in modo purchaseProduct() addebiti per quell'offerta. Vedi Offerte di abbonamento Android.

Periodo di fatturazione opzionale

Product.subscriptionPeriod è opzionale. Android lo omette per le offerte prepagate. Usa product.subscriptionPeriod?.unit.

Cicli di rateizzazione

I piani di rateizzazione Android possono includere subscriptionBillingCycles dal numero di pagamenti dell'impegno a rate di Play.

Questi dettagli su offerte e prodotti Android sono documentati per capacitor-native-purchases#245.

Supporto piattaforme

Piattaforma	Stack di billing
iOS	StoreKit 2
Android	Google Play Billing 7+

Funzionalità principali

• Acquisti in-app e abbonamenti nativi con StoreKit 2 e Google Play Billing.
• Metadati dei prodotti caricati direttamente dagli store, inclusi titoli e prezzi localizzati.
• Token di offerta Android, periodi di abbonamento opzionali e numero di cicli di fatturazione rateale. Vedi Offerte di abbonamento Android.
• Condizioni di prezzo StoreKit iOS per abbonamenti mensili con impegno di 12 mesi.
• Flussi di acquisto, ripristino, aggiornamento dei diritti e gestione nativa degli abbonamenti.
• Helpers per transazioni app per la migrazione da modelli di business precedenti.

Pubblico API

Metodo	Descrizione
restorePurchases	Ripristina i dati precedenti dell'utente e collega i relativi appUserIDs a tutti gli altri utenti che li utilizzano.
getAppTransaction	Recupera le informazioni sulla transazione dell'app, che forniscono dettagli su quando l'utente ha originariamente scaricato o acquistato l'app.
isEntitledToOldBusinessModel	Confronta la versione originale dell'app nella transazione con una versione target per verificare se l'utente ha diritto a funzionalità di un precedente modello di business.
purchaseProduct	Avvia il flusso di acquisto nativo. Su Android, passa offerToken per addebitare un'offerta esatta da getProducts(), o planIdentifier per la prima offerta in quel piano base. Nelle versioni di iOS supportate, passa billingPlanType: 'monthly' per acquistare un piano di fatturazione mensile con un impegno di 12 mesi.
getProducts	Recupera le info sui prodotti associati agli identificativi di prodotto. Sulle versioni iOS supportate, i prodotti in abbonamento possono includere pricingTerms. Su Android, i prodotti di abbonamento possono includere subscriptionPeriod e subscriptionBillingCycles quando Play li espone.
getProduct	Recupera le informazioni per un singolo identificativo di prodotto.
isBillingSupported	Verifica se la fatturazione è supportata sul dispositivo corrente.
getPluginVersion	Ottieni la versione nativa del plugin Capacitor.
getPurchases	Recupera tutti gli acquisti dell'utente (sia acquisti in-app che abbonamenti). Questo metodo interroga la cronologia degli acquisti della piattaforma per l'utente corrente.
manageSubscriptions	Apre la pagina nativa di gestione degli abbonamenti della piattaforma. Consente agli utenti di visualizzare, modificare o annullare i propri abbonamenti.
acknowledgePurchase	Conferma o completa manualmente una transazione di acquisto.
consumePurchase	Consuma un acquisto in-app su Android.
addListener	Ascolta gli aggiornamenti delle transazioni StoreKit inviati da Transaction.updates di Apple. Scatta all'avvio dell'app se ci sono transazioni non completate e per ogni aggiornamento successivo. Solo iOS.
addListener	Ascolta i fallimenti di verifica delle transazioni StoreKit inviati da Transaction.updates di Apple. Scatta quando il risultato della verifica è unverified. Solo iOS.
removeAllListeners	Rimuove tutti i listener registrati.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-native-purchases.

Continua da @capgo/native-purchases

Se stai usando @capgo/native-purchases per pianificare pagamenti e acquisti, collegalo a Utilizzo di @capgo/native-purchases per la funzionalità nativa in Utilizzo di @capgo/native-purchases, Prezzi Capgo per il workflow del prodotto nella pagina Prezzi di Capgo, Sistema di pagamento per i dettagli di implementazione nel sistema di pagamento, Per iniziare per i dettagli di implementazione nella guida introduttiva, e Playbook dei ricavi per i dettagli sull'implementazione nel Revenue Playbook.