Notifikasi pembelian yang dibatalkan memungkinkan server Google Play Anda mencabut akses begitu refund masuk

Refund di Google Play tidak harus menjadi sesuatu yang baru Anda temukan belakangan di sebuah laporan. Google Play dapat mengirimkan notifikasi pembelian yang dibatalkan ke server Anda begitu sebuah pembelian dibatalkan, entah pembeli mengambil refund mandiri, agen dukungan memberikannya, bank memaksakan chargeback, atau Anda sendiri me-refund pesanan itu dengan flag revoke aktif. Pesannya kecil, menyebutkan pembelian yang persis, dan membawa satu instruksi, kembalikan entitlement itu, karena uangnya sudah hilang.

Apa sebenarnya notifikasi pembelian yang dibatalkan itu

Notifikasi pembelian yang dibatalkan adalah salah satu jenis Real-time Developer Notifications milik Google Play, atau RTDN. RTDN adalah kanal push. Google mempublikasikan sebuah pesan ke topik Cloud Pub/Sub yang Anda miliki, dan backend Anda menerimanya dalam sekejap setelah peristiwa itu, bukan mengetahuinya pada polling terjadwal berikutnya. Itulah inti dari notifikasi pembelian yang dibatalkan dibandingkan jalur pull yang lebih lama: Anda mengetahui refund saat terjadi, bukan berjam-jam kemudian.

Jalur pull tetap ada dan tetap penting. Voided Purchases API memungkinkan server Anda menanyakan, sesuai jadwal Anda sendiri, daftar pembelian yang dibatalkan dalam suatu rentang waktu. Keduanya saling melengkapi. Notifikasi memberi tahu Anda begitu satu pembelian berubah; API memungkinkan Anda merekonsiliasi secara massal dan mengisi kembali apa pun yang tertinggal akibat pesan yang terlewat.

Notifikasi ini menumpang di dalam sebuah Real-time Developer Notification

Notifikasi pembelian yang dibatalkan tidak pernah datang sendiri. Ia berada di dalam pembungkus DeveloperNotification, dan pembungkus itu dikirimkan sebagai satu string ber-encoding base64 di dalam field data pesan Pub/Sub. Handler Anda men-decode string itu menjadi JSON sebelum bisa membaca apa pun. Pembungkus itu selalu menyebutkan aplikasi dan waktu peristiwa, dan berisi persis satu objek notifikasi dari lima yang didefinisikan Google. Kelimanya saling eksklusif, jadi pesan yang membawa voidedPurchaseNotification tidak akan sekaligus membawa peristiwa langganan atau sekali beli.

Empat field yang dibawanya

Lepaskan pembungkusnya dan notifikasi pembelian yang dibatalkan itu sendiri hanya empat field. Itu memang sengaja dibuat ringkas. Posisi Google adalah jika yang Anda butuhkan hanyalah menemukan pembelian yang tepat dan menyesuaikan entitlement, keempat field ini sudah cukup, dan Anda tidak perlu memanggil kembali API apa pun untuk bertindak.

productType memberi tahu Anda apa yang dibatalkan

productType adalah bilangan bulat kecil, dan ia menentukan jalur revoke mana yang Anda tempuh. Pembatalan langganan harus mengurai akses yang sedang berjalan; pembatalan pembelian sekali beli cukup menghapus satu entitlement.

refundType memberi tahu Anda seberapa banyak yang dikembalikan

refundType memisahkan pembalikan penuh yang bersih dari yang parsial. Kasus parsial itu sempit. Ia hanya muncul saat sebuah pembelian sekali beli multi-kuantitas di-refund sebagian, bukan seluruh kuantitasnya.

Nyalakan dulu, atau ia tidak akan pernah datang

Notifikasi pembelian yang dibatalkan tidak mengalir secara default. Anda mengaktifkan RTDN sekali, di Play Console, dan mengarahkannya ke topik Pub/Sub yang Anda kendalikan. Sakelarnya ada di bawah Monetize, lalu Monetization setup, di bagian Real-time developer notifications di bagian atas halaman. Centang Enable real-time notifications, lalu tempel nama topik lengkap Anda dalam format projects/{project_id}/topics/{topic_name}, dan gunakan Send Test Message untuk memastikan salurannya berfungsi sebelum Anda memercayainya.

Toggle konten adalah tempat orang melewatkan pembelian yang dibatalkan. Kedua pilihan menyertakannya, jadi Anda tidak bisa secara tidak sengaja menolak refund sambil tetap menerima langganan.

