Missing Metadata App Store Connect: cara buka langganan
Oleh Mehdi Azizi
Terbit , 9 mnt
Missing Metadata berarti ada kolom wajib yang kosong. Cek bahasa, harga, durasi, negara, screenshot review, dan kontrak aplikasi berbayar.
Missing Metadata di App Store Connect artinya langganan atau pembelian dalam aplikasi (in-app purchase) kamu masih kekurangan minimal satu informasi wajib. Cek secara berurutan: bahasa, harga, durasi, negara, screenshot review, dan kontrak aplikasi berbayar. Selama produk masih berstatus ini, kamu tidak bisa mengirimnya ke review, dan aplikasimu tidak bisa memuatnya. Selain itu, langganan pertama harus dikirim bersama satu versi aplikasi.
Saya mengalami status ini pada Juli 2026 di TradaZen, simulator trading saya. Langganan mingguan yang baru sudah punya durasi, harga, grup, dan dua bahasa. Tapi statusnya tetap Missing Metadata. Satu-satunya yang kurang adalah screenshot review. Berikut penyebab yang perlu dicek, status-status sebuah produk beserta cara membukanya, lalu hubungannya dengan RevenueCat.
Apa arti Missing Metadata?
Sampai tahun ini, halaman bantuan Apple mendefinisikan status ini begini: produk sudah dibuat, tapi kamu belum mengunggah screenshot atau belum melengkapi metadatanya. Status ini tidak pernah memberi tahu kolom mana yang kosong. Itulah masalahnya: kamu harus mencarinya sendiri.
Hati-hati, labelnya berubah pada Juli 2026. Catatan rilis App Store Connect mengumumkan cara pengiriman baru per 15 Juli: setiap in-app purchase dikirim dari halamannya sendiri, lewat Add for Review. Halaman status tidak lagi mencantumkan "Missing Metadata". Daftarnya dimulai dengan "Prepare for Submission" dan menjelaskan: kalau in-app purchase kamu kekurangan metadata wajib, lengkapi dulu sebelum menambahkannya ke submission. Dokumentasi RevenueCat mengonfirmasi hal ini: sebelum review, produk baru tampil sebagai "Prepare for Submission", meskipun metadatanya belum lengkap.
Sementara itu, API App Store Connect masih mengembalikan MISSING_METADATA lalu READY_TO_SUBMIT. Jadi tool yang memakai API ini masih menampilkan istilah tersebut. Apa pun labelnya, diagnosisnya sama: ada kolom wajib yang kosong.
Penyebab yang perlu dicek, secara berurutan
Saya mengeceknya dengan urutan ini, dari halaman produk sampai akun.
| Penyebab | Tempat memperbaiki |
|---|---|
| Nama atau deskripsi kosong | Halaman produk |
| Grup tanpa nama tampilan | Halaman grup |
| Harga atau durasi belum diisi | Halaman produk |
| Tidak ada negara yang tersedia | Availability |
| Screenshot review belum ada | Review Information |
| Kontrak berbayar tidak aktif | Business |
| Langganan pertama dikirim sendiri | Submission |
1. Bahasa produk. Menurut halaman informasi in-app purchase, nama tampilan dan deskripsi wajib diisi minimal dalam satu bahasa. Nama panjangnya 2 sampai 30 karakter, deskripsi maksimal 45. Produk tanpa bahasa tidak bisa dikirim.
2. Bahasa grup. Grup langganan juga punya nama tampilan, yang dilihat pelangganmu saat mengelola langganan di iPhone. Nama ini ditambahkan di halaman grup, bagian Display Name and Description, seperti dijelaskan di halaman Apple tentang langganan. Kolom ini tidak terlihat wajib. Tapi seorang developer bercerita di forum Apple bahwa semua langganan di grupnya tertahan selama kolom itu kosong. Statusnya muncul di langganan, bukan di grup, makanya membingungkan.
3. Harga dan durasi. Sebuah langganan butuh durasi, dari satu minggu sampai satu tahun, dan harga. Catatan teknis TN3186 memulai dari sini saat produk tidak termuat: cek ID produk, harga, dan bahasanya. Ingat juga, durasi tidak bisa diubah lagi setelah dikirim ke review.
4. Ketersediaan. Pilih minimal satu negara atau wilayah di Availability. Apple menegaskan bahwa tanpa ketersediaan, status "Approved" tidak bisa muncul.
5. Screenshot review. Ini kasus saya di TradaZen, dan penyebab yang sering muncul di forum. Screenshot "App Review Screenshot" menunjukkan pembelian seperti yang tampil di aplikasi, biasanya paywall kamu. Screenshot ini hanya untuk reviewer dan tidak pernah ditampilkan di App Store. Formatnya mengikuti screenshot App Store kamu. Setelah diunggah, kamu bisa menggantinya, tapi tidak bisa menghapusnya.
Jangan tertukar dengan gambar promosi 1024 x 1024 piksel. Gambar itu hanya dipakai kalau kamu menonjolkan pembelian di halaman aplikasimu atau membuat penawaran win-back, dan aturannya sendiri. Saya belajar ini dari penolakan soal gambar promosi langganan.
6. Kontrak aplikasi berbayar. Untuk menawarkan in-app purchase, pemilik akun harus menandatangani Paid Apps Agreement di Business, lalu mengisi data bank dan pajak. Ini bukan kolom produk, tapi semuanya bergantung padanya. Apple menulis bahwa kamu tidak bisa membuat in-app purchase baru selama belum menyetujui versi terbaru kontrak. Halamannya tentang menyiapkan pembelian untuk review menambahkan bahwa pembelian berbayar tidak berfungsi saat review selama kontrak ini belum aktif. Di Business, kontrak, rekening bank, dan formulir pajak harus aktif semuanya. Langkah-langkahnya dijelaskan di panduan akun developer Apple.
7. Langganan pertama dikirim sendirian. Ini bukan metadata yang kurang. Tapi justru inilah alasan paling umum produk yang sudah lengkap tidak pernah masuk review. Saya jelaskan lebih detail di bawah.
Status produk dan cara membuka masing-masing
Ini checklist yang selalu saya pegang. Kolom pertama berisi status dari API, kolom kedua label di bantuan Apple sejak Juli 2026.
| Status (API) | Label saat ini | Cara membukanya |
|---|---|---|
| MISSING_METADATA | Prepare for Submission | Isi kolom yang kosong |
| READY_TO_SUBMIT | Prepare for Submission | Add for Review |
| Tidak ada padanan | Ready for Review | Submit for Review |
| WAITING_FOR_REVIEW | Waiting for Review | Tunggu Apple |
| IN_REVIEW | In Review | Tunggu Apple |
| APPROVED | Approved | Negara dan aplikasi lolos |
| REJECTED | Rejected | Perbaiki, Update Review |
Detailnya:
- Missing Metadata ke Ready to Submit. Isi kolom dari penyebab 1 sampai 5, simpan, muat ulang halaman. Layar yang saya lihat di bulan Juli menampilkan Missing Metadata, dan status berikutnya bernama Ready to Submit.
- Ready to Submit ke Ready for Review. Di halaman langganan, klik Add for Review lalu tambahkan ke submission yang sudah ada atau yang baru. Prosedur pengiriman in-app purchase memintamu memilih platform, versi aplikasi, dan kalau perlu, grupnya. Sejak saat itu, hanya nama referensi, harga, dan ketersediaan yang masih bisa diubah.
- Ready for Review ke Waiting for Review. Pastikan versi aplikasi dan grup ada di submission yang sama, lalu klik Submit for Review.
- Waiting for Review ke Approved. Tidak ada yang perlu dilakukan, selain menjaga paywall tetap berfungsi. Kalau pembelian berstatus "Accepted" dan bukan "Approved", berarti ada elemen lain di submission yang sama yang ditolak: Apple tidak menyetujui apa pun sampai semuanya diterima.
- Rejected. Alasannya muncul di pesan submission. Perbaiki elemennya, klik Update Review, lalu kirim ulang submission.
Langganan pertama dikirim bersama versi aplikasi
Aturannya ada di bantuan Apple: langganan pertama, seperti pembelian pertama dari setiap jenis, harus dikirim bersama versi baru aplikasi. Grup baru dikirim dengan minimal satu langganannya. Setelah elemen pertama ini disetujui, kamu bisa mengirim yang berikutnya dari jenis yang sama tanpa versi baru, selama aplikasi punya versi yang sudah disetujui.
Itulah yang terjadi di TradaZen. Versi bulan Juli dikirim dengan langganan tahunan dan bulanan. Yang mingguan, masih berstatus Missing Metadata, tidak ikut dalam submission. Setelah aplikasi disetujui, langganan mingguan itu bisa dikirim sendiri, tanpa build baru.
Kalau kamu mengirim aplikasi tanpa langganannya, kamu butuh versi baru untuk meloloskannya. Panduan tentang lama review App Store menunjukkan berapa hari yang hilang karena siklus tambahan ini.
Hubungannya dengan RevenueCat: offering kosong
RevenueCat sendiri tidak menjual apa pun. SDK-nya membaca ID produkmu dari server RevenueCat, lalu meminta produk ke App Store, dari iPhone. Kalau App Store tidak mengembalikannya, offering datang kosong dan paywall kamu tidak punya apa-apa untuk ditampilkan. Log SDK lalu menampilkan: "There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store."
Menurut RevenueCat, produk dengan metadata lengkap bisa dimuat di sandbox bahkan sebelum review. Produk yang belum lengkap, tidak bisa. Kemungkinan lain dari RevenueCat dan Apple:
- kontrak aplikasi berbayar dan data bank, yang bisa butuh hingga 24 jam untuk tersebar menurut RevenueCat;
- perubahan pada produk, yang bisa butuh hingga satu jam untuk sampai ke sandbox menurut Apple;
- ID produk yang berbeda antara App Store Connect, RevenueCat, dan kode kamu.
Di TradaZen, kode menyembunyikan kartu langganan yang produknya tidak dikembalikan, tanpa merusak paywall. Pada Oktober 2026, saya melihat paywall tanpa offering karena alasan lain: offering yang dibaca dari cache SDK kosong. Sejak itu, kalau offering kosong, kode aplikasi meminta produk langsung ke StoreKit, dan menawarkan coba lagi kalau store tidak merespons.
Paywall tanpa offering tidak boleh jadi jalan buntu, baik bagi pengguna maupun bagi reviewer, yang harus bisa membeli. Penyiapan lengkapnya ada di panduan saya RevenueCat untuk langganan iOS, dan jebakan tampilannya di kesalahan paywall. Setelah produk siap, pastikan juga paywall kamu mematuhi guideline 3.1.2.
Menyambungkan langganan tanpa menghabiskan seminggu
iOS & Android Kit berangkat dari kode awal aplikasi-aplikasi saya: onboarding, paywall, dan langganan sudah dikodekan, dan langkah ketiganya, "menyambungkan uang", memandumu mengaturnya. Seluruh rantainya, dari produk App Store Connect sampai verifikasi pembelian, dijelaskan di halaman langganan in-app iOS.
Kalau kamu sedang menyiapkan rilis pertama, ikuti diagnostik gratis: diagnostik ini menyusun ulang langkah-langkahnya dan mengirimkan checklist anti-penolakan Apple saya. Kalau langgananmu tetap tertahan meski sudah begini semua, pesan satu jam bersama saya: kita buka App Store Connect kamu bersama dan cari kolom yang kosong.
Pertanyaan umum
Kenapa langgananku tetap Missing Metadata padahal semua sudah diisi?
Cek dulu screenshot review, lalu nama tampilan grup langganan, yang tidak terlihat wajib. Setelah itu periksa harga, durasi, minimal satu negara, dan kontrak aplikasi berbayar di Business. Setiap selesai memperbaiki, simpan dan muat ulang halaman sebelum menyimpulkan.
Apakah langganan butuh screenshot?
Ya, screenshot review, yang disebut App Review Screenshot. Screenshot ini menunjukkan pembelian di aplikasi, biasanya paywall, dan hanya untuk reviewer. Tidak ditampilkan di App Store. Jangan tertukar dengan gambar promosi 1024 x 1024 piksel, yang hanya berguna untuk menonjolkan pembelian atau untuk penawaran win-back.
Bisakah mengirim langganan tanpa versi baru aplikasi?
Untuk yang pertama, tidak bisa. Langganan pertama dan grupnya dikirim bersama versi baru aplikasi. Setelah langganan pertama ini disetujui, langganan berikutnya bisa dikirim sendiri, selama aplikasi punya versi yang sudah disetujui.
Apa arti Prepare for Submission untuk in-app purchase?
Itu label di bantuan Apple sejak Juli 2026 untuk produk yang belum ditambahkan ke submission. Label ini muncul meskipun metadatanya belum lengkap. API App Store Connect masih membedakan kedua kasus ini, dengan MISSING_METADATA dan READY_TO_SUBMIT.
Kenapa RevenueCat mengembalikan offering kosong?
Karena App Store tidak mengembalikan produk apa pun ke iPhone. Penyebab paling umum: metadata belum lengkap, kontrak aplikasi berbayar tidak aktif, ID produk berbeda, atau perubahan terbaru belum tersebar. Paywall kamu harus menangani kasus ini tanpa menghalangi pengguna.

