Anda harus menguji integrasi selama pengembangan. Untuk menguji selama fase pengembangan, sebaiknya manfaatkan penguji lisensi dan Play Billing Lab untuk menjalankan skenario yang dijelaskan di bagian ini.
Penguji Lisensi
Untuk mengonfigurasi penguji lisensi, lihat Menguji penagihan via Google Play dengan pemberian lisensi aplikasi.
Dengan menggunakan penguji lisensi, Anda bisa mendapatkan beberapa manfaat berikut:
- Biasanya, Google Play Billing Library diblokir untuk aplikasi yang tidak ditandatangani dan diupload ke Google Play. Penguji lisensi dapat mengabaikan pemeriksaan ini, yang berarti Anda dapat melakukan sideload aplikasi untuk pengujian, bahkan untuk aplikasi yang menggunakan build debug dengan tanda tangan debug tanpa perlu mengupload ke versi baru aplikasi Anda. Perhatikan bahwa nama paket harus cocok dengan nama paket aplikasi yang dikonfigurasi untuk Google Play, dan Akun Google harus merupakan penguji lisensi untuk akun Konsol Google Play.
- Penguji lisensi memiliki akses ke metode pembayaran pengujian yang menghindari penagihan uang sungguhan kepada penguji untuk pembelian. Anda juga dapat menggunakan metode pembayaran pengujian untuk menyimulasikan situasi tertentu, seperti saat pembayaran ditolak. Gambar 1 menunjukkan metode pembayaran pengujian ini seperti yang muncul dalam alur pembelian.
- Penguji lisensi dapat menguji fitur langganan dengan cepat.
Berikut adalah beberapa detail tambahan tentang proses uji pembelian:
- Uji pembelian menggunakan alur pembelian aplikasi yang sama dengan yang digunakan di pembelian sebenarnya.
- Pajak tidak dihitung untuk uji pembelian.
- Google Play mengindikasikan uji pembelian dengan menampilkan pemberitahuan di bagian tengah dialog pembelian.
Anda dapat mengonfirmasi akun yang melakukan pembelian dengan meluaskan dialog pembelian. Perhatikan hal berikut:
- Akun pengujian harus ada di perangkat Android penguji.
- Jika perangkat memiliki lebih dari satu akun, pembelian akan dilakukan dengan akun yang mendownload aplikasi.
- Jika tidak ada akun yang mendownload aplikasi, pembelian akan dilakukan dengan akun pertama.
Gunakan jalur pengujian Google Play untuk validasi pra-distribusi, seperti memungkinkan tim QA Anda memenuhi syarat rilis baru. Dengan jalur pengujian, penguji lisensi dapat menginstal dan mengevaluasi versi aplikasi yang belum dirilis dari Google Play. Pengguna reguler dapat melakukan pembelian sungguhan menggunakan metode pembayaran standar.
Untuk menguji integrasi Library Layanan Penagihan Google Play menggunakan jalur pengujian, lakukan hal berikut:
- Publikasikan aplikasi Anda ke jalur pengujian. Perhatikan bahwa setelah Anda memublikasikan aplikasi ke jalur pengujian, mungkin perlu waktu beberapa jam hingga aplikasi tersedia untuk penguji.
- Pastikan setiap penguji ikut serta dalam pengujian aplikasi Anda. Di URL keikutsertaan pengujian, penguji akan melihat penjelasan tentang manfaat menjadi penguji beserta link untuk ikut serta.
Anda dapat menguji integrasi di perangkat hardware Android apa pun yang menjalankan Android 1.6 atau yang lebih baru. Versi terbaru aplikasi Google Play harus diinstal di perangkat. Untuk mengetahui informasi umum tentang cara menyiapkan perangkat untuk digunakan dalam mengembangkan aplikasi Android, lihat Menggunakan Perangkat Hardware.
Play Billing Lab
Play Billing Lab adalah aplikasi Android yang membantu developer menguji integrasi mereka dengan sistem penagihan Google Play. Aplikasi ini memberikan cara yang praktis bagi developer untuk menguji fitur penagihan, melakukan integrasi lebih cepat, dan meluncurkan dengan keyakinan lebih tinggi. Anda dapat mendownload dan menginstal Play Billing Lab dari Google Play Store.
Play Billing Lab memungkinkan Anda melakukan hal berikut dalam pengujian:
- Ubah Negara Play dari dalam Play Billing Lab dan terapkan setelan ke pengujian Anda. Hal ini memungkinkan pengujian pengalaman pengguna kustom di berbagai negara/wilayah, terlepas dari lokasi pengujian secara fisik
- Menguji penawaran uji coba atau perkenalan berulang kali dengan akun yang sama
- Menguji perubahan harga langganan tanpa memengaruhi pelanggan aktif lainnya
- Percepat transisi status langganan untuk mempercepat perpanjangan langganan, atau pindahkan langganan pengujian Anda ke status masa tenggang atau penangguhan akun dengan satu klik untuk mempercepat pengujian
- Menguji dengan metode pembayaran sungguhan untuk mengabaikan sinyal risiko alur pembelian tertentu
- Uji pembelian di luar aplikasi untuk memastikan backend Anda dapat menanganinya
Menguji produk sekali beli
Menguji produk habis pakai
Saat menguji produk habis pakai, uji berbagai situasi, termasuk hal berikut:
- Pembelian yang berhasil, yaitu saat pengguna menerima item. Dengan penguji lisensi, Anda dapat menggunakan metode pembayaran Instrumen pengujian, selalu menyetujui.
- Pembelian yang metode pembayarannya gagal ditagih, dan pengguna tidak akan menerima item. Dengan penguji lisensi, Anda dapat menggunakan metode pembayaran Instrumen pengujian, selalu menolak.
- Pastikan item dapat dibeli beberapa kali.
Pastikan pembelian dikonfirmasi dengan benar seperti yang dijelaskan dalam memproses pembelian. Untuk pembelian dari penguji lisensi, pembelian akan dikembalikan dananya setelah 3 menit jika aplikasi Anda tidak mengonfirmasi pembelian dan Anda akan menerima email tentang pembatalan. Anda juga dapat memeriksa tab Pesanan di Konsol Google Play untuk melihat apakah pesanan dikembalikan dananya setelah 3 menit.
Menguji produk tidak habis pakai
Item tidak habis pakai harus diuji sama seperti item habis pakai, tetapi Anda harus memverifikasi bahwa item tidak dapat dibeli lagi dalam aplikasi Anda. Pastikan untuk memverifikasi konfirmasi pembelian untuk item tidak habis pakai dan item habis pakai (jika berlaku) karena logika untuk memproses setiap jenis pembelian berbeda.
Menguji pembelian tertunda
Uji pembelian tertunda tempat item harus diizinkan saat status pembelian
menjadi PURCHASED. Penguji lisensi memiliki akses ke dua instrumen pengujian untuk
metode pembayaran tertunda yang pembayarannya secara otomatis diselesaikan atau dibatalkan
setelah beberapa menit.
Lakukan pembelian dengan metode pembayaran tertunda Kartu tes lambat, menolak setelah beberapa menit, seperti yang ditunjukkan pada gambar 3. Mulai ulang aplikasi, validasi bahwa pembelian belum diizinkan.
Gambar 3. Uji pembelian dengan kartu tes lambat yang ditolak. Lakukan pembelian dengan metode pembayaran tertunda Kartu tes lambat, menyetujui setelah beberapa menit, seperti yang ditunjukkan pada gambar 4. Tunggu beberapa menit, validasi bahwa pembelian telah diizinkan.
Gambar 4. Uji pembelian dengan kartu tes lambat yang disetujui.
Anda dapat menemukan informasi selengkapnya di bagian Menangani transaksi yang tertunda.
Menguji penagihan balik yang dimulai pengguna
Penguji lisensi memiliki akses ke instrumen pengujian yang memungkinkan mereka menyimulasikan penagihan balik yang dimulai pengguna.
Lakukan pembelian dengan instrumen pengujian Kartu pengujian, menyetujui lalu menagih balik, seperti yang ditunjukkan pada gambar 5. Segera setelah itu, sistem Anda akan diberi tahu bahwa pembelian uji coba sedang dikirim dan ditagih balik melalui platform yang berlaku. Misalnya, Anda akan menerima PendingRefundReviewNotification beberapa saat setelah melakukan pembelian.
Gambar 5. Uji pembelian dengan kartu pengujian yang menyetujui, lalu menagih balik.
Menguji fitur khusus langganan
Alur pembelian untuk produk sekali beli dan langganan serupa, tetapi langganan memiliki skenario tambahan, seperti perpanjangan langganan yang berhasil atau ditolak. Untuk menguji perpanjangan, Anda dapat menggunakan metode pembayaran Kartu pengujian, selalu disetujui dan Kartu pengujian, selalu ditolak yang tersedia untuk penguji lisensi, seperti yang ditunjukkan pada gambar 1. Gunakan instrumen pembayaran ini untuk menguji skenario di luar skenario langganan yang berhasil.
Serupa dengan produk sekali beli, verifikasi bahwa pembelian telah dikonfirmasi dengan benar seperti yang dijelaskan di memproses pembelian. Untuk pembelian dari penguji lisensi, pembelian akan dikembalikan dananya setelah 3 menit jika aplikasi Anda tidak mengonfirmasi pembelian, dan Anda akan menerima email tentang pembatalan. Anda juga dapat memeriksa tab Pesanan di Konsol Google Play untuk melihat apakah pesanan dikembalikan dananya setelah 3 menit.
Periode perpanjangan
Langganan pengujian diperpanjang lebih cepat daripada langganan sebenarnya, dan langganan pengujian dapat diperpanjang maksimal enam kali, tidak termasuk uji coba gratis dan periode perkenalan.
Tabel berikut mencantumkan waktu perpanjangan pengujian untuk langganan dengan berbagai durasi. Waktu ini merupakan perkiraan. Anda mungkin melihat sedikit variasi dalam waktu yang tepat dari suatu peristiwa. Untuk mengimbangi variasi, panggil API untuk melihat status saat ini setelah setiap tanggal habis masa berlaku langganan.
| Periode langganan produksi | Perpanjangan langganan uji |
| 1 minggu | 5 menit |
| 1 bulan | 5 menit |
| 3 bulan | 10 menit |
| 6 bulan | 15 menit |
| 1 tahun | 30 menit |
Fitur langganan berbasis waktu seperti uji coba gratis juga dipersingkat untuk pengujian. Tabel berikut mengidentifikasi jangka waktu pengujian yang terkait dengan fitur langganan berbasis waktu:
| Fitur | Jangka waktu pengujian |
| Penangguhan akun | 10 menit |
| Uji coba gratis | 3 menit |
| Masa tenggang | 5 menit |
| Jangka waktu harga perkenalan | Sama dengan jangka waktu pengujian langganan |
| Jeda (1 bulan) | 5 menit |
| Jeda (2 bulan) | 10 menit |
| Jeda (3 bulan) | 15 menit |
| Periode izin kenaikan harga (hanya berlaku untuk wilayah Korea Selatan (KR)) |
3 menit |
| Konfirmasi pembelian | 5 menit |
Mempercepat transisi status langganan
Anda juga dapat menggunakan Play Billing Lab dan penguji lisensi untuk mempercepat periode perpanjangan langganan pengujian guna mempercepat pengujian langganan atau memindahkan langganan pengujian ke masa tenggang atau status penangguhan akun untuk menguji skenario penolakan pembayaran dengan langkah-langkah berikut:
- Klik Kelola di kartu Setelan langganan di Dasbor.
- Pilih langganan aktif yang ingin Anda uji.
- Klik menu drop-down Status langganan.
- Klik status target untuk memperbarui status langganan.
Setelah Anda memilih status langganan target di menu drop-down, status langganan pengujian akan segera diperbarui.
Perhatikan bahwa:
- Langganan pengujian harus dikonfirmasi sebelum menggunakan fitur Percepat Transisi Status Langganan.
- Metode pembayaran Anda akan otomatis ditolak saat Anda memindahkan langganan pengujian ke status masa tenggang atau penangguhan akun. Saat Anda memulihkan langganan pengujian, metode pembayaran Anda akan dipulihkan ke persetujuan otomatis.
- Proses transisi status langganan mungkin memerlukan waktu beberapa detik untuk dijalankan.
- Saat transisi status langganan sedang berlangsung, fitur perubahan harga langganan tidak tersedia.
- Jika Anda memperpanjang langganan pengujian saat perubahan harga berlaku, Google Play akan menerapkan harga baru jika pengguna telah menyetujuinya. Namun, jika harga baru memerlukan persetujuan pengguna dan pengguna belum menyetujuinya, Google Play akan membatalkan langganan.
Penawaran Uji Coba
Dengan fitur pengujian penawaran uji coba Play Billing Lab, penguji lisensi dapat menguji dan menggunakan uji coba gratis atau penawaran perkenalan tanpa batas dengan mencentang kotak Uji coba gratis atau penawaran perkenalan dan menerapkan perubahan. Dengan demikian, Anda tidak perlu membuat beberapa akun untuk menguji penawaran uji coba yang hanya tersedia untuk pelanggan baru.
Perubahan harga
Anda juga dapat menggunakan Play Billing Lab dan penguji lisensi untuk menguji perubahan harga langganan tanpa memengaruhi pelanggan aktif lainnya dengan langkah-langkah berikut:
- Klik Kelola di kartu Setelan langganan di Dasbor.
- Pilih langganan aktif yang ingin Anda uji.
- Masukkan harga baru.
- Centang atau hapus centang pada kotak User opt-out sesuai dengan persyaratan pengujian Anda.
- Klik Terapkan.
Setelah menerapkan perubahan, harga akan diperbarui mulai dari perpanjangan berikutnya hanya untuk penguji. Pelanggan aktif lainnya tidak akan terpengaruh. Semua aturan penguji lisensi berlaku untuk langganan pengujian. Penguji kemudian dapat menguji aplikasinya untuk proses downstream yang dipicu oleh perubahan harga, seperti notifikasi perubahan harga.
Perhatikan hal-hal berikut saat merencanakan periode pengujian:
- Karena durasi perpanjangan yang pendek untuk penguji lisensi, ada kemungkinan migrasi harga yang dilakukan dari konsol tidak akan terdaftar untuk penguji lisensi. Untuk memastikan bahwa notifikasi dan email perubahan harga dapat diuji, developer harus menunda penagihan setidaknya satu jam setelah memicu perubahan harga.
- Penurunan harga tidak memiliki periode notifikasi. Pengguna akan diberi tahu tentang penurunan harga segera setelah migrasi kohor. Hal ini tidak berubah saat menguji.
- Untuk kenaikan harga, waktu notifikasi pengujian dihitung sama seperti
kenaikan sebenarnya:
- Pengguna pertama kali ditagih pada hari jadi penagihan pertama setelah periode notifikasi wajib.
- Waktu notifikasi dihitung mundur dari tanggal penagihan pertama.
- Notifikasi terakhir selalu 1 menit sebelum tagihan, terlepas dari periode penagihan.
Tabel berikut menampilkan periode notifikasi dan penagihan pengujian untuk beberapa periode penagihan sebenarnya:
| Periode penagihan paket dasar sebenarnya | Periode penagihan pengujian | Periode notifikasi pengujian (wilayah yang menyatakan keikutsertaan dan ketidakikutsertaan dengan pemberitahuan 30 hari) | Periode notifikasi pengujian (wilayah yang tidak ikut serta dengan pemberitahuan 60 hari) |
| 1 minggu | 5 menit | 5 menit | 10 menit |
| 1 bulan | 5 menit | 5 menit | 10 menit |
| 3 bulan | 10 menit | 3 menit | 6 menit |
| 6 bulan | 15 menit | 2 menit | 4 menit |
| 1 tahun | 30 menit | 3 menit | 6 menit |
Izin kenaikan harga
Informasi terkait kenaikan harga yang memerlukan izin pengguna akan
tersedia untuk Anda di purchases.subscriptionsv2.get API.
Google Play mengirimkan dua notifikasi push dan email tentang kenaikan harga kepada pengguna yang relevan (termasuk penguji lisensi) sebelum kenaikan harga diterapkan. Periode pemberitahuan untuk pengujian adalah sebagai berikut:
| Jadwal notifikasi | Periode notifikasi pengujian |
| Notifikasi pertama | 3 menit |
| Notifikasi kedua (terakhir) | 1 menit |
Kasus pengujian
Perluas bagian berikut dengan mengklik Tampilkan/Sembunyikan untuk menampilkan skenario pengujian yang harus Anda gunakan untuk memverifikasi integrasi langganan.
Menguji transaksi tertunda
Anda harus menguji apakah transaksi tertunda ditangani dengan benar dan hak diperbarui
sebagaimana mestinya saat status pembelian menjadi PURCHASED. Penguji lisensi
memiliki akses ke dua instrumen pengujian untuk metode pembayaran tertunda yang
pembayarannya secara otomatis diselesaikan atau dibatalkan setelah beberapa menit.
Lakukan pembelian dengan metode pembayaran tertunda Kartu tes lambat, menolak setelah beberapa menit, seperti yang ditunjukkan pada gambar 9. Mulai ulang aplikasi, validasi bahwa pembelian belum diizinkan.
Gambar 9. Uji pembelian dengan kartu tes lambat yang ditolak. Lakukan pembelian dengan metode pembayaran tertunda Kartu tes lambat, menyetujui setelah beberapa menit, seperti yang ditunjukkan pada gambar 10. Tunggu beberapa menit, validasi bahwa pembelian telah diizinkan.
Gambar 10. Uji pembelian dengan kartu tes lambat yang disetujui.
Menguji kode promo
Anda dapat menggunakan Konsol Google Play untuk membuat kode untuk pengujian Anda sendiri. Perlu diingat bahwa Anda hanya dapat membuat 500 kode promo per kuartal di semua produk terkelola dalam aplikasi.
Anda harus menguji skenario penukaran kode promo berikut:
- Saat kode promosi dimasukkan ke dalam dialog pembelian yang diluncurkan dalam aplikasi Anda.
- Saat kode promosi ditukarkan di aplikasi Google Play Store.
- Saat kode promo ditukarkan di https://play.google.com/store menggunakan tombol Tukarkan di navigasi sebelah kiri.
Dalam skenario ini, Anda harus menguji kode penukaran dengan sebanyak mungkin cara. Lakukan pengujian berikut minimal:
- Penukaran sebelum aplikasi diinstal.
- Penukaran saat aplikasi berjalan di latar depan. Perhatikan bahwa untuk pengujian ini, Anda memerlukan perangkat lain untuk menguji menggunakan aplikasi Google Play Store. Pastikan untuk menguji penukaran dari berbagai layar di aplikasi Anda.
- Penukaran dengan mode multi-aplikasi, tempat aplikasi Anda dan aplikasi Google Play Store ditampilkan secara bersamaan.
Untuk setiap pengujian, pastikan item dapat terdeteksi dengan benar dan pengguna dapat menerima notifikasi.
Menguji pengalaman pembelian di berbagai wilayah
Anda dapat menguji pengalaman pembelian di berbagai wilayah dengan aplikasi Play Billing Lab. Untuk menggunakan Play Billing Lab, Anda harus menjadi penguji lisensi. Gunakan langkah-langkah berikut untuk menguji:
- Daftarkan pengguna penagihan aplikasi sebagai penguji lisensi.
- Login ke aplikasi Play Billing Lab dengan pengguna yang sama.
- Pilih negara yang diperlukan dan terapkan perubahan di Play Billing Lab.
Luncurkan alur pembelian di aplikasi yang sedang diuji.
Gambar 11. Menguji pengalaman pembelian di berbagai wilayah.
Play Billing Lab memungkinkan Anda menguji kelayakan penawaran regional dan pengalaman pengguna di wilayah mana pun, terlepas dari lokasi pengujian secara fisik.
Menguji pengalaman pembelian menggunakan metode pembayaran sungguhan
Anda dapat menguji pengalaman pembelian dengan metode pembayaran sungguhan menggunakan aplikasi Android Play Billing Lab.
Gunakan langkah-langkah berikut untuk menguji metode pembayaran sungguhan:
- Daftarkan pengguna Akun Google sebagai penguji lisensi.
- Login ke aplikasi Play Billing Lab dengan pengguna yang sama.
- Aktifkan metode pembayaran sungguhan di aplikasi Play Billing Lab.
- Mulai ulang dan luncurkan alur pembelian di aplikasi yang sedang diuji.
Batas pembelanjaan untuk aplikasi yang tidak dipublikasikan
Aplikasi yang berada dalam tahap draf atau dipublikasikan ke jalur pengujian internal, tunduk kepada batas pembelanjaan.
Google Play menerapkan batasan pada hal berikut:
- Transaksi harian: Jumlah transaksi yang dapat dilakukan pengguna per hari di semua aplikasi yang tidak dipublikasikan.
- Nilai per pesanan: Jumlah maksimum untuk setiap transaksi.
- Total pembelanjaan harian: Pengeluaran harian kumulatif untuk pengguna di semua aplikasi yang tidak dipublikasikan.
Batas ini direset setiap 24 jam.
Jika pengguna melampaui salah satu batas ini saat menguji aplikasi Anda, mereka akan melihat pesan error di keranjang pembelian, dan transaksi akan diblokir.
Menguji pembelian di luar aplikasi
Anda dapat menggunakan aplikasi Play Billing Lab untuk menguji pengalaman menyeluruh untuk hak yang diperoleh di luar aplikasi. Untuk menggunakan Play Billing Lab, Anda harus menjadi penguji lisensi untuk aplikasi yang Anda uji.
Langkah 1 - Konfigurasi pengujian
- Daftarkan pengguna penagihan aplikasi sebagai penguji lisensi.
- Buka Google Play Store dan login dengan pengguna yang sama.
- Buka aplikasi Play Billing Lab dan login dengan pengguna yang sama.
- Pilih kartu pengujian Pembelian di luar aplikasi.
- Opsional: Pilih negara pengujian dan terapkan perubahan di Play Billing Lab.
- Jika Anda tidak memilih negara, Play Billing Lab akan menggunakan Negara Play untuk akun pengujian berlisensi Anda.
- Masukkan informasi aplikasi dan produk (SKU) yang ingin Anda uji.
- Pilih opsi pembelian, paket dasar, atau penawaran tertentu yang ingin Anda uji.
- Klik Mulai pengujian.
Langkah 2 - Dapatkan produk di luar aplikasi
- Produk unggulan
- Rekomendasi pembelian (setelah membatalkan pembelian)
- Reward Play Game
Langkah 3 - Menangani dan memberikan hak
Aplikasi Anda harus mendeteksi pembelian di luar aplikasi, lalu mengirimkan item kepada pengguna yang bersangkutan. Untuk proses selengkapnya, lihat memproses pembelian.
Produk unggulan
- Buka Google Play Store dan login dengan akun penguji berlisensi yang sama dengan yang Anda gunakan untuk mengonfigurasi pengujian di Play Billing Lab.
- Jika Play Store sebelumnya terbuka, tutup dan mulai ulang.
- Buka halaman detail aplikasi untuk aplikasi Anda.
- Item ditampilkan di halaman ini.
- Pilih item dan selesaikan pembelian.
Rekomendasi pembelian
Setelah keranjang diabaikan:
- Mulai ulang aplikasi Anda.
- Memulai alur pembelian untuk produk sekali beli di aplikasi Anda.
- Menutup atau mengabaikan dialog keranjang pembelian tanpa menyelesaikan transaksi.
- Periksa rekomendasi pembelian keranjang yang ditinggalkan.
- Setujui rekomendasi dan selesaikan pembelian.
Reward Play Games
Klik Berikan Reward untuk menyimulasikan Play yang memberikan reward kepada pengguna. Reward yang ada harus diproses sebelum reward tambahan dapat diberikan.
