@capgo/native-purchases

Ringkasan

@capgo/native-purchases membungkus StoreKit 2 dan Google Play Billing dengan satu Capacitor API untuk langganan, item konsumsi, dan alur restore. Muat metadata produk dari store, beli di dalam aplikasi, dan refresh entitlement tanpa perlu mengelola native bridge terpisah.

Pilih plugin ini jika Anda ingin billing pihak pertama tanpa SDK pihak ketiga.

Dukungan platform

Platform	Stack penagihan
iOS	StoreKit 2
Android	Google Play Billing 7+

Kemampuan Inti

• In-app purchase dan subscription native menggunakan StoreKit 2 dan Google Play Billing.
• Metadata produk dimuat langsung dari store, termasuk judul dan harga yang terlokalisasi.
• Ketentuan harga StoreKit iOS untuk langganan bulanan dengan komitmen 12 bulan.
• Alur purchase, restore, refresh entitlement, dan manajemen subscription native.
• Helper App Transaction untuk migrasi dari model bisnis lama.

Publik API

Metode	Deskripsi
restorePurchases	Memulihkan pembelian sebelumnya dan menghubungkan appUserID pengguna ke akun mana pun yang menggunakannya.
getAppTransaction	Mendapatkan informasi App Transaction, yang memberikan detail tentang kapan user pertama kali mengunduh atau membeli aplikasi.
isEntitledToOldBusinessModel	Membandingkan versi aplikasi asli dari App Transaction dengan versi target untuk menentukan apakah user berhak atas fitur dari model bisnis sebelumnya.
purchaseProduct	Memulai alur pembelian native. Pada versi iOS yang didukung, masukkan billingPlanType: 'monthly' untuk membeli paket penagihan bulanan dengan komitmen 12 bulan.
getProducts	Mengambil info produk berdasarkan identifier produk. Pada versi iOS yang didukung, produk langganan dapat menyertakan pricingTerms.
getProduct	Mengambil info produk untuk satu identifier produk.
isBillingSupported	Periksa apakah penagihan didukung pada perangkat saat ini.
getPluginVersion	Dapatkan versi plugin native Capacitor.
getPurchases	Mengambil semua pembelian pengguna (baik in-app purchase maupun langganan). Metode ini melakukan query ke riwayat pembelian platform untuk pengguna saat ini.
manageSubscriptions	Membuka halaman manajemen langganan native platform. Ini memungkinkan pengguna untuk melihat, mengubah, atau membatalkan langganan mereka.
acknowledgePurchase	Mengonfirmasi/menyelesaikan transaksi pembelian secara manual.
consumePurchase	Melakukan consume pada in-app purchase di Android.
addListener	Mendengarkan update transaksi StoreKit yang dikirim oleh Transaction.updates Apple. Dipicu saat aplikasi dibuka jika ada transaksi yang belum selesai, dan untuk update apa pun setelahnya. Khusus iOS.
addListener	Mendengarkan kegagalan verifikasi transaksi StoreKit yang dikirim oleh Transaction.updates Apple. Dipicu saat hasil verifikasi tidak terverifikasi. Khusus iOS.
removeAllListeners	Hapus semua listener yang terdaftar.

Sumber Kebenaran

Referensi ini disinkronkan dari src/definitions.ts di capacitor-native-purchases.

Lanjutkan dari @capgo/native-purchases

Jika Anda menggunakan @capgo/native-purchases untuk merencanakan pembayaran dan pembelian, hubungkan dengan Menggunakan @capgo/native-purchases untuk kapabilitas native di Menggunakan @capgo/native-purchases, Harga Capgo untuk alur kerja produk di Harga Capgo, Sistem pembayaran untuk detail implementasi di sistem Pembayaran, Panduan Memulai untuk detail implementasi di Getting Started, dan Strategi Pendapatan untuk detail implementasi di Revenue Playbook.