Usando @capgo/compras-nativas

Subscripciones en la Aplicación Facil.

Instalar

bun add @capgo/native-purchases
bunx cap sync

¿Qué Esta Plugin Exposa

restorePurchases - Restaura la versión anterior de un usuario y enlaza su appUserIDs con cualquier usuario que también esté utilizando esos .
getAppTransaction - Obtiene la información de transacción de la aplicación, que proporciona detalles sobre cuando el usuario descargó o compró la aplicación originalmente.
isEntitledToOldBusinessModel - Compara la versión original de la aplicación desde la transacción de la aplicación con una versión objetivo para determinar si el usuario tiene derecho a características de un modelo de negocio anterior.
getProducts - Carga el metadato de productos de la tienda, incluyendo los términos de precios de suscripción de iOS admitidos.
purchaseProduct - Inicia el proceso de compra para el producto y plan de facturación seleccionados.

Ejemplo de uso

`restorePurchases`

Restaura el historial de un usuario y enlaza sus appUserIDs con cualquier usuario que también utilice esos .

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

await NativePurchases.restorePurchases();

`getAppTransaction`

Obtiene la información de transacción de la aplicación, que proporciona detalles sobre cuando el usuario descargó o compró la aplicación por primera vez.

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`

Compara la versión original de la aplicación desde la transacción de la aplicación con una versión objetivo para determinar si el usuario tiene derecho a características de un modelo de negocio anterior.

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`

Inicia el proceso de compra para el producto especificado. Para las suscripciones de Android, pasa el ID del plan base de Google Play como planIdentifier. Para las suscripciones de iOS compatibles que ofrecen facturación mensual con un compromiso de 12 meses, pasa 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,
});

Suscripciones de iOS mensuales con compromiso de 12 meses

En versiones de iOS compatibles, StoreKit puede exponer un plan de facturación mensual con un compromiso de 12 meses a través de pricingTerms. Muestra estos términos en tu pantalla de pago antes de la compra:

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);
}

Referencia completa

GitHub: https://github.com/Cap-go/capacitor-compras-nativas/
Documentación: /docs/plugins/compras-nativas/
Guía de compromiso mensual de iOS: /docs/plugins/compras-nativas/ios-mensual/

Sigue adelante desde Usando @capgo/compras-nativas

Si estás utilizando Usando @capgo/compras-nativas para planificar pagos y compras, conecta con @capgo/compras-nativas para los detalles de implementación en @capgo/compras-nativas, Inicio de Sesión para los detalles de implementación en Inicio de Sesión, Capgo Precios para el flujo de trabajo del producto en Capgo Precios, Sistema de pago para el detalle de implementación en Sistema de pago, y Libro de estrategia de ingresos para el detalle de implementación en Libro de estrategia de ingresos.

Compras nativas

Tutoriales sobre Compras Nativas