Menjual langganan

Topik ini menjelaskan cara menangani peristiwa siklus proses langganan, seperti perpanjangan dan berakhirnya masa berlaku. Topik ini juga menjelaskan fitur langganan lainnya, seperti menawarkan promosi dan memungkinkan pengguna mengelola langganan sendiri.

Jika Anda belum mengonfigurasi produk langganan untuk aplikasi, lihat Membuat dan mengonfigurasi produk.

Ringkasan langganan

Langganan memberikan serangkaian manfaat yang dapat diakses pengguna selama jangka waktu tertentu. Misalnya, langganan dapat memberikan hak kepada pengguna untuk mengakses layanan streaming musik.

Anda dapat memiliki beberapa langganan dalam satu aplikasi, baik untuk memberikan serangkaian manfaat yang berbeda, maupun tingkat yang berbeda dari serangkaian manfaat tunggal (misalnya, tingkat "Silver" dan "Gold").

Melalui paket dasar dan penawaran, Anda dapat membuat beberapa konfigurasi untuk produk langganan yang sama. Misalnya, Anda dapat membuat penawaran perkenalan untuk pengguna yang belum pernah berlangganan ke aplikasi Anda. Demikian pula, Anda dapat membuat penawaran upgrade untuk pengguna yang sudah berlangganan.

Untuk ringkasan mendetail tentang produk langganan, paket dasar, dan penawaran, lihat dokumentasi di Pusat Bantuan Konsol Play.

Integrasi paket prabayar

Paket prabayar tidak diperpanjang secara otomatis setelah masa berlakunya habis. Untuk memperpanjang hak langganan tanpa hambatan, pengguna harus menambah saldo paket prabayar untuk langganan yang sama.

Untuk menambah saldo, luncurkan alur penagihan seperti yang Anda lakukan dengan pembelian asli. Anda tidak perlu menunjukkan bahwa pembelian merupakan penambahan saldo.

Penambahan saldo paket prabayar selalu menggunakan mode penghitungan prorata IMMEDIATE_AND_CHARGE_FULL_PRICE, dan Anda tidak perlu menetapkan mode ini secara eksplisit. Pengguna akan langsung ditagih untuk periode penagihan penuh, dan hak mereka diperpanjang menurut durasi yang ditentukan dalam penambahan saldo.

Setelah menambah saldo, kolom berikut di objek hasil Purchase diupdate untuk menunjukkan pembelian penambahan saldo terbaru:

• Id pesanan
• Waktu pembelian
• Tanda tangan
• Token pembelian
• Dikonfirmasi

Kolom Purchase berikut selalu berisi data yang sama dengan yang ada dalam pembelian asli:

• Nama paket
• Status pembelian
• Produk
• Perpanjangan otomatis

Konfirmasi pembelian prabayar

Serupa dengan perpanjangan langganan secara otomatis, Anda harus mengonfirmasi paket prabayar setelah pembelian. Pembelian awal maupun penambahan saldo apa pun harus dikonfirmasi. Untuk mengetahui informasi selengkapnya, lihat Memproses pembelian.

Karena durasi paket prabayar cenderung pendek, penting untuk mengonfirmasi pembelian sesegera mungkin.

Paket prabayar dengan durasi satu minggu atau lebih harus dikonfirmasi dalam waktu tiga hari.

Paket prabayar dengan durasi kurang dari satu minggu harus dikonfirmasi dalam waktu setengah dari durasi paket. Misalnya, developer memiliki waktu 1,5 hari untuk mengonfirmasi paket prabayar tiga hari.

Menggunakan deep link untuk memungkinkan pengguna mengelola langganan

Sebagai developer, Anda harus memudahkan pelanggan untuk mengelola langganan mereka. Aplikasi harus menyertakan link di layar preferensi atau setelan yang memungkinkan pengguna untuk mengelola langganan. Contoh link ini ditunjukkan pada gambar 4.

Pada pengendali klik link ini, tambahkan logika untuk menentukan apakah pengguna memiliki langganan yang masih berlaku untuk aplikasi, yang mana expiryTime di masa mendatang atau autoRenewing ditetapkan ke true.

Setiap productId langganan cocok dengan ID produk yang Anda tetapkan saat membuatnya di Konsol Play. Untuk menentukan productId langganan yang sudah ada secara terprogram, buat kueri backend aplikasi Anda untuk daftar langganan yang terkait dengan pengguna tertentu.

