Native Purchases Capgo Plugin Capacitor

Utiliser @capgo/native-purchases

Les abonnements in-app simplifiés.

Installer

bun add @capgo/native-purchases
bunx cap sync

Ce que ce plugin expose

• restorePurchases - Restaure les achats précédents de l'utilisateur et lie ses appUserIDs à ceux de tout autre utilisateur les utilisant également.
• getAppTransaction - Récupère les informations de transaction de l'app, fournissant des détails sur la date de téléchargement ou d'achat initial de l'app par l'utilisateur.
• isEntitledToOldBusinessModel - Compare la version initiale de l'app issue de la transaction avec une version cible pour déterminer si l'utilisateur a droit aux fonctionnalités d'un ancien modèl’économique.
• getProducts - Charge les métadonnées des produits du store, incluant les conditions de tarification des abonnements iOS pris en charge.
• purchaseProduct - Lance le processus d'achat pour le produit et le plan de facturation sélectionnés.

Exemple d'utilisation

restorePurchases

Restaure les achats précédents de l'utilisateur et lie ses appUserIDs à ceux de tout autre utilisateur les utilisant également.

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

await NativePurchases.restorePurchases();

getAppTransaction

Récupère les informations de transaction de l'app, fournissant des détails sur la date de téléchargement ou d'achat initial de l'app par l'utilisateur.

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

const { appTransaction } = await NativePurchases.getAppTransaction();

// Check if user downloaded before version 2.0.0 (when subscription was added)
if (compareVersions(appTransaction.originalAppVersion, '2.0.0') < 0) {
  // User gets free access - they downloaded before subscriptions
  grantFreeAccess();
}

isEntitledToOldBusinessModel

Compare la version initiale de l'app issue de la transaction avec une version cible pour déterminer si l'utilisateur a droit aux fonctionnalités d'un ancien modèl’économique.

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

// Check if user downloaded before version 2.0.0/build 42 (when subscription was added)
const result = await NativePurchases.isEntitledToOldBusinessModel({
  targetVersion: '2.0.0',
  targetBuildNumber: '42'
});

if (result.isOlderVersion) {
  console.log(`User downloaded v${result.originalAppVersion}, granting free access`);
  grantFreeAccess();
}

purchaseProduct

Lance le processus d'achat pour le produit donné. Pour les abonnements Android, passez l'ID du plan de base Google Play comme planIdentifier. Pour les abonnements iOS pris en charge avec facturation mensuelle et engagement de 12 mois, passez billingPlanType: 'monthly'.

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

await NativePurchases.purchaseProduct({
  productIdentifier: 'com.example.premium.monthly',
  planIdentifier: 'monthly-plan',
  productType: PURCHASE_TYPE.SUBS,
});

Abonnements iOS avec engagement mensuel

Sur les versions iOS compatibles, StoreKit peut proposer un plan de facturation mensuel avec un engagement de 12 mois via pricingTerms. Affichez ces conditions sur votre paywall avant l'achat :

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

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

const yearlyProduct = products.find(
  (product) => product.identifier === 'com.example.premium.yearly',
);
const monthlyCommitment = yearlyProduct?.pricingTerms?.find(
  (term) => term.billingPlanType === 'monthly',
);

if (yearlyProduct && monthlyCommitment) {
  console.log('Monthly price:', monthlyCommitment.billingDisplayPrice);
  console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);

  const transaction = await NativePurchases.purchaseProduct({
    productIdentifier: yearlyProduct.identifier,
    productType: PURCHASE_TYPE.SUBS,
    billingPlanType: 'monthly',
  });

  console.log('Billing plan:', transaction.billingPlanType);
  console.log('Commitment ends:', transaction.commitmentInfo?.expirationDate);
}

Référence complète

• GitHub : https://github.com/Cap-go/capacitor-native-purchases/
• Docs : /docs/plugins/native-purchases/
• Guide de l'engagement mensuel iOS : /docs/plugins/native-purchases/ios-monthly-commitment/

Continuer depuis Utiliser @capgo/native-purchases

Si vous utilisez Utiliser @capgo/native-purchases pour planifier les paiements et les achats, connectez-l’à @capgo/native-purchases pour les détails d'implémentation dans @capgo/native-purchases, Prise en main pour les détails d'implémentation dans Getting Started 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, et Playbook revenus pour les détails d'implémentation dans le Revenue Playbook.