Anda mungkin perlu melakukan tindakan pengelolaan pada langganan atau pembelian satu kali sebagai bagian dari bisnis sehari-hari. Misalnya, layanan pelanggan Anda mungkin perlu memberikan pengembalian dana total atau sebagian untuk pengguna, atau Anda mungkin perlu mencabut hak dalam kasus tertentu. Anda dapat mengelola pesanan dari Konsol Play, atau jika ingin mengelolanya dari sistem Anda sendiri, Anda dapat melakukannya menggunakan Google Play Developer API.
Membatalkan langganan
Pembatalan langganan dapat dilakukan oleh pengguna atau developer.
Pembatalan yang dimulai pengguna
Pengguna dapat membatalkan langganan Google Play kapan saja menggunakan Google Play Store. Jika berlaku, Anda juga harus memberikan opsi bagi pengguna untuk membatalkan langganan mereka di aplikasi dan situs Anda.
Cara termudah untuk memungkinkan pengguna membatalkan secara sukarela adalah dengan menyediakan deep link di aplikasi Anda ke Google Play Store, tempat mereka dapat melihat dan mengelola langganan.
Pembatalan yang dilakukan oleh developer
Sebagai developer, Anda mungkin juga perlu memicu pembatalan dari backend.
purchases.subscriptions.cancel
API memungkinkan Anda membatalkan pembelian langganan.
Misalnya, Anda dapat menggunakan metode ini untuk menonaktifkan layanan lama.
Membatalkan langganan tidak akan memberikan pengembalian dana, dan pengguna akan tetap memiliki akses
hingga akhir periode penagihan saat ini.
Metode ini memungkinkan Anda menentukan jenis pembatalan berikut dalam
parameter isi permintaan cancellationType:
USER_REQUESTED_STOP_RENEWALS: Membatalkan langganan seolah-olah pengguna telah membatalkan dari Google Play Store. Setiap pembayaran cicilan akan berlanjut selama sisa periode komitmen saat ini. Dari Google Play Store, pengguna dapat memulihkan langganan sebelum habis masa berlakunya, atau berlangganan kembali setelah habis masa berlakunya jika diaktifkan untuk paket dasar.
DEVELOPER_REQUESTED_STOP_PAYMENTS: Membatalkan langganan dan mencegah pembayaran lebih lanjut. Pengguna tidak dapat memulihkan atau berlangganan lagi ke langganan dari Google Play Store, tetapi Anda dapat mengizinkan mereka berlangganan lagi dalam aplikasi Anda.
Memungkinkan pengguna memulihkan langganan yang belum habis masa berlakunya
Dalam beberapa skenario, Anda mungkin merasa perlu mengizinkan pengguna memulihkan langganan yang belum habis masa berlakunya dari pusat langganan Play setelah Anda memicu pembatalan sebagai developer. Misalnya, Anda mungkin ingin menyediakan alur pembatalan dalam aplikasi yang disesuaikan. Berdasarkan logika bisnis, Anda dapat memutuskan pembatalan mana yang dipicu dari backend yang dapat dipulihkan oleh pengguna.
Untuk menunjukkan bahwa pengguna dapat memulihkan pembatalan, kirim permintaan POST
ke API purchases.subscriptions.cancel, dan tetapkan parameter permintaan
cancellationType ke nilai USER_REQUESTED_STOP_RENEWALS.
Contoh:
- Token pembelian langganan
1a2b3c4d5e6f7g8h9i0j - Nama paket aplikasi
com.your.app - ID Langganan
your-subscription-product
Permintaan POST HTTP:
https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptions/your-subscription-product/tokens/1a2b3c4d5e6f7g8h9i0j:cancel
Isi permintaan:
{
"cancellationType": "USER_REQUESTED_STOP_RENEWALS"
}
Memungkinkan pengguna berlangganan lagi ke langganan yang sudah habis masa berlakunya
Untuk mengizinkan berlangganan kembali langganan yang sudah habis masa berlakunya, Anda harus mengaktifkan
opsi Berlangganan lagi
di paket dasar langganan, lalu membatalkan langganan dengan menetapkan
parameter cancellationType ke nilai USER_REQUESTED_STOP_RENEWALS.
Memungkinkan pengguna berlangganan kembali hanya di aplikasi Anda
Jika Anda telah menetapkan parameter cancellationType ke
DEVELOPER_REQUESTED_STOP_PAYMENTS atau belum menetapkan parameter
cancellationType, pengguna tidak dapat
memulihkan langganan mereka dari pusat langganan Google Play. Namun, pengguna dapat
mendaftar lagi untuk langganan melalui aplikasi Anda jika diperlukan.
Tindakan ini akan memicu Notifikasi developer real-time
SUBSCRIPTION_CANCELED. Tangani pembatalan ini seperti yang dijelaskan di
Pembatalan.
Menangguhkan penagihan
Anda dapat memperpanjang periode hak untuk langganan dengan
menggunakan metode subscriptionsv2.defer. Saat Anda menunda langganan dengan add-on, semua item dalam
langganan akan ditunda dengan durasi yang sama. Selama periode penundaan, pengguna tetap berlangganan konten Anda, tetapi tidak dikenai biaya untuk waktu tambahan. Saat Anda menunda penagihan untuk langganan, informasi status akan diperbarui dan Anda akan melihatnya tercermin di kolom expiryTime dalam
informasi status pembelian:
- Untuk langganan berulang yang aktif, penagihan yang ditangguhkan akan memperpanjang tanggal perpanjangan berikutnya.
- Untuk paket prabayar, penundaan penagihan akan memperpanjang waktu habis masa berlaku.
Beberapa contoh cara menggunakan penagihan yang ditangguhkan adalah:
- Memberikan akses tanpa biaya kepada pengguna sebagai penawaran spesial, seperti memberikan satu minggu gratis kepada pelanggan lama karena telah mengisi survei masukan.
- Memberi pelanggan akses tanpa biaya sebagai tindakan layanan pelanggan, misalnya setelah pemadaman layanan yang berkepanjangan yang mungkin telah memengaruhi kemampuan mereka untuk menggunakan layanan Anda.
Penagihan dapat ditunda selama minimal satu hari dan maksimal satu tahun per panggilan API. Untuk menunda akhir hak lebih lama lagi, panggil API lagi sebelum tanggal habis masa berlaku yang baru tiba.
Tindakan ini akan memicu Notifikasi developer real-time
SUBSCRIPTION_DEFERRED. Lihat Menunda penagihan untuk pelanggan di Tentang langganan untuk mempelajari cara menangani peristiwa ini.
Contoh:
Layanan streaming FitnessGoals ingin menjalankan promosi untuk mendorong olahraga rutin pada bulan Februari.
Mereka memutuskan untuk menawarkan layanan tambahan selama satu bulan kepada pelanggan yang berolahraga dengan FitnessGoals setidaknya 10 kali selama bulan Februari.
Mereka melacak hasil tantangan, dan pada 1 Maret, mereka memanggil metode subscriptionsv2.defer untuk setiap pembelian langganan aktif milik pengguna yang memenuhi tantangan pada bulan Februari.
Pengguna ini mendapatkan manfaat tambahan berupa video latihan rutin selama sebulan penuh tanpa biaya, dan pengguna tersebut memberi tahu semua teman mereka tentang cara FitnessGoals membantu mereka tetap sehat.
Melakukan pengembalian dana dan pencabutan
Ada banyak situasi saat Anda mungkin ingin memberikan pengembalian dana atau mencabut akses ke langganan atau pembelian satu kali.
Mengembalikan dana penuh untuk pesanan berdasarkan ID pesanan
Dengan orders.refund
API, Anda dapat melakukan pengembalian dana penuh untuk pesanan apa pun dalam waktu tiga tahun setelah pembelian.
Metode orders.refund menerima parameter pencabutan yang menunjukkan apakah
akses harus dicabut atau tidak, selain memberikan pengembalian dana.
Jika Anda mengeluarkan pencabutan dengan panggilan pengembalian dana untuk pembelian langganan, langganan akan segera dihentikan dan akan memicu
Notifikasi Developer Real Time SUBSCRIPTION_REVOKED dan
VoidedPurchaseNotification (dicatat dalam Voided Purchases API). Baca
bagian Pencabutan dalam panduan pengelolaan siklus proses langganan untuk mempelajari
cara menangani peristiwa ini.
Contoh:
Untuk merayakan dimulainya piala dunia baru, aplikasi e-sports Football-Not-Soccer memutuskan untuk mengundi jersey virtual gratis bagi semua pengguna yang membeli kit tim baru dalam 24 jam pertama.
Football-Not-Soccer menggunakan
orders.refundAPI tanpa meneruskan parameter pencabutan untuk mengembalikan dana pembelian jersey kepada pemenang.
Mencabut dan mengembalikan dana langganan berdasarkan token pembelian
Untuk kasus penggunaan tertentu, Anda mungkin perlu mencabut akses ke langganan pengguna
dan memberikan pengembalian dana. Layanan Penagihan Play menawarkan metode pencabutan, termasuk pengembalian dana penuh dan pengembalian dana yang dihitung secara prorata melalui API subscriptionsv2.revoke. Dengan endpoint ini, Anda dapat menentukan revocationContext
untuk menentukan cara penghitungan pengembalian dana.
Melakukan tindakan ini akan memicu Notifikasi Developer Real Time SUBSCRIPTION_REVOKED
dan VoidedPurchaseNotification, serta dicatat dalam Voided
Purchases API. Aplikasi harus menangani pembatalan ini seperti yang dijelaskan dalam
Pencabutan.
Contoh:
- Pembelian dengan token pembelian
1a2b3c4d5e6f7g8h9i0j - Aplikasi dengan nama paket
com.your.app - Niat untuk memberikan pengembalian dana prorata
Permintaan POST HTTP:
https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptionsv2/tokens/1a2b3c4d5e6f7g8h9i0j:revoke
Isi permintaan:
{
"revocationContext": {
"proratedRefund": {}
}
}
Pengembalian dana penuh
Jika Anda perlu menghentikan langganan dan mengembalikan dana penuh untuk
periode penagihan saat ini, lakukan pengembalian dana penuh. Gunakan fungsi
purchases.subscriptionsv2.revoke,
dan tetapkan "fullRefund": {} sebagai jenis pengembalian dana.
Contoh:
Maria memiliki langganan 30 hari dengan perpanjangan otomatis untuk paket bulanan streaming SuperMovies. Maria mengalami beberapa masalah teknis yang membuatnya tidak dapat mengakses konten. Dia menghubungi layanan pelanggan pada hari ke-3 siklus penagihannya, dengan menyatakan bahwa dia tidak pernah mendapatkan akses ke langganan.
Layanan pelanggan menemukan detail pembelian langganan Maria di sistem mereka dan memicu panggilan ke
purchases.subscriptionsv2.revokeuntuk meminta pengembalian dana penuh.Layanan pelanggan memberi tahu Maria bahwa dia akan mendapatkan pengembalian dana 100% dari harga langganannya dan dia tidak lagi berlangganan paket tersebut.
Pengembalian dana prorata
Jika Anda perlu menghentikan langganan dan mengembalikan dana sebagian dari sisa
waktu hak, lakukan pengembalian dana yang diprorata. Gunakan fungsi
purchases.subscriptionsv2.revoke,
dan tetapkan "proratedRefund": {} sebagai jenis pengembalian dana.
Pengembalian dana yang diprorata didukung untuk langganan perpanjangan otomatis dan paket prabayar dengan durasi minimal satu minggu.
Contoh:
Maria memiliki langganan 30 hari dengan perpanjangan otomatis untuk paket bulanan streaming SuperMovies. Dia telah menggunakan layanan ini dengan senang hati selama beberapa waktu. Maria menghubungi layanan pelanggan pada hari ke-15 siklus penagihannya dan menyatakan bahwa dia pindah ke luar negeri dan tidak dapat menggunakan layanan lagi mulai hari berikutnya.
Layanan pelanggan menemukan detail pembelian langganan Maria di sistem mereka dan memicu panggilan ke
purchases.subscriptionsv2.revokeyang meminta pengembalian dana secara prorata.Layanan pelanggan memberi tahu Maria bahwa dia akan mendapatkan pengembalian dana sekitar 50% dari harga langganannya dan akses ke layanan tersebut akan segera dihentikan.