Mengelola langganan dan pembelian satu kali

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:

  1. Layanan streaming FitnessGoals ingin menjalankan promosi untuk mendorong olahraga rutin pada bulan Februari.

  2. Mereka memutuskan untuk menawarkan layanan tambahan selama satu bulan kepada pelanggan yang berolahraga dengan FitnessGoals setidaknya 10 kali selama bulan Februari.

  3. 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.

  4. 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:

  1. 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.

  2. Football-Not-Soccer menggunakan orders.refund API 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:

  1. 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.

  2. Layanan pelanggan menemukan detail pembelian langganan Maria di sistem mereka dan memicu panggilan ke purchases.subscriptionsv2.revoke untuk meminta pengembalian dana penuh.

  3. 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:

  1. 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.

  2. Layanan pelanggan menemukan detail pembelian langganan Maria di sistem mereka dan memicu panggilan ke purchases.subscriptionsv2.revoke yang meminta pengembalian dana secara prorata.

  3. Layanan pelanggan memberi tahu Maria bahwa dia akan mendapatkan pengembalian dana sekitar 50% dari harga langganannya dan akses ke layanan tersebut akan segera dihentikan.