Play Billing Library 8 kini wajib untuk setiap update Google Play, dan pelacakan refund pindah ke server Anda
Perpanjangan dari Google untuk Play Billing Library 7 berakhir pada 1 November 2026, jadi aplikasi baru dan update kini membutuhkan versi 8 atau yang lebih baru. Versi 8 menghapus queryPurchaseHistory(), artinya pembelian yang di-refund dan sudah dikonsumsi harus dilacak di sisi server. Berikut apa yang berubah dan berapa biaya migrasi yang lambat.

Poin utama
- Tabel penghentian Google menetapkan 31 Agustus 2026 sebagai hari terakhir untuk aplikasi baru dan update di Play Billing Library 7, dengan perpanjangan yang berakhir pada 1 November 2026, jadi setiap update Google Play kini membutuhkan Play Billing Library 8 atau yang lebih baru.
- Aplikasi yang sudah tayang dengan Play Billing Library 7 tetap berjalan, karena Google menyatakan penghentian ini hanya memblokir aplikasi baru dan update, bukan instalasi yang sudah ada.
- Play Billing Library 8 menghapus queryPurchaseHistory(), dan pengganti dari Google berjalan di server. Lacak pembelian yang sudah dikonsumsi di backend Anda sendiri, lalu ambil pembelian yang di-refund atau dibatalkan dari Voided Purchases API.
- Voided Purchases API di Google Play hanya menampilkan pembelian yang dibatalkan dalam 30 hari terakhir, dan mengizinkan 6,000 kueri per hari serta 30 kueri dalam periode 30 detik mana pun per aplikasi.
- Google Play tetap me-refund pembelian secara otomatis dan mencabut hak akses jika aplikasi tidak melakukan acknowledge dalam tiga hari, dan migrasi Play Billing Library 8 yang rusak bisa memicu hal itu di setiap penjualan.
- Tinjauan chargeback Google Play adalah satu-satunya alur refund Android yang meminta bukti dari developer, melalui orders.reviewrefund dalam 24 jam setelah PendingRefundReviewNotification.
- Untuk pesanan Google Play yang dibuat setelah 3 Agustus 2026, developer membayar harga pembelian, dikurangi biaya layanan Play, ditambah biaya chargeback dari bank untuk setiap chargeback yang kalah.
Setiap aplikasi Android yang berjualan lewat Google Play kini harus menyertakan Play Billing Library 8 atau yang lebih baru di update berikutnya. Tenggat versi 7 untuk aplikasi baru dan update adalah 31 Agustus 2026, dan perpanjangan terakhir berakhir pada 1 November 2026. Tanggal tersebut tercantum dalam tabel di FAQ penghentian Google, dan pengingatnya muncul sebagai peringatan di halaman Policy status pada Play Console.
Bagi sebagian besar tim, ini hanya kenaikan versi dependensi dan beberapa method yang berganti nama. Untuk refund, dampaknya lebih besar. Play Billing Library 8 menghapus satu-satunya panggilan klien yang memungkinkan aplikasi melihat pembelian lama. Mulai sekarang, jika Anda ingin tahu apa yang dibeli, dikonsumsi, atau di-refund oleh pengguna, server Anda yang harus mengingatnya.
Apa yang sebenarnya diblokir oleh tenggat Play Billing Library 8
Google memberi setiap versi library masa pakai dua tahun. Penghentian ini hanya menghentikan aplikasi baru dan update. FAQ Google menyatakan aplikasi yang sudah ada tetap berjalan dan APK yang tidak dipelihara tidak perlu diperbarui. Jadi tidak ada yang rusak hari ini pada aplikasi yang sudah tidak Anda sentuh. Masalah muncul pada hari Anda mencoba merilis perbaikan, harga baru, atau paywall baru.
| Versi library | Tenggat aplikasi baru dan update | Tenggat perpanjangan |
|---|---|---|
| 6 | 31 Agustus 2025 | 1 November 2025 |
| 7 | 31 Agustus 2026 | 1 November 2026 |
| 8 | 31 Agustus 2027 | 1 November 2027 |
| 9 | 31 Agustus 2028 | 1 November 2028 |
Versi 8.0.0 dirilis pada 30 Juni 2025. Versi 9.0.0 menyusul pada 19 Mei 2026. Jika Anda bermigrasi sekarang, langsung ke 9 memberi Anda satu tahun lebih lama dibanding berhenti di 8.
Mengapa Play Billing Library 8 penting untuk refund
Penghapusan utamanya adalah queryPurchaseHistory(). Fungsi ini dinyatakan usang di versi 7 dan dihapus di versi 8.0.0. Catatan migrasi Google membagi tugas lamanya menjadi tiga bagian, dan hanya satu yang tetap ada di perangkat.
| Untuk apa Anda memakai queryPurchaseHistory() | Yang kini disarankan Google | Tempat berjalannya |
|---|---|---|
| Pembelian aktif dan tertunda | queryPurchasesAsync() | Di perangkat |
| Pembelian sekali bayar yang sudah dikonsumsi | Catatan Anda sendiri | Server Anda |
| Pembelian yang di-refund, dibatalkan, atau terkena chargeback | Voided Purchases API | Server Anda |
| Riwayat pembelian lengkap pengguna | Catatan Anda sendiri | Server Anda |
Apakah saya masih bisa memulihkan pembelian consumable di Android?
Tidak dari klien. queryPurchasesAsync() hanya mengembalikan yang aktif, jadi paket kredit yang sudah dikonsumsi atau paket gem yang sudah habis tidak akan pernah kembali lewat fungsi itu. Jika pengguna menginstal ulang dan bertanya ke mana koinnya, jawabannya harus datang dari ledger yang Anda simpan saat pembelian terjadi. Aplikasi yang mengandalkan riwayat pembelian sebagai cadangan gratis kini kehilangannya.
Bagaimana saya mengetahui refund sekarang?
Ada dua saluran di sisi server. Real-time developer notifications mengirim VoidedPurchaseNotification berisi token pembelian, ID pesanan, jenis produk, dan jenis refund, yaitu refund penuh atau refund sebagian berdasarkan jumlah. Voided Purchases API memungkinkan Anda menarik peristiwa yang sama berdasarkan rentang waktu, sebagai cadangan untuk apa pun yang terlewat.
API tarik ini punya batas yang tegas. API ini hanya menampilkan pembelian yang dibatalkan dalam 30 hari terakhir. Setiap aplikasi mendapat 6,000 kueri per hari dan 30 kueri dalam periode 30 detik mana pun. Selain itu, refund dari developer yang dilakukan tanpa opsi pencabutan sama sekali tidak dikembalikan. Server yang mati selama lima pekan kehilangan refund yang tidak akan pernah bisa ditarik kembali.

