Semua artikel
Ulasan mendalamWaktu baca 7 menit

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.

Meja seorang developer Android di bawah cahaya pagi dengan laptop, ponsel, dan kalender dinding yang salah satu tanggalnya dilingkari, pada pekan ketika Play Billing Library 8 menjadi versi minimum untuk update Google Play

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 libraryTenggat aplikasi baru dan updateTenggat perpanjangan
631 Agustus 20251 November 2025
731 Agustus 20261 November 2026
831 Agustus 20271 November 2027
931 Agustus 20281 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 GoogleTempat berjalannya
Pembelian aktif dan tertundaqueryPurchasesAsync()Di perangkat
Pembelian sekali bayar yang sudah dikonsumsiCatatan Anda sendiriServer Anda
Pembelian yang di-refund, dibatalkan, atau terkena chargebackVoided Purchases APIServer Anda
Riwayat pembelian lengkap penggunaCatatan Anda sendiriServer 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.

Seorang engineer memegang tablet di lorong server yang tenang, tempat pembelian Google Play yang di-refund dan sudah dikonsumsi kini harus dicatat setelah Play Billing Library 8 menghapus riwayat pembelian di sisi klien

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(), serta enablePendingPurchases() 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() di onResume() 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 VoidedPurchaseNotification maupun PendingRefundReviewNotification.
  • 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

RefundHalt

Autopilot refund untuk App Store dan Google Play

Baca selanjutnya

Permintaan refund berikutnya sudah menuju kepada Anda.

Siapkan RefundHalt dalam waktu yang dibutuhkan untuk membaca satu lagi email dukungan tentang refund yang tidak sempat Anda sengketakan.