Menguji Penagihan dalam Aplikasi

Google Play Developer Console menyediakan beberapa alat yang memungkinkan Anda menguji implementasi Penagihan dalam Aplikasi:

  • Pembelian pengujian, yang memungkinkan pengguna pengujian lisensi untuk membeli item dalam aplikasi yang diterbitkan, tanpa dikenakan biaya yang sebenarnya pada akunnya.
  • Respons penagihan statis dari Google Play, untuk menguji di development tahap awal.

Untuk menguji penagihan dalam aplikasi, Anda harus menerbitkan aplikasi Anda ke saluran alfa atau beta di Google Play.

Setelah Anda menerbitkan aplikasi ke saluran alfa atau beta, akan diperlukan beberapa jam sampai aplikasi tersedia untuk penguji. Kode versi APK di perangkat pengujian harus cocok dengan versi yang saat ini diunggah ke saluran alfa atau beta di Google Play.

Penting: Untuk menguji produk dalam aplikasi atau membuat pembelian dalam aplikasi di aplikasi saluran alfa atau beta, setiap penguji perlu ikut serta dalam pengujian alfa atau beta aplikasi Anda. Di URL keikutsertaan pengujian Anda, penguji Anda akan memperoleh penjelasan tentang maksud menjadi seorang pengujian dan tautan untuk ikut serta.

Anda bisa menguji pada perangkat keras yang didayai Android yang berjalan pada Android 1.6 atau yang lebih tinggi. Versi paling baru aplikasi Google Play harus dipasang di perangkat. Untuk informasi umum tentang cara menyiapkan perangkat untuk digunakan di pengembangan aplikasi Android, lihat Menggunakan Perangkat Keras.

Menguji Pembelian dalam Aplikasi

Bila implementasi Penagihan dalam Aplikasi sudah siap, Anda bisa menguji pembelian SKU dalam aplikasi dengan dua cara:

  • Pembelian pengujian, yang memungkinkan pengguna pengujian lisensi yang Anda pilih membeli produk dalam aplikasi Anda tanpa terkena biaya. Pembelian pengujian bisa digunakan di rilis alfa/beta saja.
  • Pembelian nyata, yang memungkinkan pengguna biasa melakukan pembelian nyata produk dalam aplikasi Anda dengan dikenai biaya sebenarnya pada instrumen pembayaran pengguna.

Dalam kedua kasus di atas, Anda perlu menerbitkan aplikasi Anda ke saluran rilis alfa dan beta Google Play untuk mengelola pengguna yang tidak bisa melakukan pembelian.

Bagian berikut menyediakan detail selengkapnya tentang cara menggunakan pendekatan ini untuk pengujian dan validasi.

Pembelian Pengujian (Kotak Pasir Penagihan dalam Aplikasi)

Pembelian pengujian menawarkan cara yang aman dan mudah untuk memungkinkan pengujian implementasi Penagihan dalam Aplikasi Anda dalam skala lebih besar selama development atau sebagai persiapan peluncuran. Pembelian pengujian memungkinkan akun pengguna yang diotorisasi untuk melakukan pembelian produk dalam aplikasi Anda melalui Google Play tanpa terkena biaya sebenarnya pada akun pengguna.

Setelah diotorisasi untuk akses pengujian, pengguna tersebut bisa melakukan pembelian tanpa terkena biaya. Pembelian pengujian tidak memiliki bidang orderId, yang memastikan tidak ada biaya sebenarnya yang dikenakan ke akun pengguna.

Catatan: Pembelian langganan pengujian berulang tiap hari, tanpa memandang periode langganan produk.

Menyiapkan pembelian pengujian

Menyiapkan pembelian pengujian cukup mudah—akun pengguna apa pun bisa dipilih menjadi akun pengujian, dan pengguna akun pengujian apa pun bisa melakukan pembelian pengujian dengan metode pembayaran apa pun yang tersedia (meskipun tidak dikenakan biaya pada metode pembayaran).

