Ringkasan Penagihan dalam Aplikasi

Dokumen ini menjelaskan komponen dan fitur Penagihan dalam Aplikasi dasar yang Anda perlukan untuk menambahkan fitur Penagihan dalam Aplikasi ke aplikasi Anda.

Catatan: Pastikan Anda mematuhi hukum yang berlaku di negara Anda saat mendistribusikan aplikasi. Misalnya, di negara-negara Uni Eropa, hukum yang berlandaskan Unfair Commercial Practices Directive melarang ajakan langsung kepada anak-anak untuk membeli produk yang diiklankan atau untuk membujuk orang tuanya atau orang dewasa lain untuk membeli produk yang diiklankan untuk anak-anak. Lihat posisi otoritas perlindungan konsumen Uni Eropa untuk informasi selengkapnya mengenai ini dan topik lainnya.

In-app Billing API

Aplikasi Anda mengakses layanan Penagihan dalam Aplikasi menggunakan API yang diekspos oleh aplikasi Google Play yang dipasang pada perangkat. Aplikasi Google Play kemudian menyampaikan permintaan dan respons penagihan antara aplikasi Anda dengan server Google Play. Pada praktiknya, aplikasi Anda tidak pernah langsung berkomunikasi dengan server Google Play. Sebagai gantinya, aplikasi Anda mengirimkan permintaan penagihan ke aplikasi Google Play melalui komunikasi antar proses (IPC) dan menerima respons dari aplikasi Google Play. Aplikasi Anda tidak mengelola koneksi jaringan apa pun antara aplikasi itu sendiri dengan server Google Play.

Anda bisa mengimplementasikan Penagihan dalam Aplikasi hanya di aplikasi yang Anda terbitkan melalui Google Play. Untuk menyelesaikan permintaan pembelian dalam aplikasi, aplikasi Google Play harus bisa mengakses server Google Play melalui jaringan.

Penagihan dalam Aplikasi Versi 3 adalah versi terbaru, dan memelihara kompatibilitas yang luas dengan berbagai perangkat Android. In-app Billing Version 3 didukung di perangkat yang menjalankan Android 2.2 (API level 8) atau lebih tinggi yang di dalamnya terpasang versi terbaru aplikasi Google Play (mayoritas paling banyak perangkat yang aktif).

Fitur versi 3

Penagihan dalam Aplikasi Versi 3 menyediakan fitur berikut:

  • Aplikasi Anda mengirimkan permintaan melalui API ringkas yang mengizinkan pengguna untuk meminta detail produk secara mudah dari Google Play dan memesan produk dalam aplikasi. API dengan cepat memulihkan produk berdasarkan kepemilikan pengguna.
  • API secara sinkron menyebarkan informasi pesanan ke perangkat setelah pembelian selesai.
  • Semua pembelian adalah terkelola (artinya, Google Play melacak kepemilikan pengguna atas produk dalam aplikasi). Pengguna tidak bisa memiliki beberapa salinan produk dalam aplikasi; hanya satu salinan yang bisa dimiliki pada waktu tertentu.
  • Produk yang dibeli bisa dikonsumsi. Saat dikonsumsi, produk kembali ke status tidak dimiliki dan bisa dibeli lagi dari Google Play.
  • API menyediakan dukungan untuk langganan.

Untuk detail tentang versi Penagihan dalam Aplikasi, lihat Catatan Versi.

Produk Dalam Aplikasi

Produk dalam Aplikasi adalah produk digital yang Anda tawarkan untuk dibeli oleh pengguna dari dalam aplikasi Anda. Contoh produk digital adalah mata uang dalam game, pembaruan fitur aplikasi yang meningkatkan pengalaman pengguna, dan materi baru untuk aplikasi Anda.

Anda bisa menggunakan Penagihan dalam Aplikasi hanya untuk menjual konten digital. Anda tidak bisa menggunakan Penagihan dalam Aplikasi untuk menjual produk fisik, layanan pribadi, atau apa pun yang membutuhkan penyerahan fisik. Tidak seperti aplikasi yang diberi harga, tidak ada jendela pengembalian dana setelah pengguna telah membeli produk dalam aplikasi.

Google Play tidak menyediakan bentuk penyerahan materi apa pun. Anda bertanggung jawab menyerahkan konten digital yang Anda jual di aplikasi. Produk dalam Aplikasi selalu dikaitkan secara eksplisit hanya dengan satu aplikasi. Yaitu, satu aplikasi tidak bisa membeli produk dalam aplikasi yang diterbitkan untuk aplikasi lain, meskipun berasal dari developer yang sama.

Jenis produk

Penagihan dalam Aplikasi mendukung jenis produk yang berbeda untuk memberikan Anda fleksibilitas dalam memonetisasi aplikasi Anda. Dalam semua kasus, Anda harus menentukan produk Anda menggunakan Google Play Developer Console.

