Langsung ke konten

Membuat langganan iOS yang diperpanjang otomatis

GitHub

Langganan auto-renewable memberikan akses berulang ke konten, layanan, atau fitur premium di aplikasi iOS Anda. Panduan ini memandu Anda membuat langganan di App Store Connect.

Langganan auto-renewable diperbarui secara otomatis di akhir setiap periode tagihan hingga pengguna membatalkannya. Cocok untuk:

  • Konten dan fitur premium
  • Pengalaman bebas iklan
  • Penyimpanan cloud dan sinkronisasi
  • Layanan streaming
  • Alat dan utilitas profesional

Sebelum membuat langganan, Anda harus:

  1. Buat grup langganan untuk mengatur langganan Anda
  2. Punya keanggotaan Apple Developer Program yang aktif
  3. Lengkapi informasi perbankan dan pajak di App Store Connect
  1. Buka Subscriptions

    Di App Store Connect, pilih aplikasi Anda dan buka Monetisasi > Langganan.

    Pilih grup langganan Anda atau buat yang baru jika diperlukan.

    Navigasi ke langganan

  2. Buat langganan baru

    Klik + ikon di samping grup langganan Anda untuk menambahkan langganan baru.

  3. Isi Informasi Dasar

    Nama Referensi: Nama deskriptif untuk penggunaan internal (tidak ditampilkan ke pelanggan)

    • Contoh: “Premium Monthly”, “Ultimate Annual”, “Basic Plan”

    ID Produk: ID unik untuk langganan ini (tidak dapat diubah setelahnya)

    • Format: com.yourcompany.yourapp.premium_monthly
    • Gunakan nama deskriptif huruf kecil dengan underscore
    • Wajib untuk mengonfigurasi plugin native-purchases

    Isi detail langganan

  4. Konfigurasi Durasi

    Pilih durasi langganan dari opsi yang tersedia:

    • 1 minggu
    • 1 bulan
    • 2 bulan
    • 3 bulan
    • 6 bulan
    • 1 tahun

    Durasi menentukan seberapa sering pengguna ditagih.

  5. Atur Harga

    Klik Tambah Harga Langganan untuk mengatur harga:

    Wilayah Dasar: Pilih pasar utama Anda (biasanya negara Anda)

    Harga: Atur harga langganan

    • Apple secara otomatis mengonversi ke mata uang lain
    • Pilih dari tier harga Apple
    • Pertimbangkan nilai persepsi dan tarif pasar

    Konfigurasi harga

  6. Family Sharing (Opsional)

    Putuskan apakah akan mengaktifkan Family Sharing, yang memungkinkan hingga 6 anggota keluarga mengakses langganan.

    Aktifkan jika:

    • Konten cocok untuk penggunaan keluarga
    • Anda ingin meningkatkan nilai proposisi
    • Model bisnis Anda mendukungnya

    Jangan aktifkan jika:

    • Langganan hanya untuk penggunaan individu
    • Konten dipersonalisasi untuk pengguna
    • Anda ingin memaksimalkan pendapatan per pengguna
  7. Tambahkan Lokalisasi

    Tambahkan informasi tampilan langganan dalam semua bahasa yang didukung aplikasi Anda:

    Nama Tampilan Langganan: Nama yang dilihat pelanggan (mis. “Premium Bulanan”)

    Deskripsi: Deskripsi singkat tentang apa yang termasuk dalam langganan

    • Buat ringkas dan fokus pada manfaat
    • Sebutkan fitur utama
    • Tonjolkan nilai jual

    Tambahkan lokalisasi

  8. Gambar Promosi App Store (Opsional)

    Upload gambar promosi untuk langganan ini (312x390 piksel):

    • Tampil di halaman langganan App Store
    • Harus sesuai dengan desain aplikasi Anda
    • Sertakan nama langganan untuk kejelasan
  9. Simpan dan Ajukan

    Klik Simpan untuk membuat langganan.

    Untuk Langganan Pertama:

    • Harus diajukan bersama versi aplikasi baru
    • Sertakan dalam pengajuan App Store berikutnya
    • Tidak dapat dikirim secara independen

    Untuk Langganan Berikutnya:

    • Dapat dikirim langsung dari halaman Langganan
    • Tidak memerlukan versi aplikasi baru
    • Tersedia setelah langganan pertama disetujui

Langganan Anda akan memiliki salah satu status berikut:

StatusDeskripsiBisa Diuji?
Metadata HilangSetup belum lengkapYa (sandbox)
Siap untuk dikirimLengkap tapi belum dikirimYa (sandbox)
Menunggu ReviewTerkirim ke AppleYa (sandbox)
Sedang DireviewSedang ditinjau oleh AppleYa (sandbox)
DisetujuiTersedia untuk dibeliYa
DitolakPerlu perubahanYa (sandbox)

