iOS App Store Review Guidelines untuk IAP
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Agar aplikasi Anda disetujui di App Store, Anda perlu memperhatikan panduan Apple dengan saksama, terutama saat mengimplementasikan in-app purchase dan langganan. Panduan ini membahas semua yang perlu Anda ketahui agar lolos review pada pengajuan pertama.

Sebelum Submit
Bagian berjudul “Sebelum Anda Submit”Selesaikan Setup App Store Connect
Bagian berjudul “Selesaikan Setup App Store Connect”Sebelum Apple mereview alur pembelian Anda, pastikan data aplikasi sudah lengkap:
- Tambahkan URL Kebijakan Privasi di App Store Connect
- Tambahkan URL Dukungan yang mengarah ke informasi kontak pengguna yang sebenarnya
- Selesaikan rating usia kuesioner agar aplikasi dapat dipublikasikan
- Tambah Detail kontak App Review dan catatan reviewer yang jelas
- Jika login diperlukan, berikan akun demo yang tidak kedaluwarsa selama peninjauan
Siapkan Screenshot Asli
Bagian berjudul “Siapkan Screenshot Asli”- Gunakan screenshot terbaru dari build asli yang sedang ditinjau
- Untuk iPhone,
1290 x 2796(6.7-inci) adalah ukuran default termudah - Jika aplikasi Anda berjalan di iPad, upload screenshot iPad juga
- Ukuran iPad besar yang saat ini diterima meliputi
2064 x 2752(13-inci) dan2048 x 2732(12.9-inci) - Jangan paksa screenshot iPhone agar terlihat seperti support iPad
Simulasi Alur Reviewer di TestFlight
Bagian berjudul “Simulasi Alur Reviewer di TestFlight”Jalankan alur yang sama persis dengan Apple pada perangkat asli:
- Install build terbaru dari TestFlight
- Login dengan akun review yang akan Anda berikan
- Masuk ke paywall tanpa gesture tersembunyi atau menu debug
- Selesaikan alur purchase, restore, dan manage-subscription
- Verifikasi aplikasi tetap berjalan normal jika izin ditolak
Persyaratan In-App Purchase
Bagian berjudul “Persyaratan In-App Purchase”Transparansi Harga (Kritis)
Bagian berjudul “Transparansi Harga (Kritis)”Apple mewajibkan pengungkapan harga yang sangat jelas sebelum pembelian:
Elemen yang Wajib Ada:
- Tampilkan harga eksak sebelum tombol beli
- Tampilkan frekuensi penagihan (misal, “$9.99/bulan”)
- Sebutkan dengan jelas manfaat yang didapat pengguna
- Indikasikan kapan penagihan akan dilakukan
Alasan Penolakan Umum:
“Harga langganan harus jelas dan transparan.”
:::caution Konsistensi Harga Semua harga harus sama di:
- Listing metadata App Store
- Layar in-app purchase
- Layar manajemen langganan
Selisih harga sebesar $1 saja antara listing toko ($4.99) dan aplikasi ($5.99) akan memicu penolakan otomatis. :::
Presentasi Paket Langganan
Bagian berjudul “Presentasi Paket Langganan”Pengungkapan yang Diperlukan:
- Semua tier langganan ditampilkan bersamaan
- Perbandingan fitur tiap tier yang jelas
- Tidak ada trik UI untuk otomatis memilih tier premium
- Instruksi pembatalan mudah ditemukan