Pertama, unggah dan terbitkan produk dalam aplikasi yang ingin Anda sediakan agar bisa dibeli oleh penguji. Anda bisa mengunggah dan menerbitkan produk dalam aplikasi di Developer Console. Perhatikan bahwa Anda bisa mengunggah dan menerbitkan item dalam aplikasi Anda sebelum menerbitkan APK-nya sendiri.

Selanjutnya, buat akun pengujian lisensi untuk pengguna yang diotorisasi. Di Developer Console, buka Settings > Account details, lalu di bagian License Testing, tambahkan alamat ke bidang Gmail accounts with testing access. Untuk informasi selengkapnya, lihat Melakukan Persiapan untuk Pembelian Pengujian.

Setelah Anda menambahkan pengguna sebagai akun penguji lisensi dan menyimpan perubahan, dalam 15 menit pengguna tersebut bisa mulai melakukan pembelian pengujian produk dalam aplikasi Anda.

Penting: Setelah Anda menerbitkan aplikasi ke saluran alfa atau beta, penguji Anda perlu ikut serta dalam pengujian alfa atau beta aplikasi Anda menggunakan URL keikutsertaan yang disediakan agar bisa melakukan pembelian pengujian.

Catatan: Akun pengujian lisensi harus berada di perangkat Android pengguna. Jika perangkat memiliki lebih dari satu akun, pembelian akan dilakukan dengan akun yang mengunduh aplikasi. Jika tak satu pun akun telah mengunduh aplikasi, pembelian dilakukan dengan akun pertama. Pengguna bisa mengonfirmasi akun yang melakukan pembelian dengan meluaskan dialog pembelian.

Catatan: Pembelian pengujian tidak memiliki bidang orderId . Untuk melacak pembelian pengujian, gunakan bidang purchaseToken sebagai gantinya.

Pembelian pengujian dan akun developer

Akun pengujian lisensi yang diotorisasi dikaitkan dengan akun developer Anda di Google Play, bukan dengan APK atau nama paket tertentu. Mengidentifikasi akun sebagai akun pengujian memungkinkannya untuk membeli produk dalam aplikasi apa pun tanpa terkena biaya.

Detail alur pembelian

Selama pembelian pengujian, pengguna bisa menguji alur pemilihan, pembelian, dan penyediaan sebenarnya di aplikasi Anda. Selama pembelian, item dalam aplikasi ditampilkan sebagai item normal dengan harga sebenarnya. Akan tetapi, Google Play menandai pembelian pengujian dengan pemberitahuan di tengah dialog pembelian agar mudah dikenali.

Membatalkan pembelian pengujian yang telah diselesaikan

Google Play mengumpulkan pembelian pengujian yang telah diselesaikan untuk setiap pengguna, tetapi tidak meneruskannya untuk pemrosesan finansial.

Dalam sebagian kasus, Anda bisa membatalkan pembelian pengujian secara manual untuk melanjutkan pengujian. Untuk melakukannya, buka laman aplikasi di Play Store. Jika pembelian pengujian yang ingin Anda batalkan adalah langganan, Anda juga bisa menggunakan metode cancel() dari Purchases.subscriptions API.

Penting: Metode refund() dan revoke() dari Purchases.subscriptions API tidak mendukung pembelian pengujian.

Menguji dengan transaksi nyata

Saat mempersiapkan peluncuran aplikasi yang menggunakan Penagihan dalam Aplikasi, Anda bisa memanfaatkan opsi rilis alfa/beta Google Play untuk melakukan validasi dan pengujian beban pada implementasi Anda sebelum mendistribusikan aplikasi ke semua pengguna Anda.

Dengan grup pengujian alfa/beta, pengguna sebenarnya (yang Anda pilih) bisa memasang aplikasi Anda dari Google Play dan menguji produk dalam aplikasi Anda. Pengguna ini bisa melakukan pembelian nyata yang dikenakan biaya pada akunnya, menggunakan metode pembayaran normal apa pun di Google Play untuk melakukan pembelian. Perhatikan bahwa jika Anda menyertakan akun lisensi pengujian di grup distribusi alfa dan beta, pengguna tersebut hanya akan dapat melakukan pembelian pengujian.