Jika pengguna memiliki langganan yang masih berlaku, Anda dapat mengarahkan mereka ke URL yang mirip dengan URL berikut ini, dengan mengganti "your-sub-product-id" dan "your-app-package" dengan ID langganan dan info paket aplikasi:

https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package

Jika pengguna tidak memiliki langganan yang masih berlaku dalam aplikasi, gunakan URL berikut untuk mengarahkan mereka ke halaman yang menampilkan semua langganan mereka, seperti yang ditunjukkan pada gambar 5 dan 6:

https://play.google.com/store/account/subscriptions

Anda dapat menemukan kode contoh untuk logika link langganan di aplikasi contoh Classy Taxi.

Mengizinkan pengguna mengupgrade, mendowngrade, atau mengubah langganan

Anda dapat menawarkan berbagai tingkat langganan kepada pengguna, seperti paket dasar dan paket premium. Gambar 7 menampilkan layar yang menawarkan dua tingkat langganan:

Pengguna harus dapat mengakses layar yang serupa dengan gambar 7 untuk mengupgrade atau mendowngrade langganan. Saat mengupgrade atau mendowngrade langganan, Anda dapat menyetel mode penghitungan prorata yang menentukan cara perubahan memengaruhi pelanggan.

Tabel berikut mencantumkan mode penghitungan prorata yang tersedia:

Jika pengguna mengubah hak langganan, Anda harus menentukan tarif penghitungan prorata saat runtime. Untuk perubahan hak, Anda tidak dapat menentukan mode penghitungan prorata default melalui Konsol Google Play.

Jika pengguna tidak mengubah hak langganan, Anda dapat menggunakan mode penghitungan prorata default yang dikonfigurasi melalui Konsol Play. Anda juga dapat mengganti perilaku ini dengan menentukan mode penghitungan prorata dalam SubscriptionUpdateParams. Perhatikan pembatasan berikut:

• Saat mengupgrade, mendowngrade, atau melakukan pengalihan langganan yang sama ke paket prabayar dari paket prabayar atau paket perpanjangan otomatis, satu-satunya mode penghitungan prorata yang diizinkan adalah IMMEDIATE_AND_CHARGE_FULL_PRICE. Jika Anda menentukan mode penghitungan prorata lainnya, pembelian akan gagal dan error akan ditampilkan kepada pengguna.
• Saat beralih paket dalam langganan yang sama ke paket perpanjangan otomatisdari paket prabayar, mode penghitungan prorata yang valid adalah IMMEDIATE_AND_CHARGE_FULL_PRICE dan IMMEDIATE_WITHOUT_PRORATION. Jika Anda menentukan mode penghitungan prorata lainnya, pembelian akan gagal dan error akan ditampilkan kepada pengguna.

Contoh penghitungan prorata

Untuk memahami cara kerja setiap mode penghitungan prorata, perhatikan skenario berikut:

Sandra memiliki langganan konten online dari aplikasi Country Gardener. Saat ini, ia memiliki langganan bulanan di versi konten Tingkat 1 yang kontennya hanya berisi teks. Biaya langganan ini sebesar $2 per bulan dan diperpanjang pada tanggal 1 setiap bulan.

Pada tanggal 15 April, Sandra memilih untuk mengupgrade langganan ke versi tahunan Tingkat 2 yang berisi pembaruan video dan biayanya $36 per tahun.

Saat mengupgrade langganan, developer memilih mode penghitungan prorata. Daftar berikut ini menjelaskan pengaruh setiap mode penghitungan prorata terhadap langganan Sandra:

IMMEDIATE_WITH_TIME_PRORATION

Langganan Tingkat 1 milik Sandra akan langsung berakhir. Karena ia sudah membayar untuk sebulan penuh (1-30 April), tetapi diupgrade di pertengahan masa berlaku langganan, maka biaya langganan setengah bulan ($1) akan diterapkan ke langganan yang baru. Namun, karena langganan baru tersebut berbiaya $36 per tahun, saldo kredit $1 hanya mencakup 10 hari (16-25 April) sehingga pada tanggal 26 April, ia dikenai biaya $36 untuk langganan baru dan $36 lagi pada tanggal 26 April setiap tahun berikutnya.

IMMEDIATE_AND_CHARGE_PRORATED_PRICE

