@capgo/native-purchases

Ikhtisar

@capgo/native-purchases membungkus StoreKit 2 dan Google Play Billing dengan satu Capacitor API untuk langganan, item sekali pakai, dan alur pemulihan. Muat metadata produk dari toko, lakukan pembelian di dalam aplikasi, dan perbarui hak akses tanpa perlu memelihara bridge native terpisah.

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

Dukungan platform

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

Kemampuan Utama

• Pembelian in-app dan langganan native dengan 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 pembelian, restore, refresh entitlement, dan manajemen langganan native.
• Helper App Transaction untuk migrasi dari model bisnis lama.

API Publik

Metode	Deskripsi
restorePurchases	Restores a user’s previous and links their appUserIDs to any user’s also using those .
getAppTransaction	Mengambil informasi App Transaction, yang menyediakan detail tentang kapan pengguna pertama kali mengunduh atau membeli aplikasi.
isEntitledToOldBusinessModel	Membandingkan versi aplikasi asli dari App Transaction dengan versi target untuk menentukan apakah pengguna berhak atas fitur dari model bisnis sebelumnya.
purchaseProduct	Memulai alur pembelian native. Pada versi iOS yang didukung, teruskan billingPlanType: 'monthly' untuk membeli paket billing bulanan dengan komitmen 12 bulan.
getProducts	Mengambil info produk yang terkait dengan identifier produk. Pada versi iOS yang didukung, produk langganan dapat menyertakan pricingTerms.
getProduct	Mengambil info produk untuk satu identifier produk.
isBillingSupported	Cek apakah billing didukung untuk perangkat saat ini.
getPluginVersion	Dapatkan versi plugin native Capacitor.
getPurchases	Mengambil semua pembelian pengguna (baik in-app purchases maupun langganan). Metode ini menanyakan riwayat pembelian platform untuk pengguna saat ini.
manageSubscriptions	Membuka halaman manajemen langganan native platform. Ini memungkinkan pengguna untuk melihat, memodifikasi, atau membatalkan langganan mereka.
acknowledgePurchase	Mengakui/menyelesaikan transaksi pembelian secara manual.
consumePurchase	Mengonsumsi in-app purchase di Android.
addListener	Mendengarkan pembaruan transaksi StoreKit yang dikirim oleh Apple’s Transaction.updates. Terpicu saat aplikasi diluncurkan jika ada transaksi yang belum selesai, dan untuk pembaruan apa pun setelahnya. Hanya iOS.
addListener	Mendengarkan kegagalan verifikasi transaksi StoreKit yang dikirim oleh Apple’s Transaction.updates. Terpicu ketika hasil verifikasi adalah unverified. Hanya iOS.
removeAllListeners	Menghapus semua listener yang terdaftar.

Sumber Kebenaran

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

Lanjut dari @capgo/native-purchases

Jika Anda menggunakan @capgo/native-purchases untuk merencanakan pembayaran dan pembelian, hubungkan dengan Menggunakan @capgo/native-purchases untuk kemampuan native saat menggunakan @capgo/native-purchases, Harga Capgo untuk alur kerja produk di halaman 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.