Penting: Setelah Anda menerbitkan aplikasi ke saluran alfa atau beta, penguji Anda perlu ikut serta dalam pengujian alfa atau beta aplikasi Anda menggunakan URL keikutsertaan yang disediakan agar bisa melakukan pembelian pengujian.

Menguji dengan Respons Statis

Kami sarankan agar Anda terlebih dulu menguji implementasi Penagihan dalam Aplikasi menggunakan respons statis dari Google Play. Ini memungkinkan Anda memverifikasi bahwa aplikasi Anda menangani respons Google Play utama dengan benar dan bahwa aplikasi Anda mampu memverifikasi tanda tangan dengan benar. Anda bisa melakukan ini meskipun aplikasi belum diterbitkan.

Untuk menguji implementasi Anda dengan respons statis, buat permintaan Penagihan dalam Aplikasi menggunakan item khusus yang memiliki ID produk yang sudah diperuntukkan. Setiap ID produk yang sudah diperuntukkan mengembalikan respons statis tertentu dari Google Play. Tidak ada transfer uang bila Anda membuat permintaan Penagihan dalam Aplikasi dengan ID produk yang sudah diperuntukkan. Selain itu, Anda tidak bisa menentukan bentuk pembayaran saat membuat permintaan penagihan dengan ID produk yang sudah diperuntukkan. Gambar 1 menampilkan alur checkout untuk item yang sudah diperuntukkan yang memiliki ID produk android.test.purchased.

Gambar 1.Alur pembelian untuk item pesanan khusus android.test.purchased.

Anda tidak perlu mencantumkan produk yang sudah diperuntukkan di daftar produk aplikasi Anda. Google Play sudah mengetahui tentang ID produk yang sudah diperuntukkan. Selain itu, Anda tidak perlu mengunggah aplikasi Anda ke Developer Console untuk melakukan pengujian respons statis dengan ID produk pesanan. Anda cukup memasang aplikasi pada perangkat, masuk ke perangkat, dan membuat permintaan penagihan menggunakan ID produk yang sudah diperuntukkan.

Catatan: Sebelumnya, Anda bisa menguji aplikasi dengan mengunggah versi "draf" yang belum diterbitkan. Fungsi ini tidak lagi didukung. Akan tetapi, Anda bisa menguji aplikasi dengan respons statis sebelum mengunggahnya ke Google Play Store. Untuk informasi selengkapnya, lihat Aplikasi Draf Tidak Lagi Didukung.

Ada empat ID produk yang sudah diperuntukkan untuk menguji respons Penagihan dalam Aplikasi statis:

  • android.test.purchased

    Bila Anda membuat permintaan Penagihan dalam Aplikasi dengan ID produk ini, Google Play merespons seolah-olah Anda berhasil membeli item. Respons mencakup string JSON, yang berisi informasi pembelian palsu (misalnya, ID pesanan palsu). Dalam beberapa kasus, string JSON ditandatangani dan respons mencakup tanda tangan tersebut sehingga Anda bisa menguji implementasi verifikasi tanda tangan menggunakan respons ini.

  • android.test.canceled

    Bila Anda membuat permintaan Penagihan dalam Aplikasi dengan ID produk ini, Google Play merespons seolah-olah pembelian dibatalkan. Ini bisa terjadi saat ditemukan kesalahan pada proses pemesanan, misalnya kartu kredit tidak valid, atau bila Anda membatalkan pesanan pengguna sebelum dikenai biaya.

  • android.test.refunded

    Bila Anda membuat permintaan Penagihan dalam Aplikasi dengan ID produk ini, Google Play merespons seolah-olah pembelian dikembalikan dananya. Pengembalian dana tidak bisa dimulai melalui layanan penagihan dalam aplikasi Google Play. Pengembalian dana harus dimulai oleh Anda (penjual). Setelah Anda memproses permintaan pengembalian dana melalui akun penjual Google Payments, pesan pengembalian dana dikirimkan ke aplikasi Anda oleh Google Play. Ini terjadi hanya saat Google Play mendapatkan notifikasi dari Google Payments bahwa pengembalian dana telah dilakukan. Untuk informasi selengkapnya tentang pengembalian dana, lihat Menangani pesan IN_APP_NOTIFY dan Penetapan Harga Penagihan dalam Aplikasi.

  • android.test.item_unavailable

    Bila Anda membuat permintaan Penagihan dalam Aplikasi dengan ID produk Anda, Google Play merespons seolah-olah ....item yang sedang dibeli tidak tercantum dalam daftar produk aplikasi Anda.

