Mengintegrasikan Library Layanan Penagihan Google Play ke aplikasi Anda

Topik ini menjelaskan cara mengintegrasikan Library Layanan Penagihan Google Play ke aplikasi Anda untuk mulai menjual produk. Sebelum membaca topik ini, pastikan Anda telah menyiapkan konfigurasi Google Play terlebih dahulu dengan mengikuti langkah-langkah dalam Penyiapan.

Topik ini mencakup contoh kode yang didasarkan pada aplikasi contoh resmi di GitHub. Baca referensi tambahan untuk mengetahui daftar lengkap aplikasi contoh dan resource lainnya yang dapat digunakan saat mengintegrasikannya.

Umur pembelian

Berikut ini alur pembelian yang biasa untuk pembelian satu kali atau langganan.

• Menunjukkan kepada pengguna apa yang dapat mereka beli.
• Meluncurkan alur pembelian bagi pengguna untuk menerima pembelian.
• Memverifikasi pembelian di server Anda.
• Memberikan konten kepada pengguna, dan mengonfirmasi pengiriman konten. Anda juga dapat menandai item sebagai telah digunakan sehingga pengguna dapat membeli item itu lagi.

Langganan diperpanjang secara otomatis hingga dibatalkan. Langganan dapat melalui status berikut:

• Aktif: Pengguna memiliki reputasi baik dan memiliki akses ke langganan.
• Dibatalkan: Pengguna telah membatalkan namun masih memiliki akses hingga masa berlakunya berakhir.
• Dalam masa tenggang: Pengguna mengalami masalah pembayaran, tetapi masih dapat mengakses saat Google mencoba kembali metode pembayaran.
• Penangguhan: Pengguna mengalami masalah pembayaran, dan tidak lagi memiliki akses saat Google mencoba kembali metode pembayaran.
• Dijeda: Pengguna menjeda aksesnya, dan tidak memiliki akses hingga mereka melanjutkan.
• Berakhir: Pengguna telah membatalkan dan kehilangan akses ke langganan. Pengguna dianggap berhenti menggunakan aplikasi saat masa berlaku habis.

Token pembelian dan ID Pesanan

Google Play melacak produk dan transaksi menggunakan token pembelian dan ID Pesanan.

• Token pembelian adalah string yang menunjukkan hak pembeli atas suatu produk di Google Play. Ini menunjukkan bahwa pengguna Google diberi hak atas produk tertentu yang direpresentasikan oleh SKU. Anda dapat menggunakan token pembelian dengan Google Play Developer API.
• ID Pesanan adalah string yang merepresentasikan transaksi keuangan di Google Play. String ini disertakan dalam tanda terima yang dikirimkan kepada pembeli melalui email. Anda dapat menggunakan ID Pesanan untuk mengelola pengembalian dana dalam laporan penjualan dan pembayaran.

ID Pesanan dibuat setiap kali transaksi keuangan terjadi. Token pembelian hanya dihasilkan saat pengguna menyelesaikan alur pembelian.

• Untuk produk satu kali, setiap pembelian akan menghasilkan token pembelian baru. Sebagian besar pembelian juga menghasilkan ID Pesanan baru. Pengecualian untuk hal ini adalah saat pengguna tidak dikenakan biaya apa pun, seperti yang dijelaskan dalam Kode promo.
• Untuk langganan, pembelian awal menghasilkan token pembelian dan ID Pesanan. Untuk setiap periode penagihan berkelanjutan, token pembelian tidak berubah, dan ID Pesanan baru diterbitkan. Upgrade, downgrade, penggantian, dan pendaftaran ulang, semuanya membuat token pembelian dan ID Pesanan baru.

Untuk langganan, perhatikan berikut ini:

• Upgrade langganan, downgrade langganan, dan alur pembelian langganan lainnya menghasilkan token pembelian yang harus menggantikan token pembelian sebelumnya. Anda harus membatalkan token pembelian yang muncul di kolom linkedPurchaseToken pada Google Play Developer API. Untuk informasi selengkapnya, lihat Menerapkan linkedPurchaseToken dengan benar untuk mencegah langganan duplikat.
• Nomor pesanan untuk perpanjangan langganan berisi bilangan bulat tambahan yang menunjukkan kejadian perpanjangan tertentu. Misalnya, ID Pesanan langganan awal mungkin adalah GPA.1234-5678-9012-34567 dan ID Pesanan berikutnya adalah GPA.1234-5678-9012-34567..0 (perpanjangan pertama), GPA.1234-5678-9012-34567..1 (perpanjangan kedua), dan seterusnya.