Contoh UI yang Patuh:
import { NativePurchases } from '@capgo/native-purchases';
function SubscriptionScreen() { return ( <div> <h2>Choose Your Plan</h2>
{/* Show all tiers equally */} <PlanCard title="Basic" price="$4.99/month" features={['Feature A', 'Feature B']} /> <PlanCard title="Premium" price="$9.99/month" features={['All Basic', 'Feature C', 'Feature D']} highlighted={false} // Don't force premium />
{/* Clear cancellation info */} <Text> Cancel anytime in Settings > Subscriptions. No refunds for partial periods. </Text> </div> );}Pulihkan Pembelian
Bagian berjudul “Pulihkan Pembelian”Implementasi Wajib:
Setiap aplikasi dengan IAP harus menyediakan cara bagi pengguna untuk memulihkan pembelian sebelumnya tanpa perlu menghubungi support.
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
async function restorePurchases() { try { await NativePurchases.restorePurchases();
const { purchases } = await NativePurchases.getPurchases({ productType: PURCHASE_TYPE.SUBS, });
const activeSub = purchases.find( (purchase) => purchase.isActive && purchase.expirationDate, );
if (activeSub) { unlockPremiumFeatures(); showMessage('Purchases restored successfully!'); return; }
const { purchases: iaps } = await NativePurchases.getPurchases({ productType: PURCHASE_TYPE.INAPP, }); const hasIap = iaps.some((purchase) => purchase.productIdentifier === 'premium_unlock');
showMessage( hasIap ? 'Premium purchase restored!' : 'No previous purchases found.', ); } catch (error) { showError('Failed to restore purchases. Please try again.'); }}
// Add a visible "Restore Purchases" button<Button onClick={restorePurchases}> Restore Purchases</Button>Alasan Penolakan Umum
Bagian berjudul “Alasan Penolakan Umum”1. Aplikasi Crash atau Fungsi Rusak
Bagian berjudul “1. Aplikasi Crash atau Fungsi Rusak”Mengapa Gagal:
- Aplikasi crash saat dibuka
- Alur pembelian gagal diselesaikan
- Fitur di screenshot tidak berfungsi
Pencegahan:
- Tes di perangkat fisik (bukan hanya simulator)
- Tes semua alur langganan end-to-end
- Verifikasi validasi receipt berfungsi
- Cek penanganan error jaringan
2. Ketidaksesuaian metadata
Bagian berjudul “2. Ketidaksesuaian metadata”Mengapa Gagal:
- Screenshot menampilkan fitur yang tidak ada di build saat ini
- Deskripsi menyebutkan fungsi yang tidak tersedia
- Harga di metadata berbeda dengan harga in-app

Pencegahan:
// Document exactly what's in each tierconst SUBSCRIPTION_FEATURES = { basic: ['Ad-free', 'Cloud sync', 'Basic themes'], premium: ['Ad-free', 'Cloud sync', 'All themes', 'Priority support']};
// Use these in both your app AND App Store description3. Penjelasan Izin yang Hilang
Bagian berjudul “3. Penjelasan Izin yang Hilang”Mengapa Gagal:
- Meminta izin kamera/lokasi/kesehatan tanpa penjelasan
- Permintaan izin tersembunyi di balik beberapa layar
- Deskripsi izin yang tidak jelas atau generik
Pencegahan:
Perbarui file Info.plist dengan penjelasan yang jelas:
<key>NSCameraUsageDescription</key><string>Camera access is needed to scan product barcodes for quick subscription upgrades.</string>
<key>NSLocationWhenInUseUsageDescription</key><string>Location helps us show relevant local content in your Premium subscription.</string>4. Pemasaran yang Menyesatkan
Bagian berjudul “4. Pemasaran yang Menyesatkan”Mengapa Gagal:
- Klaim seperti “aplikasi #1 di dunia” tanpa bukti
- Fitur “unlimited” yang ternyata punya batasan tersembunyi
- Taktik urgensi palsu (“Sisa 2 slot lagi!”)


