Buat Langganan Perpanjangan Otomatis Android
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Langganan auto-renewable memberikan akses berkelanjutan ke konten, layanan, atau fitur premium di aplikasi Anda. Panduan ini akan membantu Anda membuat dan mengonfigurasi langganan di Google Play Console.
Ikhtisar
Bagian berjudul “Ringkasan”Langganan diperbarui otomatis di akhir setiap periode penagihan sampai pengguna membatalkannya. Ini sangat ideal untuk:
- Akses konten premium
- Pengalaman bebas iklan
- Penyimpanan cloud
- Layanan berkelanjutan
Membuat Langganan
Bagian berjudul “Membuat Langganan”-
Buka Subscriptions
Di Google Play Console, pilih aplikasi Anda dan pilih Monetisasi > Langganan dari menu kiri.
Klik Buat langganan untuk memulai.

-
Isi Informasi Dasar
Berikan nama langganan dan product ID. Product ID diperlukan untuk konfigurasi di aplikasi Anda dan tidak dapat diubah kemudian.

-
Buat Base Plan
Google Play membutuhkan tepat satu base plan per langganan. Plugin native-purchases hanya mendukung satu base plan untuk menjaga kompatibilitas dengan iOS.
Klik Tambahkan base plan untuk melanjutkan.

-
Konfigurasi Detail Base Plan
Masukkan:
- ID rencana dasar: Pengidentifikasi unik untuk plan ini
- Periode penagihan: Seberapa sering pengguna dikenakan biaya (mingguan, bulanan, tahunan, dll.)
- Masa tenggang: Jendela waktu di mana Google mempertahankan langganan sambil mencoba pembayaran ulang sebelum pembatalan

-
Atur Harga
Akses bagian harga dan pilih semua negara/wilayah tempat Anda ingin menawarkan langganan.

-
Konfigurasi Harga
Atur harga dasar Anda dalam mata uang utama. Google Play secara otomatis mengonversinya ke mata uang lokal.

-
Tinjau Harga Regional
Periksa harga yang dikonversi otomatis untuk setiap negara. Anda bisa menyesuaikan harga masing-masing jika perlu.

-
Simpan Konfigurasi
Simpan konfigurasi harga Anda.

-
Aktifkan Langganan
Klik Aktifkan tombol untuk mengaktifkan produk langganan Anda dan membuatnya tersedia untuk dibeli.

Pertimbangan Penting
Bagian berjudul “Pertimbangan Penting”Batasan Base Plan
Bagian berjudul “Batasan Base Plan”Plugin native-purchases memerlukan tepat satu base plan per langganan untuk memastikan konsistensi dengan penanganan langganan iOS. Beberapa base plan tidak didukung.
Masa tenggang
Bagian berjudul “Grace Period”Grace period memungkinkan Google Play untuk mencoba ulang pembayaran yang gagal sambil mempertahankan akses langganan pengguna. Grace period umum adalah:
- 3 hari untuk langganan bulanan
- 7 hari untuk langganan jangka panjang
Status Langganan
Bagian berjudul “Status Langganan”Setelah dibuat, langganan Anda akan berstatus “Draft” hingga diaktifkan. Anda dapat menguji langganan draft dalam mode sandbox.
Penggunaan di Aplikasi
Bagian berjudul “Menggunakan di Aplikasi Anda”Setelah dibuat, referensikan langganan tersebut di aplikasi Anda menggunakan product ID:
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Load subscription infoconst { products } = await NativePurchases.getProducts({ productIdentifiers: ['com.example.premium.monthly'], productType: PURCHASE_TYPE.SUBS,});
const product = products[0];console.log(`${product.title} — ${product.priceString}`);
// Purchase (planIdentifier = Base Plan ID from Google Play Console)const transaction = await NativePurchases.purchaseProduct({ productIdentifier: 'com.example.premium.monthly', planIdentifier: 'monthly-plan', // Android base plan id, required unless offerToken is passed; ignored on iOS productType: PURCHASE_TYPE.SUBS,});
console.log('Transaction ID', transaction.transactionId);
// Later, check purchase stateconst { purchases } = await NativePurchases.getPurchases({ productType: PURCHASE_TYPE.SUBS,});
const subscription = purchases.find( (purchase) => purchase.productIdentifier === 'com.example.premium.monthly',);
if (subscription && subscription.purchaseState === 'PURCHASED' && subscription.isAcknowledged) { console.log('Subscription active locally'); // For expiration/cancellation, validate purchaseToken through your backend}Langkah Berikutnya
Bagian berjudul “Langkah Selanjutnya”- Penawaran langganan Android untuk
offerToken, opsionalsubscriptionPeriod, dansubscriptionBillingCycles - Buat penawaran perkenalan untuk menarik pelanggan baru
- Konfigurasi pengujian sandbox untuk menguji langganan Anda
- Siapkan backend receipt validation untuk keamanan
Pemecahan Masalah
Bagian berjudul “Troubleshooting”Langganan tidak muncul di aplikasi:
- Pastikan product ID cocok persis
- Pastikan langganan sudah diaktifkan
- Periksa apakah app Anda memiliki package name yang benar
- Tunggu 2-3 jam setelah aktivasi agar perubahan tersinkronisasi
Error base plan:
- Pastikan Anda memiliki tepat satu base plan
- Pastikan semua field wajib sudah terisi
- Periksa apakah periode billing valid
Masalah harga:
- Pastikan setidaknya satu negara dipilih
- Verifikasi harga dasar lebih besar dari minimum yang diizinkan
- Periksa apakah kurs konversi mata uang dapat diterima
Lanjut dari Create Android Auto-Renewable Subscription
Bagian berjudul “Lanjut dari Create Android Auto-Renewable Subscription”Jika Anda menggunakan Buat Langganan Perpanjangan Otomatis Android untuk merencanakan persetujuan store dan distribusi, hubungkan dengan Menggunakan @capgo/native-purchases untuk kemampuan native saat menggunakan @capgo/native-purchases, @capgo/capacitor-in-app-review untuk detail implementasi di @capgo/capacitor-in-app-review, Menggunakan @capgo/capacitor-in-app-review untuk kapabilitas native di bagian Menggunakan @capgo/capacitor-in-app-review, @capgo/capacitor-native-market untuk detail implementasi di @capgo/capacitor-native-market, dan Menggunakan @capgo/capacitor-native-market untuk kemampuan native di Menggunakan @capgo/capacitor-native-market.