Setelah dibuat, referensikan langganan tersebut di aplikasi Anda menggunakan product ID:

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Fetch subscription products direct from StoreKit
const { products } = await NativePurchases.getProducts({
productIdentifiers: [
'com.yourcompany.yourapp.premium_monthly',
'com.yourcompany.yourapp.premium_annual',
],
productType: PURCHASE_TYPE.SUBS,
});
products.forEach((product) => {
console.log(`${product.title}: ${product.priceString}`);
console.log(`Duration: ${product.subscriptionPeriod?.unitString ?? 'unknown'}`);
console.log(`Description: ${product.description}`);
});
// Purchase a subscription (StoreKit 2 automatically handles intro pricing and offers)
try {
const transaction = await NativePurchases.purchaseProduct({
productIdentifier: 'com.yourcompany.yourapp.premium_monthly',
productType: PURCHASE_TYPE.SUBS,
});
console.log('Transaction ID:', transaction.transactionId);
// StoreKit receipts are included on iOS for server-side validation
await sendReceiptToBackend(transaction.receipt);
} catch (error) {
console.error('Purchase failed:', error);
}
// Check subscription status using the store's data
const { purchases } = await NativePurchases.getPurchases({
productType: PURCHASE_TYPE.SUBS,
});
const premium = purchases.find(
(purchase) => purchase.productIdentifier === 'com.yourcompany.yourapp.premium_monthly',
);
if (premium?.isActive) {
console.log('Expires:', premium.expirationDate);
console.log('Will renew:', premium.willCancel === false);
console.log('Store state:', premium.subscriptionState);
unlockPremiumFeatures();
} else {
showPaywall();
}

Jika langganan App Store Connect Anda dikonfigurasi dengan rencana penagihan bulanan dan komitmen 12 bulan, StoreKit dapat mengembalikan syarat harga tambahan untuk produk tersebut. Gunakan syarat-syarat itu untuk menampilkan biaya bulanan, harga total komitmen, dan periode komitmen penuh sebelum pembelian.

const yearlyProduct = products.find(
(product) => product.identifier === 'com.yourcompany.yourapp.premium_annual',
);
const monthlyCommitment = yearlyProduct?.pricingTerms?.find(
(term) => term.billingPlanType === 'monthly',
);
if (yearlyProduct && monthlyCommitment) {
console.log('Monthly charge:', monthlyCommitment.billingDisplayPrice);
console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);
await NativePurchases.purchaseProduct({
productIdentifier: yearlyProduct.identifier,
productType: PURCHASE_TYPE.SUBS,
billingPlanType: 'monthly',
});
}

Untuk alur paywall dan entitlement lengkap, lihat Rencana penagihan komitmen bulanan iOS.

  • Rencana bulanan: Hambatan masuk lebih rendah, membangun kebiasaan
  • Paket tahunan: Nilai lebih baik, LTV lebih tinggi, churn lebih rendah
  • Beberapa tier: Basic, Premium, Ultimate untuk segmen pengguna berbeda
  • Analisis kompetitif: Riset harga aplikasi serupa
  • Gunakan penamaan yang konsisten: company.app.tier_duration
  • Sertakan tier dan durasi di ID: premium_monthly, ultimate_annual
  • Hindari mengubah product ID (bersifat permanen)
  • Dokumentasikan semua product ID untuk tim Anda
  • Aktifkan untuk aplikasi keluarga (game, edukasi, hiburan)
  • Pertimbangkan dampaknya terhadap pendapatan
  • Uji perilaku sharing secara menyeluruh
  • Sampaikan kemampuan sharing dalam materi marketing
  • Terjemahkan semua nama dan deskripsi langganan
  • Pertimbangkan perbedaan harga regional
  • Uji tampilan di semua bahasa yang didukung
  • Gunakan bahasa marketing yang sesuai dengan budaya lokal
  • Jaga konsistensi gaya visual
  • Sertakan nama langganan dan manfaat utama
  • Perbarui untuk promosi musiman
  • Sesuaikan dengan bahasa desain aplikasi

Common Subscription Patterns

Bagian berjudul “Pola Langganan Umum”
Free App + Premium Subscription
- Basic: Free (limited features)
- Premium Monthly: $4.99
- Premium Annual: $39.99 (save 33%)
- Basic Monthly: $4.99
- Premium Monthly: $9.99
- Ultimate Monthly: $19.99
- Basic Annual: $49.99
- Premium Annual: $99.99
- Ultimate Annual: $199.99
- Credit packs (consumable)
- Monthly subscription (unlimited credits)
- Annual subscription (unlimited + bonus features)

Langganan tidak dimuat di aplikasi:

  • Pastikan product ID cocok persis (case-sensitive)
  • Periksa apakah langganan berada dalam grup langganan
  • Pastikan bundle identifier cocok dengan App Store Connect
  • Tunggu 2-3 jam setelah membuat produk

Tidak dapat mengirim langganan:

  • Lengkapi semua kolom wajib (nama, deskripsi, harga)
  • Tambahkan minimal satu lokalisasi
  • Pastikan info perbankan/pajak disetujui
  • Periksa langganan pertama (memerlukan versi aplikasi)

Toggle Family Sharing dinonaktifkan:

  • Sudah diaktifkan (tidak bisa dinonaktifkan)
  • Periksa di detail langganan
  • Hubungi Apple Support jika macet

Tier harga tidak tersedia:

  • Mungkin dibatasi di beberapa wilayah
  • Pilih tier alternatif
  • Hubungi Apple untuk pertanyaan harga

Error “Invalid Product ID”:

  • Harus berformat reverse domain
  • Tidak boleh ada spasi atau karakter spesial
  • Periksa typo
  • Pastikan ID unik di semua produk

Untuk detail lebih lanjut, lihat dokumentasi resmi Apple tentang langganan yang diperpanjang otomatis.

Lanjutkan dari membuat langganan iOS yang diperpanjang otomatis

Bagian berjudul “Lanjutkan dari membuat langganan iOS yang diperpanjang otomatis”

Jika Anda menggunakan Membuat langganan iOS yang diperpanjang otomatis 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.