Penanganan Error

Library Layanan Penagihan Google Play menampilkan error dalam bentuk BillingResult. BillingResult berisi BillingResponseCode, yang mengategorikan kemungkinan error terkait penagihan yang dapat dialami aplikasi Anda. Misalnya, jika Anda menerima kode error SERVICE_DISCONNECTED, aplikasi Anda harus menginisialisasi ulang koneksi dengan Google Play. Selain itu, BillingResult berisi pesan debug, yang berguna selama pengembangan untuk mendiagnosis error.

Menghubungkan ke Google Play

Langkah pertama untuk berintegrasi dengan sistem penagihan Google Play adalah menambahkan library ke aplikasi dan melakukan inisialisasi koneksi.

Menambahkan dependensi Library Layanan Penagihan Google Play

Tambahkan dependensi Library Layanan Penagihan Google Play ke file build.gradle aplikasi Anda seperti yang ditunjukkan:

dependencies {
    def billing_version = "4.0.0"

    implementation "com.android.billingclient:billing:$billing_version"
}

dependencies {
    val billing_version = "4.0.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

Jika Anda menggunakan Kotlin, modul KTX Library Layanan Penagihan Play berisi ekstensi Kotlin dan dukungan coroutine yang memungkinkan Anda menulis Kotlin idiomatis saat menggunakan Library Layanan Penagihan Google Play. Untuk menyertakan ekstensi ini dalam project Anda, tambahkan dependensi berikut ke file build.gradle aplikasi Anda seperti yang ditunjukkan:

dependencies {
    def billing_version = "4.0.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

dependencies {
    val billing_version = "4.0.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

Melakukan inisialisasi pada BillingClient

Setelah menambahkan dependensi pada Library Layanan Penagihan Google Play, Anda perlu melakukan inisialisasi instance BillingClient. BillingClient adalah antarmuka utama untuk komunikasi antara Library Layanan Penagihan Google Play dan bagian lain aplikasi Anda. BillingClient menyediakan metode praktis, baik sinkron maupun asinkron, untuk berbagai operasi penagihan umum. Sebaiknya Anda memiliki satu koneksi BillingClient aktif yang terbuka bersamaan untuk menghindari beberapa callback PurchasesUpdatedListener untuk satu peristiwa.

Untuk membuat BillingClient, gunakan newBuilder(). Untuk menerima update tentang pembelian, Anda juga harus menghubungi setListener(), dengan meneruskan referensi ke PurchasesUpdatedListener. Pemroses ini menerima update untuk semua pembelian di aplikasi Anda.

private val purchasesUpdatedListener =
   PurchasesUpdatedListener { billingResult, purchases ->
       // To be implemented in a later section.
   }

private var billingClient = BillingClient.newBuilder(activity)
   .setListener(purchasesUpdatedListener)
   .enablePendingPurchases()
   .build()

private PurchasesUpdatedListener purchasesUpdatedListener = new PurchasesUpdatedListener() {
    @Override
    public void onPurchasesUpdated(BillingResult billingResult, List<Purchase> purchases) {
        // To be implemented in a later section.
    }
};

private BillingClient billingClient = BillingClient.newBuilder(activity)
    .setListener(purchasesUpdatedListener)
    .enablePendingPurchases()
    .build();

Membuat koneksi ke Google Play.

Setelah membuat BillingClient, Anda harus membuat koneksi ke Google Play.

Agar terhubung ke Google Play, panggil startConnection(). Proses koneksi bersifat asinkron, dan Anda harus menerapkan BillingClientStateListener untuk menerima callback setelah penyiapan klien selesai dan siap untuk membuat permintaan lebih lanjut.

Anda juga harus mengimplementasikan logika mencoba ulang untuk menangani koneksi yang terputus ke Google Play. Untuk menerapkan logika mencoba ulang, ganti metode callback onBillingServiceDisconnected(), dan pastikan BillingClient memanggil metode startConnection() untuk terhubung kembali ke Google Play sebelum membuat permintaan lebih lanjut.

Contoh berikut menunjukkan cara memulai koneksi dan menguji apakah koneksi siap digunakan:

billingClient.startConnection(object : BillingClientStateListener {
    override fun onBillingSetupFinished(billingResult: BillingResult) {
        if (billingResult.responseCode ==  BillingResponseCode.OK) {
            // The BillingClient is ready. You can query purchases here.
        }
    }
    override fun onBillingServiceDisconnected() {
        // Try to restart the connection on the next request to
        // Google Play by calling the startConnection() method.
    }
})

billingClient.startConnection(new BillingClientStateListener() {
    @Override
    public void onBillingSetupFinished(BillingResult billingResult) {
        if (billingResult.getResponseCode() ==  BillingResponseCode.OK) {
            // The BillingClient is ready. You can query purchases here.
        }
    }
    @Override
    public void onBillingServiceDisconnected() {
        // Try to restart the connection on the next request to
        // Google Play by calling the startConnection() method.
    }
});

Menampilkan produk yang tersedia untuk dibeli

Setelah terhubung ke Google Play, Anda siap membuat kueri untuk produk yang tersedia dan menampilkannya kepada pengguna. Untuk meng-kueri Google Play agar mendapatkan detail produk dalam aplikasi, panggil querySkuDetailsAsync(). Kueri untuk detail SKU merupakan langkah penting sebelum menampilkan produk kepada pengguna, karena proses ini akan menampilkan informasi produk yang dilokalkan. Untuk langganan, pastikan tampilan produk Anda mengikuti semua kebijakan Play.

Saat memanggil querySkuDetailsAsync(), teruskan instance SkuDetailsParams yang menentukan daftar string ID produk yang dibuat di Konsol Google Play bersama dengan SkuType. SkuType dapat berupa SkuType.INAPP untuk produk sekali beli, atau SkuType.SUBS untuk langganan.

Untuk menangani hasil operasi asinkron, Anda juga harus menentukan pemroses yang menerapkan antarmuka SkuDetailsResponseListener. Anda kemudian dapat mengganti onSkuDetailsResponse(), yang memberi tahu pemroses ketika kueri selesai, seperti yang ditunjukkan dalam contoh berikut:

suspend fun querySkuDetails() {
    val skuList = ArrayList<String>()
    skuList.add("premium_upgrade")
    skuList.add("gas")
    val params = SkuDetailsParams.newBuilder()
    params.setSkusList(skuList).setType(SkuType.INAPP)

    // leverage querySkuDetails Kotlin extension function
    val skuDetailsResult = withContext(Dispatchers.IO) {
        billingClient.querySkuDetails(params.build())
    }

    // Process the result.
}

List<String> skuList = new ArrayList<> ();
skuList.add("premium_upgrade");
skuList.add("gas");
SkuDetailsParams.Builder params = SkuDetailsParams.newBuilder();
params.setSkusList(skuList).setType(SkuType.INAPP);
billingClient.querySkuDetailsAsync(params.build(),
    new SkuDetailsResponseListener() {
        @Override
        public void onSkuDetailsResponse(BillingResult billingResult,
                List<SkuDetails> skuDetailsList) {
            // Process the result.
        }
    });

Library Layanan Penagihan Google Play menyimpan hasil kueri dalam List objek SkuDetails. Anda kemudian dapat memanggil berbagai metode pada setiap objek SkuDetails dalam daftar untuk melihat informasi yang relevan tentang produk dalam aplikasi, seperti harga atau deskripsinya. Untuk melihat informasi detail produk yang tersedia, lihat daftar metode dalam class SkuDetails.

Sebelum menawarkan item untuk dijual, pastikan pengguna belum memiliki item tersebut. Jika pengguna memiliki item habis pakai yang masih ada dalam library item, mereka harus menggunakan item tersebut sebelum dapat membelinya lagi.

Sebelum menawarkan langganan, verifikasi bahwa pengguna belum berlangganan.

Meluncurkan alur pembelian

Untuk memulai permintaan pembelian dari aplikasi Anda, panggil metode launchBillingFlow() dari thread utama aplikasi Anda. Metode ini mengambil referensi ke objek BillingFlowParams yang berisi objek SkuDetails yang relevan dan diperoleh dari panggilan querySkuDetailsAsync(). Untuk membuat objek BillingFlowParams, gunakan class BillingFlowParams.Builder.

// An activity reference from which the billing flow will be launched.
val activity : Activity = ...;

// Retrieve a value for "skuDetails" by calling querySkuDetailsAsync().
val flowParams = BillingFlowParams.newBuilder()
        .setSkuDetails(skuDetails)
        .build()
val responseCode = billingClient.launchBillingFlow(activity, flowParams).responseCode

// An activity reference from which the billing flow will be launched.
Activity activity = ...;

// Retrieve a value for "skuDetails" by calling querySkuDetailsAsync().
BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
        .setSkuDetails(skuDetails)
        .build();
int responseCode = billingClient.launchBillingFlow(activity, billingFlowParams).getResponseCode();

// Handle the result.

Metode launchBillingFlow() menampilkan salah satu dari beberapa kode respons yang tercantum dalam BillingClient.BillingResponseCode . Pastikan Anda memeriksa hasil ini untuk memastikan tidak ada error saat meluncurkan alur pembelian. BillingResponseCode yang menyatakan OK menunjukkan peluncuran yang berhasil.

Jika panggilan ke launchBillingFlow() berhasil, sistem akan menampilkan layar pembelian Google Play. Gambar 1 menunjukkan layar pembelian untuk langganan:

Google Play memanggil onPurchasesUpdated() untuk mengirimkan hasil operasi pembelian ke pemroses yang mengimplementasikan antarmuka PurchasesUpdatedListener. Pemroses ditentukan menggunakan metode setListener() saat Anda menginisialisasi klien.

Anda harus menerapkan onPurchasesUpdated() untuk menangani kode respons yang mungkin diberikan. Contoh berikut menunjukkan cara mengganti onPurchasesUpdated():

override fun onPurchasesUpdated(billingResult: BillingResult, purchases: List<Purchase>?) {
   if (billingResult.responseCode == BillingResponseCode.OK && purchases != null) {
       for (purchase in purchases) {
           handlePurchase(purchase)
       }
   } else if (billingResult.responseCode == BillingResponseCode.USER_CANCELED) {
       // Handle an error caused by a user cancelling the purchase flow.
   } else {
       // Handle any other error codes.
   }
}

@Override
void onPurchasesUpdated(BillingResult billingResult, List<Purchase> purchases) {
    if (billingResult.getResponseCode() == BillingResponseCode.OK
        && purchases != null) {
        for (Purchase purchase : purchases) {
            handlePurchase(purchase);
        }
    } else if (billingResult.getResponseCode() == BillingResponseCode.USER_CANCELED) {
        // Handle an error caused by a user cancelling the purchase flow.
    } else {
        // Handle any other error codes.
    }
}

Pembelian yang berhasil akan memunculkan layar keberhasilan melakukan pembelian dari Google Play yang serupa dengan gambar 2.

Pembelian yang berhasil juga akan memunculkan token pembelian, yakni ID unik yang mewakili pengguna dan ID produk untuk produk dalam aplikasi yang mereka beli. Aplikasi Anda dapat menyimpan token pembelian secara lokal, meskipun sebaiknya Anda meneruskan token ke server backend yang aman, tempat Anda dapat memverifikasi pembelian dan melindungi dari penipuan. Proses ini dijelaskan lebih lanjut di bagian berikut.

Pengguna juga akan menerima tanda terima transaksi yang berisi ID pesanan atau ID unik transaksi melalui email. Pengguna menerima email yang berisi ID Pesanan unik untuk setiap pembelian produk sekali beli, juga untuk pembelian langganan awal dan perpanjangan otomatis berulang berikutnya. Anda dapat menggunakan ID Pesanan ini untuk mengelola pengembalian dana di Konsol Google Play.

Memproses pembelian

Setelah pengguna menyelesaikan pembelian, aplikasi Anda perlu memproses pembelian tersebut. Biasanya, aplikasi Anda akan diberi notifikasi tentang pembelian melalui PurchasesUpdatedListener. Namun, terkadang aplikasi Anda diberi tahu untuk memanggil BillingClient.queryPurchasesAsync() seperti yang dijelaskan dalam Mengambil pembelian.

Aplikasi Anda harus memproses pembelian dengan cara berikut:

1. Memverifikasi pembelian.
2. Memberikan konten kepada pengguna, dan mengonfirmasi pengiriman konten. Anda juga dapat menandai item sebagai telah digunakan sehingga pengguna dapat membeli item itu lagi.

Untuk memverifikasi pembelian, periksa terlebih dahulu apakah status pembelian adalah PURCHASED. Jika pembelian berstatus PENDING, Anda harus memproses pembelian seperti yang dijelaskan dalam Menangani transaksi yang tertunda. Untuk pembelian yang diterima dari onPurchasesUpdated() atau queryPurchasesAsync, Anda harus memverifikasi pembelian lebih lanjut untuk memastikan keabsahan sebelum aplikasi memberikan hak. Untuk mempelajari cara memverifikasi pembelian dengan benar, lihat Memverifikasi pembelian sebelum memberikan hak.

Setelah Anda memverifikasi pembelian, aplikasi Anda siap memberikan hak milik pengguna tersebut. Setelah memberikan hak, aplikasi Anda kemudian harus mengonfirmasi pembelian. Konfirmasi ini menyampaikan kepada Google Play bahwa Anda telah memberikan hak atas pembelian tersebut.

Proses untuk memberikan hak dan mengonfirmasi pembelian bergantung pada apakah pembelian tersebut untuk produk yang tidak habis pakai, habis pakai, atau langganan.

Untuk produk habis pakai, metode consumeAsync() memenuhi persyaratan konfirmasi dan menunjukkan bahwa aplikasi Anda telah memberikan hak kepada pengguna. Metode ini juga memungkinkan aplikasi Anda membuat produk satu kali tersedia untuk dibeli lagi.

Untuk menunjukkan bahwa produk satu kali telah digunakan, panggil consumeAsync() dan sertakan token pembelian yang harus disediakan Google Play untuk pembelian kembali. Anda juga harus meneruskan objek yang mengimplementasikan antarmuka ConsumeResponseListener. Objek ini menangani hasil operasi konsumsi. Anda dapat mengganti metode onConsumeResponse(), yang dipanggil oleh Library Layanan Penagihan Google Play saat operasi selesai.

Contoh berikut menggambarkan konsumsi produk menggunakan token pembelian yang terkait:

suspend fun handlePurchase(purchase: Purchase) {
    // Purchase retrieved from BillingClient#queryPurchasesAsync or your PurchasesUpdatedListener.
    val purchase : Purchase = ...;

    // Verify the purchase.
    // Ensure entitlement was not already granted for this purchaseToken.
    // Grant entitlement to the user.

    val consumeParams =
        ConsumeParams.newBuilder()
            .setPurchaseToken(purchase.getPurchaseToken())
            .build()
    val consumeResult = withContext(Dispatchers.IO) {
        client.consumePurchase(consumeParams)
    }
}

void handlePurchase(Purchase purchase) {
    // Purchase retrieved from BillingClient#queryPurchasesAsync or your PurchasesUpdatedListener.
    Purchase purchase = ...;

    // Verify the purchase.
    // Ensure entitlement was not already granted for this purchaseToken.
    // Grant entitlement to the user.

    ConsumeParams consumeParams =
        ConsumeParams.newBuilder()
            .setPurchaseToken(purchase.getPurchaseToken())
            .build();

    ConsumeResponseListener listener = new ConsumeResponseListener() {
        @Override
        public void onConsumeResponse(BillingResult billingResult, String purchaseToken) {
            if (billingResult.getResponseCode() == BillingResponseCode.OK) {
                // Handle the success of the consume operation.
            }
        }
    };

    billingClient.consumeAsync(consumeParams, listener);
}

Untuk menyetujui pembelian yang tidak habis pakai, gunakan BillingClient.acknowledgePurchase() dari Library Layanan Penagihan atau Product.Purchases.Acknowledge dari Google Play Developer API. Sebelum mengonfirmasi pembelian, aplikasi Anda harus memeriksa apakah pembelian itu sudah disetujui dengan menggunakan metode isAcknowledged() di Library Layanan Penagihan Google Play atau kolom acknowledgementState di Google Developer API.

Contoh berikut menunjukkan cara mengonfirmasi pembelian menggunakan Library Layanan Penagihan Google Play:

val client: BillingClient = ...
val acknowledgePurchaseResponseListener: AcknowledgePurchaseResponseListener = ...

suspend fun handlePurchase() {
    if (purchase.purchaseState === PurchaseState.PURCHASED) {
        if (!purchase.isAcknowledged) {
            val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder()
                    .setPurchaseToken(purchase.purchaseToken)
            val ackPurchaseResult = withContext(Dispatchers.IO) {
               client.acknowledgePurchase(acknowledgePurchaseParams.build())
            }
        }
     }
}

BillingClient client = ...
AcknowledgePurchaseResponseListener acknowledgePurchaseResponseListener = ...

void handlePurchase(Purchase purchase) {
    if (purchase.getPurchaseState() == PurchaseState.PURCHASED) {
        if (!purchase.isAcknowledged()) {
            AcknowledgePurchaseParams acknowledgePurchaseParams =
                AcknowledgePurchaseParams.newBuilder()
                    .setPurchaseToken(purchase.getPurchaseToken())
                    .build();
            client.acknowledgePurchase(acknowledgePurchaseParams, acknowledgePurchaseResponseListener);
        }
    }
}

Langganan ditangani dengan cara yang sama seperti item yang tidak habis pakai. Anda dapat menyetujui Konfirmasi langganan menggunakan BillingClient.acknowledgePurchase() dari Library Layanan Penagihan Google Play atau Purchases.Subscriptions.Acknowledge dari Google Play Developer API. Semua pembelian langganan awal harus dikonfirmasi. Perpanjangan langganan tidak perlu dikonfirmasi. Untuk informasi selengkapnya tentang kapan langganan perlu dikonfirmasi, lihat topik Menjual langganan.

Mengambil pembelian

Memproses update pembelian menggunakan PurchasesUpdatedListener tidak cukup untuk memastikan aplikasi Anda memproses semua pembelian. Ada kemungkinan bahwa aplikasi Anda tidak mengetahui semua pembelian yang dilakukan pengguna. Berikut ini beberapa skenario saat aplikasi Anda tidak dapat melacak atau tidak mengetahui pembelian:

• Masalah Jaringan selama pembelian: Pengguna melakukan pembelian yang berhasil dan menerima konfirmasi dari Google, namun perangkat mereka kehilangan sambungan jaringan sebelum perangkat mereka menerima notifikasi pembelian melalui perangkat PurchasesUpdatedListener.
• Beberapa perangkat: Pengguna membeli item di satu perangkat, lalu mengharapkan untuk melihat item tersebut saat beralih perangkat.
• Menangani pembelian yang dilakukan di luar aplikasi: Beberapa pembelian, seperti penukaran promosi, dapat dilakukan di luar aplikasi Anda.

Untuk menangani situasi ini, pastikan aplikasi Anda memanggil BillingClient.queryPurchasesAsync() dalam metode onResume() dan onCreate() untuk memastikan semua pembelian berhasil diproses seperti yang dijelaskan dalam memproses pembelian.

Menangani pembelian yang dilakukan di luar aplikasi

Beberapa pembelian, seperti penukaran promosi, dapat terjadi di luar aplikasi. Saat pengguna melakukan pembelian di luar aplikasi Anda, mereka berharap aplikasi Anda menampilkan pesan dalam aplikasi, atau menggunakan mekanisme notifikasi tertentu untuk memberi tahu pengguna bahwa aplikasi telah menerima dan memproses pembelian dengan benar. Mekanisme yang dapat diterima antara lain:

• Menampilkan pop-up dalam aplikasi.
• Mengirim pesan ke kotak pesan dalam aplikasi, dan menyatakan dengan jelas bahwa ada pesan baru di kotak pesan dalam aplikasi.
• Menggunakan pesan notifikasi OS.

Perlu diingat bahwa aplikasi Anda mungkin berada dalam keadaan apa pun saat aplikasi mengenali pembelian. Aplikasi Anda bahkan mungkin belum diinstal saat pembelian dilakukan. Pengguna berharap menerima pembelian mereka saat melanjutkan aplikasi, terlepas dari status aplikasi tersebut.

Anda harus mendeteksi pembelian terlepas dari status aplikasi saat pembelian dilakukan. Namun, ada beberapa pengecualian yang mungkin membuat kami tidak dapat segera memberi tahu pengguna bahwa item telah diterima. Contoh:

• Selama bagian tindakan dalam game, di mana menampilkan pesan dapat mengalihkan perhatian pengguna. Dalam hal ini, Anda harus memberi tahu pengguna setelah bagian tindakan itu selesai.
• Selama cutscene, di mana menampilkan pesan dapat mengganggu perhatian pengguna. Dalam hal ini, Anda harus memberi tahu pengguna setelah cutscene berakhir.
• Selama tutorial awal dan bagian penyiapan pengguna dalam game. Sebaiknya beri tahu pengguna baru tentang bonus segera setelah mereka membuka game atau selama penyiapan pengguna awal. Namun, Anda masih dapat menunggu hingga urutan game utama tersedia untuk memberi tahu pengguna.

Selalu perhatikan pengguna saat memutuskan kapan dan bagaimana cara memberi tahu pengguna tentang pembelian yang dilakukan di luar aplikasi. Setiap kali pengguna tidak langsung menerima notifikasi, mereka mungkin akan bingung, dan dapat berhenti menggunakan aplikasi Anda, menghubungi dukungan pengguna, atau mengeluhkannya di media sosial.

Menangani transaksi yang tertunda

Google Play mendukung transaksi yang tertunda, atau transaksi yang memerlukan satu atau beberapa langkah tambahan antara saat pengguna memulai pembelian dan saat metode pembayaran untuk pembelian tersebut diproses. Aplikasi Anda tidak boleh memberikan hak atas jenis pembelian ini sampai Google memberi tahu Anda bahwa metode pembayaran pengguna berhasil ditagih.

Misalnya, pengguna dapat melakukan pembelian PENDING dari item dalam aplikasi dengan memilih uang tunai sebagai metode pembayaran. Selanjutnya, pengguna bisa memilih toko fisik tempat mereka akan menyelesaikan transaksi dan menerima kode melalui notifikasi dan email. Saat pengguna tiba di toko fisik, mereka dapat menukarkan kode dengan kasir dan membayar dengan uang tunai. Kemudian, Google memberi tahu Anda dan pengguna bahwa uang tunai telah diterima. Kemudian, aplikasi Anda dapat memberikan hak kepada pengguna.

Aplikasi Anda harus mendukung transaksi yang tertunda dengan memanggil enablePendingPurchases() sebagai bagian dari inisialisasi aplikasi.

Jika aplikasi Anda menerima pembelian baru, baik melalui PurchasesUpdatedListener atau sebagai hasil dari panggilan queryPurchasesAsync(), gunakan metode getPurchaseState() untuk menentukan apakah status pembelian adalah PURCHASED atau PENDING. Perlu diketahui bahwa sebaiknya Anda hanya memberikan hak jika pembelian tersebut berstatus PURCHASED. Jika aplikasi Anda berjalan saat pengguna menyelesaikan pembelian, PurchasesUpdatedListener akan dipanggil lagi, dan PurchaseState sekarang menjadi PURCHASED. Pada tahap ini, aplikasi Anda dapat memproses pembelian menggunakan metode standar untuk memproses pembelian satu kali. Aplikasi Anda juga harus memanggil queryPurchasesAsync() di metode onResume() dan onCreate() aplikasi untuk menangani pembelian yang telah dialihkan ke status PURCHASED saat aplikasi Anda tidak berjalan.

Aplikasi juga dapat menggunakan Notifikasi developer real time dengan pembelian tertunda dengan cara memproses OneTimeProductNotifications. Saat pembelian bertransisi dari PENDING ke PURCHASED, aplikasi Anda akan menerima notifikasi ONE_TIME_PRODUCT_PURCHASED. Jika pembelian dibatalkan, aplikasi Anda akan menerima notifikasi ONE_TIME_PRODUCT_CANCELED. Hal ini dapat terjadi jika pelanggan tidak menyelesaikan pembayaran dalam jangka waktu yang diperlukan. Saat menerima notifikasi ini, Anda dapat menggunakan Google Play Developer API yang menyertakan status PENDING untuk Purchases.products.