@capgo/native-purchases

Resumen

@capgo/native-purchases envuelve StoreKit 2 y Google Play Billing con un solo Capacitor API para suscripciones, consumibles y flujos de restauración. Carga los metadatos de productos desde las tiendas, realiza compras en la app y actualiza los permisos sin mantener puentes nativos separados.

Elige este plugin si quieres facturación de primera parte sin un SDK de suscripción de terceros.

Soporte de plataformas

Plataforma	Stack de facturación
iOS	StoreKit 2
Android	Google Play Billing 7+

Funcionalidades principales

• Compras in-app y suscripciones nativas con StoreKit 2 y Google Play Billing.
• Metadatos de productos cargados directamente de las tiendas, incluyendo títulos y precios localizados.
• Términos de precios de iOS StoreKit para suscripciones mensuales con compromiso de 12 meses.
• Flujos de compra, restauración, actualización de entitlements y gestión de suscripciones nativas.
• Helpers de App Transaction para la migración desde modelos de negocio anteriores.

Público API

Método	Descripción
restorePurchases	Restaura la compra previa de un usuario y vincula sus appUserIDs con los de cualquier otro usuario que también los utilice.
getAppTransaction	Obtiene la información de App Transaction, que detalla cuándo el usuario descargó o compró la app originalmente.
isEntitledToOldBusinessModel	Compara la versión original de la app en la App Transaction con una versión objetivo para determinar si el usuario tiene derecho a funciones de un modelo de negocio anterior.
purchaseProduct	Inicia el flujo de compra nativa. En versiones de iOS compatibles, pasa billingPlanType: 'monthly' para comprar un plan de facturación mensual con un compromiso de 12 meses.
getProducts	Obtiene la información de los productos asociados con identificadores de producto. En versiones de iOS compatibles, los productos de suscripción pueden incluir pricingTerms.
getProduct	Obtiene la información del producto para un único identificador de producto.
isBillingSupported	Comprueba si la facturación es compatible con el dispositivo actual.
getPluginVersion	Obtén la versión del plugin nativo Capacitor.
getPurchases	Obtiene todas las compras del usuario (tanto compras in-app como suscripciones). Este método consulta el historial de compras de la plataforma para el usuario actual.
manageSubscriptions	Abre la página nativa de gestión de suscripciones de la plataforma. Esto permite a los usuarios ver, modificar o cancelar sus suscripciones.
acknowledgePurchase	Confirma o finaliza manualmente una transacción de compra.
consumePurchase	Consume una compra in-app en Android.
addListener	Escucha las actualizaciones de transacciones de StoreKit que envía Transaction.updates de Apple. Se activa al iniciar la app si hay transacciones sin finalizar, y ante cualquier actualización posterior. Solo iOS.
addListener	Escucha los fallos de verificación de transacciones de StoreKit enviados por Transaction.updates de Apple. Se activa cuando el resultado de la verificación es unverified. Solo iOS.
removeAllListeners	Elimina todos los listeners registrados.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-native-purchases.

Continúa con @capgo/native-purchases

Si estás usando @capgo/native-purchases para planificar pagos y compras, conéctalo con Uso de @capgo/native-purchases para la capacidad nativa al usar @capgo/native-purchases, Precios de Capgo para el flujo de trabajo de productos en Capgo Pricing, Sistema de pagos para el detalle de implementación en Sistema de pagos, Primeros pasos para los detalles de implementación en Getting Started, y Estrategia de ingresos para el detalle de implementación en Revenue Playbook.