Refund add-on langganan Google Play bisa menyasar satu item, tetapi pelanggan Anda hanya bisa membatalkan seluruh paket

Jual satu langganan dasar dengan tiga add-on di Google Play, dan Anda bisa me-refund salah satu add-on tanpa membatalkan sisanya. Pelanggan Anda tidak bisa melakukan hal yang sama dari sisi mereka. Google hanya mengizinkan pengguna membatalkan seluruh paket, jadi alat yang presisi untuk refund add-on langganan Google Play ada di tangan Anda sebagai developer, dan hanya lewat API. Gunakan dengan tepat, dan Anda me-refund baris yang bermasalah saja. Salah memilih panggilan, dan Anda me-refund, atau mencabut, semuanya.

Bagaimana langganan dengan add-on disusun

Google mengumumkan checkout multi-produk untuk langganan di I/O 2025. Satu alur pembelian menjual langganan dasar plus add-on opsional, ditagih bersama dalam satu jadwal. Panduan developer Google menetapkan batas yang tegas:

• Hanya base plan yang diperpanjang otomatis yang bisa membawa add-on. Paket prabayar tidak bisa.
• Setiap item harus memakai periode penagihan berulang yang sama. Add-on bulanan pada langganan dasar tahunan tidak diizinkan.
• Satu pembelian memuat paling banyak 50 item, artinya satu langganan dasar dan hingga 49 add-on.
• Fitur ini tidak tersedia di Korea Selatan.

Semuanya berada di satu purchase token. Saat Anda memanggil purchases.subscriptionsv2.get, respons berisi daftar lineItems, satu entri per item. Setiap line item punya productId, expiryTime, dan latestSuccessfulOrderId sendiri. Field terakhir itulah yang membuat refund per item mungkin dilakukan: setiap item punya pesanan terbarunya sendiri.

Prorata dimulai sejak hari pertama

Saat pengguna menambahkan add-on di tengah siklus, Google langsung menagih jumlah prorata agar add-on diperpanjang pada tanggal yang sama dengan langganan dasar. Contoh dari Google sendiri adalah add-on bulanan $10 yang ditambahkan pada 15 Agustus setelah masa uji coba 7 hari, ditagih $2.90 untuk menutup sisa bulan Agustus. Jadi satu add-on bisa punya pesanan pertama yang pendek dengan nominal tidak lazim sebelum pesanan penuh pertamanya. Ingat hal ini saat Anda mencari pesanan mana yang akan terkena refund.

Pelanggan Anda hanya bisa membatalkan seluruh paket

Halaman bantuan konsumen Google menyatakannya dengan lugas. Pengguna hanya bisa membatalkan langganan dasar dan add-on secara bersamaan, dan saat ini mereka tidak bisa membatalkan add-on satu per satu dari Google Play. Fitur jeda juga tidak tersedia. Jika pengguna menolak kenaikan harga, Google membatalkan langganan dasar beserta semua add-on-nya.

Akibatnya, pelanggan yang ingin berhenti dari satu add-on hanya punya dua pilihan di Play Store: membatalkan semuanya, atau meminta uangnya kembali. Keduanya tidak menguntungkan Anda. Panduan Google menyebutkan bahwa aplikasi Anda bisa menawarkan penghapusan sebagai gantinya. Add-on yang dihapus akan kedaluwarsa di akhir periode penagihan saat ini, dan sisa paket tetap diperpanjang.

Perbandingan alat refund add-on langganan Google Play

Google memberi Anda lima cara untuk mengembalikan uang pada langganan dengan add-on. Kelimanya berbeda dalam hal apa yang di-refund dan apakah akses berakhir.

Google menambahkan satu peringatan keras dalam panduan add-on: jangan memanggil purchases.subscriptions.refund yang sudah usang pada langganan dengan add-on. Selain itu, orders.refund tidak bisa menyentuh pesanan yang lebih lama dari tiga tahun.

Cara kerja itemBasedRefund

Objek itemBasedRefund menerima satu field wajib, productId, yang menyebut item yang akan dicabut. Google menjelaskan dua kemungkinan hasil:

• Item lain masih aktif: hanya item yang disebut yang dicabut dan di-refund penuh, dan langganan tetap berjalan.
• Tidak ada item lain yang aktif: item dicabut, di-refund penuh, dan seluruh langganan dibatalkan.

Anda bisa menyebut satu item per permintaan. Untuk me-refund dua add-on, lakukan dua panggilan.

Kapan Google memblokir refund berbasis item

Google menolak itemBasedRefund dalam tiga kasus. Langganan berada dalam status pembayaran ditolak apa pun, termasuk masa tenggang dan penangguhan akun. Item yang Anda sebut tidak dimiliki atau sudah kedaluwarsa. Atau pembelian tersebut adalah langganan prabayar, di mana penghentian per item sama sekali tidak didukung.

Apa yang terjadi saat refund berdasarkan ID pesanan

Panduan Google mencatat bahwa flag revoke pada orders.refund hanya mengakhiri akses jika pesanan tersebut adalah pesanan terbaru pada langganan. Pada pesanan yang lebih lama, refund berhasil dan tidak ada yang dicabut. Play Console bekerja dengan cara yang sama: refund pesanan terbaru dan langganan dihapus, refund pesanan yang lebih lama dan langganan tetap aktif. Dengan add-on, ambil pesanan dari latestSuccessfulOrderId milik line item yang benar, atau Anda bisa me-refund tagihan yang berbeda dari yang Anda maksud.

Siapa yang memutuskan refund, dan kapan Anda diminta bukti