Refund mana yang masih melibatkan developer
Memindahkan pelacakan refund ke server tidak memberi Anda kendali lebih atas refund. Hampir setiap refund Google Play diputuskan tanpa Anda: refund mandiri, refund lewat dukungan, pembatalan, dan refund otomatis untuk pembelian yang belum di-acknowledge. Anda baru mengetahuinya setelah terjadi, lewat notifikasi pembelian yang dibatalkan.
Pengecualiannya adalah tinjauan chargeback. Saat pembeli mengajukan chargeback yang memerlukan masukan Anda, Google mengirim PendingRefundReviewNotification. Google menyatakan Anda sebaiknya menjawab dengan saran refund dan bukti penggunaan dalam 24 jam dengan memanggil orders.reviewrefund. Bukti itu berasal dari catatan server yang sama yang kini wajib Anda simpan karena library baru. Tim yang menyimpan ledger untuk pemulihan sudah punya apa yang dibutuhkan untuk menjawab.
Berapa biaya migrasi yang lambat
Risiko langsungnya adalah aturan tiga hari. Google Play me-refund pembelian secara otomatis dan mencabut hak akses jika aplikasi Anda tidak melakukan acknowledge dalam tiga hari. Untuk pembelian tertunda, hitungan dimulai saat pembelian berpindah dari PENDING ke PURCHASED. Migrasi yang merusak logika koneksi, listener queryProductDetailsAsync() yang baru, atau penyiapan pembelian tertunda bisa menghentikan acknowledge tanpa menghentikan penjualan. Setiap pesanan di celah itu di-refund penuh, dan pengguna sudah mendapatkan apa yang mereka bayar.
Di situlah kerugiannya. Paket kredit gambar yang di-refund sudah menghabiskan waktu GPU di balik setiap hasil generate. Paket AI yang di-refund sudah menjalankan panggilan API berbayar. Tingkat penyimpanan yang di-refund sudah mengisi disk yang Anda bayar. Tip yang di-refund sudah terkirim dalam pembayaran ke kreator. Refund mengembalikan pendapatan ke pembeli dan meninggalkan tagihan itu pada Anda.
Chargeback juga makin mahal. Pusat bantuan Google menyatakan bahwa untuk pesanan yang dibuat setelah 3 Agustus 2026, developer menanggung harga pembelian, dikurangi biaya layanan Play, ditambah biaya chargeback dari bank. Google hanya terus membayar biaya layanannya sendiri. Aplikasi yang tidak bisa menjawab tinjauan chargeback dalam 24 jam dengan data penggunaan nyata membayar seluruh tagihan itu setiap kali.
Daftar periksa migrasi yang melindungi pendapatan
- Naikkan dependensi ke Play Billing Library 8 atau 9 dan hapus
queryPurchaseHistory(),querySkuDetailsAsync(), sertaenablePendingPurchases()tanpa argumen. - Perbarui listener
queryProductDetailsAsync()Anda. Sejak versi 8, listener ini juga mengembalikan produk yang gagal diambil, beserta kode status. - Aktifkan
enableAutoServiceReconnection()agar koneksi billing yang terputus tidak menghambat pemrosesan pembelian. - Panggil
queryPurchasesAsync()dionResume()agar pembelian yang selesai saat aplikasi tertutup tetap di-acknowledge dalam tiga hari. - Catat setiap token pembelian, ID pesanan, dan konsumsi di server Anda, terhubung ke ID akun Anda sendiri.
- Berlangganan real-time developer notifications dan tangani
VoidedPurchaseNotificationmaupunPendingRefundReviewNotification. - Jalankan sinkronisasi harian Voided Purchases API sebagai jaring pengaman, jauh di dalam jendela 30 hari dan kuota harian 6,000 kueri.
RefundHalt memantau notifikasi pembelian yang dibatalkan dan tinjauan chargeback dari Google Play, menjawab setiap tinjauan melalui orders.reviewrefund dalam jendela 24 jam dengan data penggunaan nyata Anda, dan menyimpan riwayat refund yang tidak bisa lagi diminta aplikasi Anda dari perangkat.
Pertanyaan yang sering diajukan
- Apakah saya harus memakai Play Billing Library 8 sekarang?
- Ya, untuk setiap aplikasi baru atau update yang berjualan lewat Google Play billing. Tabel penghentian Google menetapkan 31 Agustus 2026 sebagai tenggat versi 7, dan perpanjangan berakhir pada 1 November 2026. Anda bisa memakai versi 8 atau versi 9 yang lebih baru.
- Apakah aplikasi saya yang sudah ada akan berhenti berfungsi jika masih memakai Play Billing Library 7?
- Tidak. Google menyatakan aplikasi yang sudah ada tetap berjalan dan APK yang tidak dipelihara tidak perlu diperbarui. Penghentian ini hanya memblokir Anda menerbitkan aplikasi baru atau update yang memakai versi yang tidak didukung.
- Apa pengganti queryPurchaseHistoryAsync di Play Billing Library 8?
- Tidak ada yang melakukan tugas yang sama di perangkat. Google menyarankan memakai queryPurchasesAsync() untuk pembelian aktif dan tertunda, melacak pembelian yang sudah dikonsumsi di server Anda sendiri, dan memakai Voided Purchases API untuk pembelian yang dibatalkan atau di-refund.
- Seberapa jauh ke belakang Voided Purchases API Google Play menjangkau?
- 30 hari. Google menyatakan API ini hanya bisa menampilkan pembelian yang dibatalkan dalam 30 hari terakhir, dan membatasi setiap aplikasi hingga 6,000 kueri per hari serta 30 kueri dalam periode 30 detik mana pun.
- Apakah Google Play me-refund pembelian jika aplikasi saya tidak melakukan acknowledge?
- Ya. Jika pembelian tidak di-acknowledge dalam tiga hari, pengguna otomatis menerima refund dan Google Play mencabut pembelian tersebut. Untuk pembelian tertunda, tiga hari itu dimulai saat status berubah dari PENDING ke PURCHASED.
Sumber dan bacaan lanjutan
- Android Developers: Play Billing Library deprecation FAQ
- Android Developers: Play Billing Library release notes
- Android Developers: Migrate to Play Billing Library 8
- Android Developers: Query purchase history alternatives
- Android Developers: Integrate the Google Play Billing Library into your app
- Android Developers: Real-time developer notifications reference
- Google Play Developer API: Voided Purchases API
- Play Console Help: Chargeback cost sharing for orders after August 3, 2026
RefundHalt
Autopilot refund untuk App Store dan Google Play
Baca selanjutnya
Brasil kini memeriksa game yang masih menjual loot box kepada anak, dan tagihannya jatuh pada refund loot box
Kementerian kehakiman Brasil meminta otoritas pelindungan data memantau enam game yang menjual loot box tanpa verifikasi usia. Berikut isi kewajiban hukumnya, apa yang sudah dituntut Apple dan Google, serta cara menghitung dan menangani refund loot box ketika kotaknya sudah dibuka.
Pembelian dalam aplikasi yang tidak disengaja adalah refund yang tidak bisa Anda menangkan, jadi solusinya ada di layar pembelian
Pembelian dalam aplikasi yang tidak disengaja kembali sebagai refund di kedua toko, dan tidak ada bukti penggunaan yang bisa membuktikan bahwa sebuah ketukan memang disengaja. Berikut cara Apple dan Google melabelinya, berapa biaya komputasi dan pembayaran yang Anda tanggung, serta desain layar pembelian yang mencegahnya sebelum tagihan terjadi.