Mode ini dapat digunakan karena harga langganan Tingkat 2 per unit waktu ($36/tahun = $3/bulan) lebih besar daripada harga langganan Tingkat 1 per unit waktu ($2/bulan). Langganan Tingkat 1 milik Sandra akan langsung berakhir. Karena dia sudah membayar untuk sebulan penuh, tetapi hanya memakai separuhnya, biaya langganan setengah bulan ($1) akan diterapkan ke langganan yang baru. Namun, karena biaya langganan baru tersebut adalah $36/tahun, biaya langganan untuk 15 hari yang tersisa adalah $1,50 sehingga ia dikenai selisih biaya $0,50 untuk langganan barunya. Pada tanggal 1 Mei, dia dikenai biaya $36 untuk tingkat langganan barunya dan $36 lagi pada tanggal 1 Mei setiap tahun berikutnya.

IMMEDIATE_WITHOUT_PRORATION

Langganan Tingkat 1 milik Sandra akan langsung diupgrade ke Tingkat 2 tanpa biaya tambahan, serta pada tanggal 1 Mei dia dikenai biaya $36 untuk tingkat langganan barunya dan $36 lagi pada tanggal 1 Mei setiap tahun berikutnya.

DEFERRED

Langganan Tingkat 1 milik Sandra berlanjut hingga habis masa berlakunya, yaitu pada tanggal 30 April. Pada tanggal 1 Mei, langganan Tingkat 2 mulai berlaku, dan Sandra dikenai biaya $36 untuk tingkat langganan barunya.

IMMEDIATE_AND_CHARGE_FULL_PRICE

Langganan Tingkat 1 milik Sandra akan langsung berakhir. Langganan Tingkat 2-nya dimulai hari ini dan dia dikenai biaya $36. Karena ia sudah membayar untuk sebulan penuh, tetapi hanya memakai separuhnya, biaya langganan setengah bulan ($1) akan diterapkan ke langganan yang baru. Karena biaya langganan baru sebesar $36/tahun, ia akan mendapatkan 1/36 tahun ditambahkan ke periode langganannya (~10 hari). Oleh karena itu, tagihan Sandra yang berikutnya adalah 1 tahun 10 hari dari hari ini sebesar $36. Setelah itu, Sandra akan dikenai biaya $36 setiap tahun berikutnya.

Saat memilih mode penghitungan prorata, pastikan untuk meninjau rekomendasi penghitungan prorata kami.

Aplikasi Anda dapat menawarkan upgrade atau downgrade kepada pengguna menggunakan langkah yang sama seperti meluncurkan alur pembelian. Namun, saat melakukan upgrade atau downgrade, Anda harus memberikan detail untuk langganan saat ini, langganan berikutnya (setelah upgrade atau downgrade), dan mode penghitungan prorata yang digunakan, seperti yang ditunjukkan dalam contoh berikut:

String offerToken = productDetails
                        .getSubscriptionOfferDetails(selectedOfferIndex)
                        .getOfferToken();

BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(
        ImmuableList.of(
            ProductDetailsParams.newBuilder()
                // fetched via queryProductDetailsAsync
                .setProductDetails(productDetails)
                // offerToken can be found in
                // ProductDetails=>SubscriptionOfferDetails
                .setOfferToken(offerToken)
                .build()))
    .setSubscriptionUpdateParams(
        SubscriptionUpdateParams.newBuilder()
            // purchaseToken can be found in Purchase#getPurchaseToken
            .setOldSkuPurchaseToken("old_purchase_token")
            .setReplaceSkusProrationMode(ProrationMode.IMMEDIATE_AND_CHARGE_FULL_PRICE)
            .build())
    .build();

BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);

// process purchase results from PurchasesUpdatedListener registered with BillingClient
public void onPurchaseUpdated(BillingResult billingResult, @Nullable List<Purchase> purchases) {
  // check BillingResult
  // process returned Purchase list, e.g. grant entitlement
}

Untuk penggantian langsung pada mode penghitungan prorata, aplikasi menerima pembelian baru di PurchasesUpdatedListener. Pembelian juga tersedia di BillingClient.queryPurchasesAsync(). Saat Anda menerima token pembelian, ikuti proses verifikasi yang sama seperti saat memverifikasi token pembelian baru. Pastikan untuk mengonfirmasi pembelian ini dengan BillingClient.acknowledgePurchase() dari Library Layanan Penagihan Google Play atau Purchases.subscriptions:acknowledge dari Google Play Developer API.

Google Play Developer API akan menampilkan linkedPurchaseToken di resource langganan. Pastikan untuk membatalkan validasi token yang diberikan dalam linkedPurchaseToken guna memastikan bahwa token lama tidak digunakan untuk mendapatkan akses ke layanan Anda. Lihat Upgrade, downgrade, dan pendaftaran ulang untuk mendapatkan informasi tentang penanganan pembelian upgrade dan downgrade.