Pencegahan:
- Berikan deskripsi yang spesifik dan faktual
- Hindari kata superlatif tanpa bukti
- Jangan menekan pengguna dengan kelangkaan palsu
5. Proses Pembatalan yang Tersembunyi
Bagian berjudul “5. Proses Pembatalan yang Tersembunyi”Mengapa Gagal:
- Tidak ada info cara membatalkan
- Tombol pembatalan tersembunyi atau sulit ditemukan
- Proses pembatalan multi-langkah tanpa alur native Apple
Pencegahan:
// Always inform users about cancellationfunction SubscriptionInfo() { return ( <div> <h3>How to Cancel</h3> <ol> <li>Open iPhone Settings</li> <li>Tap your name at the top</li> <li>Tap Subscriptions</li> <li>Select this app and tap Cancel</li> </ol>
<p>Or manage directly in the App Store app.</p>
<Button onClick={openSubscriptionManagement}> Manage Subscription in Settings </Button> </div> );}
async function openSubscriptionManagement() { // Direct link to iOS subscription management await NativePurchases.showManageSubscriptions();}Privasi & Penggunaan Data (Bagian 5.1.1)
Bagian berjudul “Privasi & Penggunaan Data (Bagian 5.1.1)”Apple telah memperketat persyaratan privasi secara signifikan pada 2025.
Pengungkapan Wajib
Bagian berjudul “Pengungkapan Wajib”Untuk Setiap Izin:
- Why you need it (specific use case)
- Kapan izin akan digunakan
- Cara data disimpan/dibagikan
- Apakah bersifat opsional atau wajib
Contoh: Alur Izin yang Benar
Bagian berjudul “Contoh: Alur Izin yang Tepat”async function requestCameraPermission() { // Show explanation BEFORE requesting await showDialog({ title: 'Camera Access', message: 'We need camera access to let you scan barcodes for quick product lookup. Your photos are never uploaded or stored.', buttons: ['Not Now', 'Allow'] });
// Then request permission const result = await Camera.requestPermissions(); return result.camera === 'granted';}Label Nutrisi Privasi
Bagian berjudul “Privacy Nutrition Labels”Pastikan label privasi App Store Anda mencerminkan:
- Pengumpulan riwayat pembelian
- Alamat email (untuk tanda terima)
- Device ID (untuk pencegahan fraud)
- Data penggunaan (untuk analitik)
Label privasi yang tidak akurat sering jadi alasan penolakan pada 2025. Audit pengumpulan data Anda dengan teliti.
Checklist Pra-Submit
Bagian berjudul “Checklist Sebelum Submit”
-
Tes Semua Alur Pembelian
- Beli setiap tier langganan
- Tes free trial
- Verifikasi penawaran intro sudah sesuai
- Tes restore purchases
- Verifikasi Family Sharing (jika aktif)
- Tes di beberapa perangkat
-
Verifikasi Konsistensi Harga
- Cek metadata App Store sesuai harga in-app
- Verifikasi semua mata uang sudah benar
- Pastikan durasi free trial sesuai deskripsi
- Cek akurasi syarat penawaran intro
-
Review Semua Copy
- Hapus teks placeholder
- Pastikan klaim dapat diuji
- Cek tata bahasa dan ejaan
- Pastikan deskripsi sesuai build saat ini
- Hapus penyebutan kompetitor
-
Test Permissions
- Minta izin yang diperlukan saja
- Tampilkan penjelasan jelas sebelum meminta izin
- Test alur “Deny” (app harus tetap jalan)
- Pastikan deskripsi Info.plist sudah jelas
-
Siapkan Akun Test
- Buat akun review yang tetap valid selama proses review
- Dokumentasikan kredensial login di informasi App Review
- Pastikan reviewer bisa mengakses paywall dan menyelesaikan alur pembelian
- Sertakan akun tambahan atau switch khusus aplikasi di kolom Notes jika perlu
-
Periksa Metadata
- Screenshot sesuai dengan UI saat ini
- URL Support menyertakan informasi kontak asli
- URL kebijakan privasi sudah diisi
- Rating usia sesuai dengan konten dalam build
- Video preview aplikasi (jika ada) menampilkan versi terbaru
- Deskripsi menjelaskan fitur secara akurat
- Kebijakan privasi dapat diakses di dalam aplikasi dan di listing store
-
Tulis Catatan Review Detail
Contact:Name: Jane DeveloperEmail: review@yourapp.comPhone: +1 555-0100Test Account:Email: reviewer@test.comPassword: TestPass123!This account does not expire during review.Testing Instructions:1. Log in with test account above2. Tap "Upgrade to Premium" button3. Select "Monthly Premium" subscription4. Complete purchase (no charge in sandbox)5. Verify premium features unlockNote: Subscription pricing is clearly shown before purchase.Cancellation instructions are in Settings > Account.
Timeline Review
Bagian berjudul “Review Timeline”
Review Standar: 24-48 jam Periode Sibuk: 3-5 hari (Rilis libur App Store) Akhir Pekan: Tidak ada review diproses Review Ekspres: Tersedia untuk perbaikan bug kritis (ajukan via App Store Connect)
Status umum yang akan Anda lihat di App Store Connect:
Waiting for ReviewIn ReviewPending Developer ReleaseRejected
Fokus Submit 2026
Bagian berjudul “Fokus Pengajuan 2026”Area Fokus Saat Ini
Bagian berjudul “Area Fokus Saat Ini”1. Kejelasan Langganan
- Wajib ada perbandingan paket berdampingan
- Tidak ada “dark patterns” yang menyembunyikan opsi lebih murah
- Jalur downgrade/upgrade yang jelas
2. Akurasi Metadata
- Screenshot harus sesuai dengan build yang direview
- Screenshot iPad wajib ada jika dukungan iPad diaktifkan
- URL Support dan kebijakan privasi harus sudah live sebelum submit
3. Kualitas Privasi dan Detail Review
- Pengungkapan privasi harus sesuai dengan data yang dikumpulkan SDK Anda
- Info kontak dan catatan App Review harus lengkap pada submit pertama
- Kredensial demo harus tetap valid selama masa review
4. Kesiapan Submission
- Apple rutin memperbarui persyaratan minimum SDK, jadi pastikan deadline terbaru sebelum upload release build
- TestFlight adalah cara teraman untuk verifikasi alur reviewer sebelum Anda submit
Best Practices untuk Plugin Native Purchases
Bagian berjudul “Best Practices untuk Plugin Native Purchases”Terapkan Error Handling yang Tepat
Bagian berjudul “Implementasi Error Handling yang Tepat”import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
async function handlePurchase(productId: string) { try { const transaction = await NativePurchases.purchaseProduct({ productIdentifier: productId, productType: PURCHASE_TYPE.SUBS, });
// Success await validateReceiptOnServer(transaction.receipt); showSuccess('Subscription activated!'); unlockFeatures();
} catch (error: any) { // Handle specific error cases if (error.code === 'USER_CANCELLED') { // User cancelled - don't show error console.log('Purchase cancelled by user'); } else if (error.code === 'PAYMENT_PENDING') { showInfo('Payment is pending. Please check back later.'); } else if (error.code === 'PRODUCT_ALREADY_PURCHASED') { // Restore instead await NativePurchases.restorePurchases(); } else { // Show user-friendly error showError('Unable to complete purchase. Please try again.'); } }}Tampilkan Loading State
Bagian berjudul “Tampilkan Loading State”function PurchaseButton({ productId }: { productId: string }) { const [loading, setLoading] = useState(false);
const handlePurchase = async () => { setLoading(true); try { await NativePurchases.purchaseProduct({ productIdentifier: productId }); } finally { setLoading(false); } };
return ( <button onClick={handlePurchase} disabled={loading}> {loading ? 'Processing...' : 'Subscribe Now'} </button> );}Tampilkan Syarat dengan Jelas
Bagian berjudul “Tampilkan Ketentuan dengan Jelas”function SubscriptionTerms() { return ( <div className="terms"> <p> Subscription automatically renews unless cancelled at least 24 hours before the end of the current period. </p> <p> Your account will be charged for renewal within 24 hours prior to the end of the current period. </p> <p> Subscriptions may be managed by the user and auto-renewal may be turned off in Account Settings after purchase. </p> <p> <a href="/terms">Terms of Service</a> | <a href="/privacy/">Privacy Policy</a> </p> </div> );}Jika Aplikasi Anda Ditolak
Bagian berjudul “Jika Aplikasi Anda Ditolak”Langkah Penyelesaian
Bagian berjudul “Langkah Penyelesaian”-
Baca alasan penolakan dengan teliti
- Catat guideline spesifik yang dikutip (misal: 3.1.1, 5.1.1)
- Pahami persis apa yang ditandai Apple
-
Perbaiki masalah secara menyeluruh
- Jangan sekadar patch - perbaiki root cause
- Uji perbaikan secara menyeluruh
- Dokumentasikan apa saja yang diubah
-
Balas melalui Resolution Center
Thank you for your feedback. I have addressed the issue:Issue: Subscription pricing not clear upfrontFix: Added explicit pricing display on subscription selectionscreen showing "$9.99/month" before purchase button. Also addedcancellation instructions on the same screen.The changes are in this submission and can be tested using theprovided test account. -
Segera ajukan ulang
- Pengajuan ulang biasanya ditinjau lebih cepat
- Biasanya dalam 24 jam
Proses Banding
Bagian berjudul “Proses Banding”Jika Anda merasa penolakan tersebut salah:

- Klik “Appeal” di App Store Connect
- Berikan bukti yang jelas:
- Screenshot yang menunjukkan kepatuhan
- Referensi ke guideline spesifik
- Penjelasan cara Anda memenuhi persyaratan
- Bersikap profesional dan faktual
- Sertakan akun uji jika fitur sulit ditemukan

Sumber daya tambahan
Bagian berjudul “Sumber daya tambahan”- Panduan Review Apple App Store
- Panduan In-App Purchase
- Best Practice Langganan
- Bantuan App Store Connect
- Spesifikasi Screenshot
- Informasi Versi Platform
Dukungan
Bagian berjudul “Support”Jika Anda masih mengalami kendala:
- Tinjau Dokumentasi Native Purchases
- Periksa masalah troubleshooting umum
- Hubungi Apple Developer Support untuk klarifikasi panduan
Butuh bantuan ahli?
Bagian berjudul “Butuh bantuan ahli?”Kesulitan dengan review aplikasi atau butuh bantuan personal? Jadwalkan sesi konsultasi dengan tim kami untuk dukungan khusus terkait:
- Review dan optimasi implementasi IAP
- Persiapan dan strategi review App Store
- Review checklist submission
- Penanganan penolakan dan banding
- Testing dan validasi lengkap
Para ahli kami telah berhasil membantu ratusan aplikasi lolos review!
Lanjutkan dari iOS App Store Review Guidelines untuk IAP
Bagian berjudul “Lanjutkan dari iOS App Store Review Guidelines untuk IAP”Jika Anda menggunakan iOS App Store Review Guidelines untuk IAP 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.