Sebagian besar refund pada langganan dengan add-on diputuskan tanpa melibatkan Anda, sama seperti langganan Play lainnya. Dalam 48 jam setelah pembelian, pengguna bisa mengajukan permintaan ke Google melalui Laporkan masalah, dan Google yang memutuskan. Setelah itu, Google mengarahkan mereka kepada Anda. Dan jika Anda tidak melakukan acknowledge atas pembelian langganan baru dalam tiga hari, Google otomatis me-refund pengguna dan mencabut pembelian tersebut.

Hanya satu alur yang meminta penjelasan dari sisi Anda. Saat pemegang kartu mengajukan chargeback dan Google menandainya untuk ditinjau developer, Anda menerima PendingRefundReviewNotification dan punya waktu 24 jam untuk memanggil orders.reviewrefund dengan preferensi refund dan bukti penggunaan. Chargeback sendiri diputuskan oleh bank, dan keputusan bank bersifat final.

Melacak refund add-on di server Anda

Referensi RTDN Google mencantumkan SUBSCRIPTION_ITEMS_CHANGED untuk perubahan pada item dalam paket langganan, dan SUBSCRIPTION_REVOKED untuk langganan yang dicabut sebelum waktu kedaluwarsanya. Panduan Google menyebutkan bahwa pencabutan melalui subscriptionsv2.revoke memicu notifikasi SUBSCRIPTION_REVOKED sekaligus VoidedPurchaseNotification, dan dicatat di Voided Purchases API.

Masalahnya ada pada subscriptionId. Google menyatakan field ini tidak disertakan dalam RTDN untuk langganan dengan add-on. Jadi jangan mengandalkan notifikasi untuk memberi tahu item mana yang berubah. Pada setiap notifikasi untuk sebuah paket:

• Panggil purchases.subscriptionsv2.get dengan purchaseToken.
• Baca setiap lineItem beserta expiryTime-nya. Google menyatakan Anda harus memperbarui expiryTime untuk semua item, bukan hanya item yang Anda perkirakan.
• Berikan atau cabut akses per productId, bukan per purchase token.
• Lakukan polling ke Voided Purchases API sebagai cadangan. API ini mencakup 30 hari terakhir.

Masa tenggang dan penangguhan akun berlaku untuk seluruh paket

Masalah pembayaran berdampak pada semua item sekaligus. Google memilih masa tenggang terpendek di antara item yang aktif dan menerapkannya pada seluruh perpanjangan. Selama masa tenggang, pengguna tetap memiliki semua item. Dalam penangguhan akun, akses ke semua item ditangguhkan. Jika pembayaran tidak pernah pulih, item yang pembayarannya ditolak akan kedaluwarsa dan item lainnya dilanjutkan untuk sisa periode penagihannya.

Berapa biaya setiap jalur refund bagi Anda

Add-on biasanya terkait dengan sesuatu yang Anda bayar. Penyimpanan cloud tambahan ditagih oleh penyedia penyimpanan Anda. Paket kredit AI ditagih dalam bentuk panggilan API model. Kursi tambahan berarti komputasi lebih banyak, dan tier kreator bisa memicu pembayaran ke kreator. Setiap biaya itu muncul saat pengguna memakai add-on, dan refund mengembalikan harganya tanpa mengembalikan satu pun biaya tersebut.

Me-refund terlalu banyak

Kesalahan yang mahal adalah memakai fullRefund atau proratedRefund saat keluhannya hanya soal satu add-on. Keduanya mencabut semua item, jadi Anda ikut mengembalikan harga langganan dasar dan kehilangan pelanggan yang sebenarnya ingin bertahan. itemBasedRefund hanya mengembalikan tagihan terbaru add-on tersebut. Saat itu diblokir, orders.refund pada pesanan terbaru item tersebut mengembalikan uang tanpa mengakhiri apa pun.

Refund sebagian dan biaya

Play Console memungkinkan Anda memberikan refund sebagian pada pesanan langganan, dan Google menyatakan persentase refund juga berlaku untuk payout dan biaya layanan Anda. Refund setengah pesanan, dan setengah biaya Google ikut kembali. Biaya Anda sendiri untuk menyediakan add-on itu tidak kembali.

Chargeback pada sebuah paket

Untuk pesanan yang dibuat setelah 3 Agustus 2026, Google memindahkan biaya chargeback ke developer. Saat chargeback berhasil, Anda membayar harga pembelian dikurangi biaya layanan Play, ditambah biaya yang dikenakan bank. Pesanan paket dengan beberapa add-on berarti nilai yang lebih besar untuk hilang. Log penggunaan per add-on, yang dikaitkan dengan ID akun yang disamarkan, adalah bukti yang Anda kirim dalam peninjauan 24 jam.

Checklist untuk refund add-on

• Sediakan cara di dalam aplikasi untuk menghapus satu add-on, karena Google Play tidak menyediakannya.
• Simpan productId, expiryTime, dan latestSuccessfulOrderId dari setiap lineItem pada setiap notifikasi.
• Gunakan itemBasedRefund sebagai pilihan utama saat masalahnya hanya pada satu add-on.
• Saat langganan berada dalam masa tenggang atau penangguhan akun, refund pesanan item tersebut dengan orders.refund sebagai gantinya.
• Jangan pernah memanggil purchases.subscriptions.refund yang sudah usang pada sebuah paket.
• Catat penggunaan add-on per akun agar peninjauan chargeback bisa dikirim dalam 24 jam.
• Laporkan tingkat refund per add-on, bukan hanya per langganan, agar satu add-on yang lemah tidak tersembunyi di balik angka base plan.