Untuk mode penggantian yang ditangguhkan, aplikasi menerima panggilan ke PurchasesUpdatedListener dengan pembelian paket langganan awal dan status apakah upgrade atau downgrade berhasil. Hingga penggantian mulai berlaku, BillingClient.queryPurchasesAsync() akan tetap menampilkan pembelian paket langganan awal. Setelah paket baru mulai berlaku, queryPurchasesAsync() akan menampilkan data pembelian langganan baru dan notifikasi SUBSCRIPTION_RENEWED akan dikirim ke server backend aman. Untuk penggantian yang ditangguhkan, sangat disarankan untuk memproses notifikasi ini dan mengonfirmasi pembelian menggunakan Purchases.subscriptions:acknowledge. linkedPurchaseToken dalam resource langganan dapat digunakan untuk menentukan pengguna mana di backend langganan yang harus diperbarui haknya dengan yang baru, jika berlaku. Aplikasi tidak boleh mengandalkan pengguna membuka aplikasi dan mengonfirmasi melalui BillingClient.acknowledgePurchase(), karena pengguna tersebut mungkin tidak membuka aplikasi selama tiga hari sejak perubahan paket diterapkan.

Mengupgrade dengan penawaran uji coba gratis atau harga perkenalan

Setelan kelayakan uji coba gratis berlaku jika pengguna melakukan upgrade atau downgrade. Anda dapat menyesuaikan setelan kelayakan uji coba gratis di Konsol Google Play.

Perhatikan hal berikut:

• Jika pengguna hanya dapat menerima satu uji coba gratis di semua langganan yang tersedia di aplikasi, paket yang dituju setelah perubahan tidak akan menyediakan uji coba gratis atau harga perkenalan.
• Jika Anda memberikan satu uji coba gratis per produk langganan, paket yang dituju mungkin menyediakan uji coba gratis atau harga perkenalan.

Tabel berikut menjelaskan perilaku setiap mode penghitungan prorata jika paket baru dan lama sama-sama menyediakan uji coba gratis, dan pengguna melakukan upgrade selama uji coba gratis:

Untuk memahami cara kerja transisi uji coba gratis dalam kasus default berupa satu uji coba gratis per aplikasi, perhatikan skenario berikut:

Maria memiliki langganan konten online dari aplikasi Country Gardener. Saat ini, ia memiliki langganan bulanan ke versi konten Tingkat 1 yang kontennya hanya berisi teks. Biaya langganan ini sebesar $10/bulan, dan dia berlangganan pada 1 April. Dia menikmati periode uji coba gratis 30 hari karena baru berlangganan untuk pertama kalinya, sehingga pembayaran pertamanya jatuh tempo pada tanggal 1 Mei.

Pada tanggal 15 April, Maria memilih untuk mengupgrade langganan ke Tingkat 2, yang berisi pembaruan video dan berbiaya $20/bulan. Langganan kedua ini juga memiliki periode uji coba selama 30 hari.

Daftar berikut ini menjelaskan cara transisi uji coba gratis untuk setiap mode penghitungan prorata:

• IMMEDIATE_WITH_TIME_PRORATION - Maria langsung diupgrade ke Tingkat 2. Karena Maria melakukan upgrade di pertengahan masa berlaku langganan, biaya langganan setengah bulan (15 hari senilai $10/bulan) diterapkan ke langganan barunya. Namun, karena langganan baru dikenai biaya $20/bulan, saldo 15 hari hanya cukup untuk membayar langganan untuk 7,5 hari. Maria tidak memenuhi syarat untuk menerima uji coba gratis lainnya ke Tingkat 2, sehingga mulai tanggal 22 April, dia dikenai biaya sebesar $20 setiap bulan.
• IMMEDIATE_AND_CHARGE_PRORATED_PRICE - Mode ini dapat digunakan karena harga langganan Tingkat 2 per unit waktu ($20/bulan) lebih besar daripada harga langganan Tingkat 1 per unit waktu ($10/bulan). Langganan Tingkat 1 milik Maria akan langsung diupgrade ke Tingkat 2, dan dia akan kehilangan uji coba gratisnya. Karena tanggal penagihan berikutnya untuk Maria adalah 1 Mei, ia dikenai biaya $10 hari ini untuk membayar paruh kedua di bulan April, lalu mulai 1 Mei, ia dikenai biaya $20 setiap bulan.
• IMMEDIATE_WITHOUT_PRORATION - Langganan Tingkat 1 milik Maria akan langsung diupgrade ke Tingkat 2. Maria tetap memiliki uji coba gratisnya hingga 30 April dan kini memiliki akses ke konten Tingkat 2. Mulai 1 Mei, ia dikenai biaya $20 setiap bulan.
• DEFERRED - Langganan Tingkat 1 milik Maria berlanjut hingga pembayaran berikutnya jatuh tempo pada 1 Mei. Pada 1 Mei, langganan Tingkat 2 mulai berlaku dan Maria dikenai biaya $20 pada tanggal 1 setiap bulan.
• IMMEDIATE_AND_CHARGE_FULL_PRICE - Langganan Tingkat 1 milik Maria akan langsung diupgrade ke Tingkat 2, dan dia akan kehilangan uji coba gratisnya. Ia dikenai biaya sebesar $20 hari ini. Karena Maria memiliki 15 hari lagi dalam uji coba gratisnya, tanggal penagihan berikutnya adalah 1 bulan + 15 hari dari sekarang, atau 1 Juli. Mulai 1 Juli, ia dikenai biaya $20 setiap bulan.