• Terima notifikasi untuk langganan dan semua pembelian yang dibatalkan. Anda menerima peristiwa langganan dan setiap pembelian yang dibatalkan, tetapi bukan peristiwa pembelian produk sekali beli.
• Terima semua notifikasi untuk langganan dan produk sekali beli. Anda menerima yang di atas ditambah peristiwa produk sekali beli seperti ONE_TIME_PRODUCT_PURCHASED dan ONE_TIME_PRODUCT_CANCELED.

Berapa biayanya bagi Anda, dalam uang

Pembatalan adalah kerugian yang sudah tercatat pada saat notifikasi sampai ke Anda. Harga jualnya hilang, begitu pula apa pun yang Anda keluarkan untuk melayani pelanggan itu. Jika mereka menghasilkan gambar, menjalankan panggilan ke model Anda, menarik penyimpanan, atau memicu pembayaran ke pihak ketiga, biaya-biaya itu dibayar dengan uang sungguhan dan tidak kembali bersama refund. Notifikasi tidak bisa memulihkan itu semua. Yang bisa dilakukannya adalah menghentikan pendarahan mulai dari sini, dan itulah seluruh alasan untuk bertindak cepat atasnya.

Pendarahan paling parah pada langganan dan paling parah pada chargeback. Langganan yang gagal Anda cabut terus menimbulkan biaya untuk dilayani, bulan demi bulan, bagi pelanggan yang sudah tidak membayar. Dan chargeback adalah jenis pembatalan yang paling mahal. Mulai August 3, 2026, dokumentasi Google menyatakan bahwa chargeback membebankan harga pembelian ditambah biaya bank kepada developer. Notifikasi pembelian yang dibatalkan kerap menjadi tempat pertama sistem Anda sendiri mengetahui bahwa sebuah chargeback telah selesai, jadi handler yang mencabut akses seketika itulah yang mencegah penjualan yang hilang berubah menjadi penjualan yang hilang ditambah berminggu-minggu layanan gratis.

Cara menangani notifikasi pembelian yang dibatalkan, langkah demi langkah

Verifikasi dan hilangkan duplikat pesan

• Pastikan pesan Pub/Sub berasal dari Google dan menargetkan topik yang Anda konfigurasi, lalu decode field data base64 untuk mendapatkan JSON DeveloperNotification.
• Gunakan messageId Pub/Sub untuk membuang duplikat. Google memperingatkan bahwa notifikasi yang sama bisa dikirim lebih dari sekali, jadi perlakukan pengulangan sebagai hal normal dan buat handler Anda idempoten.
• Konfirmasikan (acknowledge) pesan hanya setelah Anda mencatatnya dengan aman, agar crash di tengah handler tidak menghilangkan peristiwa itu.

Cari pembeliannya

• Cocokkan purchaseToken dengan pembelian yang Anda simpan saat pertama kali memberikan entitlement. Gunakan orderId sebagai cadangan untuk pencarian dukungan dan rekonsiliasi manual.
• Baca productType untuk memilih jalur revoke langganan atau sekali beli, dan baca refundType untuk memutuskan antara revoke penuh dan parsial.

Cabut dan catat

• Hapus entitlement itu. Untuk refund penuh, putus akses ke item tersebut. Untuk refund parsial berbasis kuantitas, kurangi kuantitas yang diberikan sebesar jumlah yang di-refund dan biarkan sisanya utuh.
• Catat apa yang Anda lakukan dan kapan, dengan kunci purchaseToken dan orderId. Catatan itulah yang memungkinkan Anda menjawab tiket dukungan di kemudian hari, dan yang memungkinkan Voided Purchases API merekonsiliasi dengan rapi terhadap keadaan Anda sendiri.

Di mana posisinya di antara sinyal refund lainnya

Notifikasi pembelian yang dibatalkan adalah sebuah pemberitahuan, bukan negosiasi. Ia memberi tahu Anda hasil yang sudah diputuskan. Ada baiknya melihatnya berdampingan dengan sinyal-sinyal yang mudah membuatnya tertukar, karena hanya sebagian dari sinyal itu yang pernah meminta versi cerita Anda.

Kalimat yang perlu dipegang itu sederhana. Di kedua toko itu, ada persis dua alur refund di mana developer diberi kesempatan bicara, CONSUMPTION_REQUEST milik Apple dan tinjauan chargeback Google Play. Notifikasi pembelian yang dibatalkan bukan salah satunya. Pada saat ia sampai ke Anda, keputusan sudah di belakang Anda dan satu-satunya hal yang tersisa di tangan Anda adalah seberapa cepat Anda mencabut akses.