Dalam beberapa kasus, item yang sudah diperuntukkan bisa mengembalikan respons statis, yang memungkinkan Anda menguji verifikasi tanda tangan di aplikasi Anda. Item yang diperuntukkan hanya mengembalikan respons yang ditandatangani jika pengguna yang menjalankan aplikasi memiliki akun developer atau akun pengujian.

Untuk membuat permintaan Penagihan dalam Aplikasi dengan ID produk yang sudah diperuntukkan, cukup buat permintaan REQUEST_PURCHASE biasa, tetapi sebagai ganti menggunakan ID produk yang sebenarnya dari daftar produk aplikasi Anda, gunakan salah satu ID produk yang sudah diperuntukkan.

Untuk menguji aplikasi Anda menggunakan ID produk yang sudah diperuntukkan, ikuti langkah-langkah berikut:

  1. Pasang aplikasi Anda pada perangkat Android.

    Anda tidak bisa menggunakan emulator untuk menguji Penagihan dalam Aplikasi; Anda harus memasang aplikasi pada perangkat untuk menguji Penagihan dalam Aplikasi.

    Untuk mempelajari cara memasang aplikasi pada perangkat, lihat Menjalankan pada perangkat.

  2. Masuk ke perangkat Anda dengan akun developer.

    Anda tidak perlu menggunakan akun pengujian jika Anda hanya menguji dengan ID produk yang sudah diperuntukkan.

  3. Verifikasi apakah perangkat Anda menjalankan versi aplikasi Google Play atau aplikasi MyApps yang didukung.

    Jika perangkat Anda menjalankan Android 3.0, Penagihan dalam Aplikasi memerlukan aplikasi MyApps versi 5.0.12 (atau yang lebih tinggi). Jika perangkat Anda menjalankan versi Android yang lain, Penagihan dalam Aplikasi memerlukan aplikasi Google Play versi 2.3.4 (atau yang lebih tinggi). Untuk mempelajari cara memeriksa versi aplikasi Google Play, lihat Memperbarui Google Play.

  4. Jalankan aplikasi Anda dan beli ID produk yang sudah diperuntukkan.

Catatan: Membuat permintaan Penagihan dalam Aplikasi dengan ID produk yang sudah diperuntukkan akan mengganti sistem produksi Google Play yang biasanya. Saat mengirimkan permintaan Penagihan dalam Aplikasi untuk ID produk yang sudah diperuntukkan, kualitas layanan tidak bisa diperbandingkan dengan lingkungan produksi.

Melakukan Persiapan untuk Pembelian Pengujian

Setelah Anda menyelesaikan pengujian respons statis, dan telah memverifikasi bahwa verifikasi tanda tangan berfungsi di aplikasi, Anda bisa menguji implementasi Penagihan dalam Aplikasi dengan membuat pembelian dalam aplikasi yang sebenarnya. Menguji pembelian dalam aplikasi memungkinkan Anda menguji pengalaman Penagihan dalam Aplikasi secara menyeluruh, termasuk pembelian sebenarnya dari Google Play dan alur checkout sebenarnya yang akan dialami pengguna di aplikasi Anda.

Catatan: Anda bisa melakukan pengujian aplikasi Anda secara menyeluruh dengan menerbitkannya ke saluran distribusi alfa. Ini memungkinkan Anda menerbitkan aplikasi ke Google Play Store, tetapi membatasi ketersediaannya hanya kepada penguji yang sudah Anda tetapkan.