Daftar berikut ini menjelaskan perilaku transisi jika developer hanya mengizinkan satu uji coba gratis per langganan:

• IMMEDIATE_WITH_TIME_PRORATION - Maria langsung diupgrade ke Tingkat 2. Karena Maria melakukan upgrade di pertengahan masa berlaku langganan, maka biaya langganan setengah bulan (15 hari senilai $10/bulan) diterapkan ke langganan barunya. Namun, karena langganan baru dikenai biaya $20/bulan, saldo 15 hari hanya cukup untuk membayar langganan untuk 7,5 hari. Maria memenuhi syarat untuk menerima uji coba gratis lainnya ke Tingkat 2, sehingga ia tidak dikenai biaya untuk 37,5 hari berikutnya. Mulai 22 Mei, ia dikenai biaya $20 setiap bulan.
• IMMEDIATE_AND_CHARGE_PRORATED_PRICE - Mode ini dapat digunakan karena harga langganan Tingkat 2 per unit waktu ($20/bulan) lebih besar daripada harga langganan Tingkat 1 per unit waktu ($10/bulan). Langganan Tingkat 1 milik Maria akan langsung diupgrade ke Tingkat 2, dan dia akan kehilangan uji coba gratisnya. Karena tanggal penagihan berikutnya untuk Maria adalah 1 Mei, ia dikenai biaya $10 hari ini untuk membayar paruh kedua di bulan April, lalu mulai 1 Mei, ia dikenai biaya $20 setiap bulan.
• IMMEDIATE_WITHOUT_PRORATION - Langganan Tingkat 1 milik Maria akan langsung diupgrade ke Tingkat 2. Maria tetap memiliki uji coba gratisnya hingga 30 April dan kini memiliki akses ke Tingkat 2.
• DEFERRED - Langganan Tingkat 1 milik Maria berlanjut hingga pembayaran berikutnya jatuh tempo pada 1 Mei. Pada 1 Mei, langganan Tingkat 2 mulai berlaku dan Maria dikenai biaya $20 pada tanggal 1 setiap bulan.
• IMMEDIATE_AND_CHARGE_FULL_PRICE - Langganan Tingkat 1 milik Maria akan langsung diupgrade ke Tingkat 2, dan dia akan kehilangan uji coba gratisnya. Ia dikenai biaya sebesar $20 hari ini. Karena Maria memiliki 15 hari lagi dalam uji coba gratisnya, tanggal penagihan berikutnya adalah 1 bulan + 15 hari dari sekarang, atau 1 Juli. Mulai 1 Juli, ia dikenai biaya $20 setiap bulan.

Rekomendasi penghitungan prorata

Tabel berikut menunjukkan berbagai skenario penghitungan prorata serta rekomendasi kami untuk setiap skenario:

Pengelolaan pelanggan

Dengan menggunakan Notifikasi developer real time, Anda dapat mendeteksi secara real time saat pengguna memutuskan untuk melakukan pembatalan. Saat pengguna melakukan pembatalan sebelum masa berlaku langganannya berakhir, Anda dapat mengirimkan notifikasi push atau pesan dalam aplikasi untuk meminta mereka berlangganan lagi.

Setelah pengguna membatalkan langganannya, Anda dapat mencoba menarik kembali mereka, baik di aplikasi maupun melalui Play Store. Tabel berikut ini menjelaskan berbagai skenario langganan beserta tindakan menarik kembali pelanggan dan persyaratan aplikasi terkait.

Sebelum akhir masa berlaku langganan - dalam aplikasi