Anda bisa menentukan dua jenis produk untuk aplikasi Penagihan dalam Aplikasi: langganan dan produk dalam aplikasi terkelola. Google Play menangani dan melacak kepemilikan produk dalam aplikasi dan langganan untuk aplikasi Anda dengan dasar per pengguna. Pelajari selengkapnya tentang jenis produk yang didukung oleh Penagihan dalam Aplikasi Versi 3.

Google Play Developer Console

Developer Console adalah tempat Anda untuk menerbitkan aplikasi Penagihan dalam Aplikasi Anda dan mengelola berbagai produk dalam aplikasi yang tersedia untuk dibeli dari aplikasi Anda.

Anda bisa membuat daftar produk yang berisi produk digital yang dikaitkan dengan aplikasi Anda, termasuk produk untuk sekali beli dan langganan berulang. Anda bisa menetapkan informasi untuk setiap produk seperti yang berikut:

  • ID produk unik (juga disebut sebagai SKU).
  • Jenis produk.
  • Harga.
  • Keterangan.
  • Penanganan dan pelacakan pembelian untuk produk tersebut oleh Google Play.

Jika Anda menjual beberapa aplikasi atau produk dalam aplikasi Anda dengan harga yang sama, Anda bisa menambahkan template harga untuk mengelola tingkat harga ini dari lokasi terpusat. Saat menggunakan template harga, Anda bisa menyertakan pajak lokal pada harga yang Anda tetapkan, atau Anda bisa menyediakan harga dan membuat sistem sendiri untuk menambahkan pajak lokal ini ke harga tersebut. Anda bisa membuat perubahan pada harga pada template harga Anda, seperti menyegarkan nilai tukar mata uang untuk negara-negara tertentu, dan perubahan Anda diterapkan pada aplikasi dan produk dalam aplikasi yang Anda tautkan ke template tersebut.

Anda juga bisa membuat akun pengujian untuk mengotorisasi akses untuk menguji aplikasi yang tidak diterbitkan.

Untuk mempelajari cara menggunakan Developer Console untuk mengonfigurasi produk dalam aplikasi dan daftar produk, lihat Administrasi Penagihan dalam Aplikasi.

Alur Pembelian Google Play

Google Play menggunakan layanan checkout backend yang sama seperti yang digunakan untuk pembelian aplikasi, sehingga pengguna Anda merasakan alur pembelian yang konsisten dan sudah dikenal.

Penting: Anda harus memilih akun penjual Google Payments untuk menggunakan layanan Penagihan dalam Aplikasi di Google Play.

Untuk memulai pembelian, aplikasi Anda mengirimkan permintaan penagihan untuk produk dalam aplikasi tertentu. Google Play kemudian menangani semua detail checkout untuk transaksi, termasuk meminta dan memvalidasi bentuk pembayaran dan pemrosesan transaksi finansial.

Saat proses checkout selesai, Google Play mengirimkan detail pembelian ke aplikasi Anda, misalnya nomor pesanan, tanggal dan waktu pesanan, dan harga yang dibayarkan. Aplikasi Anda tidak perlu menangani transaksi finansial apa pun; transaksi finansial ditangani oleh Google Play.

Aplikasi Contoh

Untuk membantu Anda mengintegrasikan Penagihan dalam Aplikasi ke aplikasi Anda, Android SDK menyediakan aplikasi contoh yang memperagakan cara menjual produk dalam aplikasi dan langganan dari dalam aplikasi Anda.

Contoh TrivialDrive for the Version 3 API menampilkan cara menggunakan In-app Billing Version 3 API untuk mengimplementasikan pembelian produk dalam aplikasi dan langganan untuk game menyetir. Aplikasi memperagakan cara mengirimkan permintaan Penagihan dalam Aplikasi dan menangani respons sinkron dari Google Play. Aplikasi juga menampilkan cara merekam konsumsi produk dengan API. Contoh Versi 3 mencakup kelas mudah untuk memproses operasi Penagihan dalam Aplikasi serta melakukan verifikasi tanda tangan secara otomatis.

Saran:: Pastikan untuk menyamarkan kode di aplikasi Anda sebelum menerbitkannya. Untuk informasi selengkapnya, lihat Keamanan dan Desain.

Pertimbangan Migrasi

In-app Billing Version 2 API sudah dihentikan pada Januari 2015. Jika Anda memiliki implementasi Penagihan dalam Aplikasi yang ada yang menggunakan API Versi 2 atau lebih lama, Anda harus bermigrasi ke Penagihan dalam Aplikasi Versi 3.

Setelah migrasi, produk yang terkelola dan tidak terkelola ditangani seperti berikut:

  • Langganan dan produk terkelola yang sebelumnya Anda definisikan di Developer Console bekerja dengan Versi 3, sama seperti sebelumnya.
  • Produk yang tidak terkelola yang telah Anda tetapkan untuk aplikasi yang sudah ada diperlakukan sebagai produk terkelola jika Anda membuat permintaan pembelian untuk produk ini menggunakan Version 3 API. Anda tidak perlu membuat entri produk baru di Developer Console untuk produk ini, dan Anda bisa menggunakan ID produk yang sama untuk mengelola produk-produk ini.