Untuk menguji implementasi Penagihan dalam Aplikasi dengan pembelian dalam aplikasi sebenarnya, Anda perlu mendaftarkan minimal satu akun pengujian di Google Play Developer Console. Anda tidak bisa menggunakan akun developer Anda untuk menguji proses pembelian dalam aplikasi secara lengkap karena Google Payments tidak mengizinkan Anda membeli produk oleh Anda sendiri. Jika Anda belum pernah menyiapkan akun pengujian, lihat Menyiapkan akun pengujian.

Akun pengujian bisa membeli item di daftar produk Anda hanya jika item telah diterbitkan.

Untuk menguji implementasi Penagihan dalam Aplikasi Anda dengan pembelian sebenarnya, ikuti langkah-langkah ini:

  1. Unggah aplikasi Anda ke saluran distribusi alfa dengan Developer Console.

    Catatan: Sebelumnya, Anda bisa menguji aplikasi dengan mengunggah versi "draf" yang belum diterbitkan. Fungsi ini tidak lagi didukung; sekarang Anda harus menerbitkannya ke saluran distribusi alfa atau beta. Untuk informasi selengkapnya, lihat Aplikasi Draf Tidak Lagi Didukung.

  2. Tambahkan item ke daftar produk aplikasi.

    Pastikan Anda menerbitkan item (aplikasi bisa tetap tidak diterbitkan). Lihat Membuat daftar produk untuk mempelajari cara melakukan ini.

  3. Pasang aplikasi Anda pada perangkat Android.

    Anda tidak bisa menggunakan emulator untuk menguji Penagihan dalam Aplikasi; Anda harus memasang aplikasi pada perangkat untuk menguji Penagihan dalam Aplikasi.

    Untuk mempelajari cara memasang aplikasi pada perangkat, lihat Menjalankan pada perangkat.

  4. Verifikasi apakah perangkat Anda menjalankan versi aplikasi Google Play atau aplikasi MyApps yang didukung.

    Jika perangkat Anda menjalankan Android 3.0, Penagihan dalam Aplikasi memerlukan aplikasi MyApps versi 5.0.12 (atau yang lebih tinggi). Jika perangkat Anda menjalankan versi Android yang lain, Penagihan dalam Aplikasi memerlukan aplikasi Google Play versi 2.3.4 (atau yang lebih tinggi). Untuk mempelajari cara memeriksa versi aplikasi Google Play, lihat Memperbarui Google Play.

  5. Membuat pembelian dalam aplikasi di aplikasi Anda.

Catatan: Satu-satunya cara mengubah akun utama di perangkat ini adalah dengan melakukan penyetelan ulang pabrik, lalu pastikan Anda masuk dengan akun utama terlebih dulu.

Setelah selesai menguji implementasi Penagihan dalam Aplikasi, Anda siap menerbitkan aplikasi Anda di Google Play. Anda bisa mengikuti langkah-langkah seperti biasa untuk menyiapkan, menandatangani, dan menerbitkan ke Google Play.

Aplikasi Draf Tidak Lagi Didukung

Sebelumnya, Anda bisa menerbitkan versi "draf" aplikasi Anda untuk pengujian. Fungsi ini tidak lagi didukung. Sebagai gantinya, ada dua cara bagi Anda untuk menguji bagaimana aplikasi prarilis bisa berfungsi di Google Play Store:

  • Anda bisa menerbitkan aplikasi ke saluran distribusi alfa atau beta. Ini menjadikan aplikasi tersedia di Google Play Store, tetapi hanya untuk penguji yang sudah Anda masukkan ke dalam "daftar putih".
  • Dalam beberapa kasus, Anda bisa menguji fungsi Google Play dengan aplikasi yang belum diterbitkan. Misalnya, Anda bisa menguji dukungan penagihan dalam aplikasi pada aplikasi yang belum diterbitkan dengan menggunakan respons statis, ID produk khusus yang sudah diperuntukkan yang selalu mengembalikan hasil khusus (seperti "dibeli" atau "dana dikembalikan").