Untuk langganan yang telah dibatalkan tetapi masa berlakunya belum habis, Anda dapat mengizinkan pelanggan memulihkan langganan di aplikasi dengan menerapkan alur pembelian produk dalam aplikasi yang sama seperti alur untuk pelanggan baru. Pastikan UI menunjukkan bahwa pengguna sudah memiliki langganan. Misalnya, Anda mungkin ingin menampilkan tanggal habis masa berlaku saat ini dan harga berulang kepada pengguna dengan tombol Aktifkan kembali.

Biasanya, Anda mungkin menawarkan harga dan SKU yang sama dengan langganan saat ini, sebagai berikut:

• Memulai pembelian langganan baru dengan SKU yang sama.
• Langganan baru akan menggantikan langganan yang lama dan akan diperpanjang pada tanggal habis masa berlaku yang sama. Langganan lama akan langsung ditandai sebagai sudah tidak berlaku.
• Misalnya, Ardian memiliki langganan Aplikasi Musik Contoh dan langganan ini akan habis masa berlakunya pada 1 Agustus. Pada 10 Juli, ia berlangganan lagi selama satu bulan dengan harga yang sama setiap bulannya. Langganan baru akan dihitung secara prorata dengan sisa kredit, langsung diaktifkan, dan masih diperpanjang pada 1 Agustus.

Jika Anda ingin menawarkan harga yang berbeda, misalnya uji coba gratis baru atau diskon untuk menarik kembali pelanggan, Anda dapat menawarkan SKU yang berbeda kepada pengguna:

• Mulai upgrade atau downgrade dengan SKU yang berbeda menggunakan mode penghitungan prorata IMMEDIATE_WITHOUT_PRORATION.
• Langganan baru akan menggantikan langganan yang lama dan akan diperpanjang pada tanggal habis masa berlaku yang sama. Pengguna dikenai harga SKU baru, termasuk harga perkenalan, pada tanggal habis masa berlaku semula. Jika langganan lama dibuat menggunakan ID akun yang di-obfuscate, ID yang sama tersebut harus diteruskan ke BillingFlowParams untuk upgrade dan downgrade.
• Misalnya, Ardian memiliki langganan Aplikasi Musik Contoh dan langganan ini akan habis masa berlakunya pada 1 Agustus. Pada 10 Juli, ia berlangganan lagi ke langganan tahunan dengan harga perkenalan. Langganan baru akan segera aktif, dan pengguna akan dikenai harga perkenalan pada 1 Agustus.
• Jika Anda memutuskan untuk menyertakan uji coba gratis atau harga perkenalan dalam SKU penarikan kembali pelanggan, pastikan pengguna memenuhi syarat dengan menghapus centang pada kotak Izinkan satu uji coba gratis per aplikasi di Konsol Google Play, yang membatasi pengguna agar hanya menerima satu uji coba gratis per aplikasi.

Setelah menerima token pembelian, proses pembelian seperti yang biasa Anda lakukan pada langganan baru. Selain itu, Google Play Developer API akan menampilkan linkedPurchaseToken di resource langganan. Pastikan untuk membatalkan validasi token yang disediakan di linkedPurchaseToken guna memastikan bahwa token yang lama tidak digunakan untuk mendapatkan akses ke layanan Anda.

Sebelum akhir masa berlaku langganan - di Play Store

Saat langganan telah dibatalkan, tetapi masih aktif, pengguna dapat memulihkannya di pusat langganan Google Play dengan mengklik Berlangganan lagi (sebelumnya Pulihkan). Tindakan ini akan mempertahankan token langganan dan pembelian yang sama.

Untuk informasi selengkapnya tentang pemulihan langganan, lihat Pemulihan.

Setelah akhir masa berlaku langganan - dalam aplikasi

Anda dapat mengizinkan pelanggan yang sudah habis masa berlakunya untuk berlangganan lagi dalam aplikasi dengan menerapkan alur pembelian produk dalam aplikasi yang sama seperti untuk pelanggan baru. Perhatikan hal berikut:

• Untuk menawarkan diskon kepada pengguna, Anda dapat menawarkan ID produk dengan harga khusus untuk langganan Anda, yang juga disebut SKU penarikan kembali pelanggan. Anda dapat memberikan penawaran dalam aplikasi, atau memberi tahu pengguna tentang penawaran tersebut di luar aplikasi, seperti di email.
• Untuk mulai menarik kembali pelanggan, luncurkan alur pembelian di aplikasi Android Anda menggunakan Library Layanan Penagihan Google Play. Ini adalah proses yang sama dengan langganan baru, bedanya Anda dapat menentukan SKU yang tersedia untuk pengguna.
• Jika Anda memutuskan untuk menyertakan uji coba gratis atau harga perkenalan dalam SKU penarikan kembali pelanggan, pastikan pengguna memenuhi syarat dengan menghapus centang pada kotak Izinkan satu uji coba gratis per aplikasi di Konsol Google Play, yang membatasi pengguna agar hanya menerima satu uji coba gratis per aplikasi.
• Jika pengguna berlangganan lagi dengan SKU yang sama, mereka tidak lagi memenuhi syarat untuk uji coba gratis atau harga perkenalan. Pastikan UI menunjukkan hal tersebut.

Setelah menerima token pembelian, proses pembelian seperti yang biasa Anda lakukan pada langganan baru. Anda tidak akan menerima linkedPurchaseToken di resource langganan.

Setelah akhir masa berlaku langganan - di Play Store

Jika diaktifkan, pengguna dapat berlangganan kembali ke SKU yang sama hingga satu tahun setelah masa berlaku berakhir dengan mengklik Berlangganan lagi di pusat langganan Google Play. Tindakan ini akan menghasilkan token pembelian dan langganan baru.

Berlangganan lagi dianggap sebagai pembelian di luar aplikasi, jadi pastikan untuk mengikuti praktik terbaik dalam menangani pembelian yang dilakukan dari luar aplikasi.

Mempromosikan langganan

Anda dapat membuat kode promosi untuk memberikan uji coba gratis yang diperpanjang ke langganan yang sudah ada kepada pengguna terpilih. Untuk mempelajari lebih lanjut, lihat Kode promo.

Untuk uji coba gratis, Google Play memverifikasi bahwa pengguna memiliki metode pembayaran yang valid sebelum memulai uji coba gratis. Beberapa pengguna mungkin mengira verifikasi ini sebagai penangguhan atau penagihan pada metode pembayaran mereka. Penangguhan atau penagihan ini bersifat sementara dan akan dibatalkan atau dikembalikan dananya.

Setelah periode uji coba berakhir, metode pembayaran pengguna akan ditagih sebesar biaya langganan penuh.

Jika pengguna membatalkan langganan kapan saja selama periode uji coba gratis, langganan akan tetap aktif hingga periode uji coba berakhir dan pengguna tidak dikenai biaya saat periode uji coba gratis berakhir.

Membatalkan, mengembalikan dana, atau mencabut

Anda dapat menggunakan Google Play Developer API untuk membatalkan, mengembalikan dana, atau mencabut langganan. Fungsi ini juga tersedia di Konsol Google Play.

• Batal: Pengguna dapat membatalkan langganan di Google Play. Anda juga dapat memberikan opsi bagi pengguna untuk membatalkan langganan di aplikasi atau situs Anda. Aplikasi harus menangani pembatalan ini seperti yang dijelaskan dalam Pencabutan.
• Kembalikan dana: Saat Anda melakukan pengembalian dana, pengguna dapat tetap menggunakan langganan. Pengembalian dana dapat digunakan, misalnya, jika ada kesalahan teknis yang mengakibatkan pengguna tidak dapat mengakses produk Anda, tetapi kesalahan tersebut telah diperbaiki. Untuk mengembalikan dana yang lebih besar dari pembayaran terakhir atau melakukan pengembalian dana sebagian, Anda harus menggunakan Konsol Google Play.
• Cabut: Jika Anda mencabut langganan, pengguna akan langsung kehilangan akses ke langganan. Tindakan ini dapat digunakan, misalnya, jika terdapat kesalahan teknis yang mengakibatkan pengguna tidak dapat mengakses produk Anda dan pengguna tidak ingin melanjutkan penggunaan produk tersebut. Aplikasi harus menangani pembatalan ini seperti yang dijelaskan di Pencabutan.

Tabel berikut menjelaskan perbedaan antara pembatalan, pengembalian dana, dan pencabutan.

Menunda penagihan untuk pelanggan

Anda dapat memajukan tanggal penagihan berikutnya untuk pelanggan yang memperpanjang otomatis menggunakan Purchases.subscriptions:defer dari Google Play Developer API. Selama periode penundaan, pengguna berlangganan konten Anda dengan akses penuh tanpa dikenai biaya. Tanggal perpanjangan langganan akan diperbarui untuk menunjukkan tanggal yang baru.

Untuk paket prabayar, Anda dapat menggunakan defer billing API untuk menunda waktu habis masa berlaku.

Penagihan yang ditunda memungkinkan Anda melakukan hal berikut:

• Memberikan akses gratis kepada pengguna sebagai penawaran spesial, seperti memberikan satu minggu pembelian film secara gratis.
• Memberikan akses gratis kepada pelanggan sebagai bentuk kepedulian.

Penagihan dapat ditunda selama minimal satu hari dan maksimal satu tahun per panggilan API. Untuk menunda penagihan lebih lama lagi, Anda dapat memanggil ulang API sebelum tanggal penagihan baru tiba.

Misalnya, Dessy memiliki langganan bulanan konten online untuk aplikasi Fishing Quarterly. Ia biasanya ditagih £1,25 pada tanggal 1 setiap bulan. Pada bulan Maret, ia mengikuti survei online untuk penerbit aplikasi. Penerbit memberinya bonus enam minggu gratis dengan menunda pembayaran berikutnya hingga 15 Mei, yaitu enam minggu setelah tanggal penagihan terjadwal sebelumnya pada 1 April. Dessy tidak ditagih untuk bulan April atau awal Mei, dan masih dapat mengakses konten. Pada tanggal 15 Mei, ia ditagih dengan biaya langganan normal sebesar £1,25 untuk bulan tersebut. Tanggal perpanjangan langganan berikutnya adalah 15 Juni.

Saat menunda, Anda mungkin ingin memberi tahu pengguna melalui email atau dalam aplikasi untuk memberi tahu bahwa tanggal penagihan mereka telah berubah.

Menangani penolakan pembayaran

Jika ada masalah pembayaran pada akhir siklus penagihan, Google akan mencoba memperpanjang langganan secara berkala selama beberapa waktu sebelum membatalkan. Periode percobaan ulang ini dapat berlangsung hingga 30 hari ditambah jangka waktu masa tenggang yang ditentukan. Selama jangka waktu ini, Google juga akan mengirimkan email dan notifikasi kepada pengguna untuk meminta mereka memperbarui metode pembayaran.

Setelah pembayaran ditolak, langganan akan memasuki masa tenggang terlebih dahulu, jika diaktifkan. Selama masa tenggang, pengguna masih memiliki akses ke langganan.

Setelah masa tenggang berakhir, langganan memasuki penangguhan akun hingga 30 hari. Selama penangguhan akun, Anda dapat memblokir akses ke langganan.

Untuk memaksimalkan kemungkinan pemulihan langganan selama penolakan pembayaran, Anda dapat memberi tahu pengguna tentang masalah pembayaran dan meminta mereka untuk memperbaikinya.

Anda dapat melakukannya sendiri, seperti yang dijelaskan di bagian masa tenggang dan penangguhan akun, atau Anda dapat menerapkan in-app messaging API, tempat Google akan menampilkan pesan kepada pengguna di aplikasi Anda.

In-app messaging

Jika Anda telah mengaktifkan in-app messaging dengan InAppMessageCategoryId.TRANSACTIONAL, Google Play akan menampilkan pesan kepada pengguna selama masa tenggang dan penangguhan akun sekali per hari dan memberi mereka peluang untuk memperbaiki pembayaran tanpa keluar dari aplikasi.

Sebaiknya Anda memanggil API ini setiap kali pengguna membuka aplikasi untuk menentukan apakah pesan harus ditampilkan.

Jika pengguna berhasil memulihkan langganannya, Anda akan menerima kode respons SUBSCRIPTION_STATUS_UPDATED beserta token pembelian. Kemudian Anda harus menggunakan token pembelian ini untuk memanggil Google Play Developer API dan memperbarui status langganan di aplikasi Anda.

Mengintegrasikan in-app messaging

Untuk menampilkan in-app messaging kepada pengguna, gunakan BillingClient.showInAppMessages().

Berikut adalah contoh yang memicu alur in-app messaging:

val inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build()

billingClient.showInAppMessages(activity,
        inAppMessageParams,
        object : InAppMessageResponseListener() {
            override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) {
                if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // has been recovered from a suspend state. Developers should
                    // expect the purchase token to be returned with this response
                    // code and use the purchase token with the Google Play
                    // Developer API.
                }
            }
        })

InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build();

billingClient.showInAppMessages(activity,
        inAppMessageParams,
        new InAppMessageResponseListener() {
            @Override
            public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) {
                if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // has been recovered from a suspend state. Developers should
                    // expect the purchase token to be returned with this response
                    // code and use the purchase token with the Google Play
                    // Developer API.
                }
            }
        });