API penagihan alternatif

Developer yang memenuhi syarat dapat menawarkan sistem penagihan alternatif dalam aplikasi kepada pengguna di negara tertentu dan melaporkan transaksi yang dihasilkan ke Google. Bergantung pada tempat Anda mendistribusikan aplikasi dan kelayakan, ada dua versi penagihan alternatif yang dapat dibuat oleh aplikasi:

Panduan ini membahas API yang perlu digunakan untuk kedua penawaran tersebut. Anda harus meninjau halaman program dan mendaftar ke program yang relevan sebelum menggunakan API ini.

Glosarium istilah

Konvensi istilah yang diikuti panduan ini:

  • API penagihan alternatif: API yang digunakan untuk menampilkan layar yang berlaku kepada pengguna dan memungkinkan developer melaporkan transaksi yang diselesaikan di sistem penagihan alternatif developer.
  • Sistem penagihan alternatif: Sistem penagihan alternatif dari developer yang dapat ditawarkan bersama sistem penagihan Google Play atau hanya sistem penagihan itu sendiri (tunduk kepada persyaratan kelayakan).
  • Transaksi eksternal: Transaksi yang terjadi di luar sistem penagihan Google Play.
  • Token transaksi eksternal: Token yang diberikan kepada developer melalui Play Billing Library untuk digunakan oleh developer saat pengguna menyelesaikan sistem penagihan alternatif. Token ini digunakan untuk memberi tahu Google Play tentang pembelian yang berhasil.
  • ID transaksi eksternal: ID unik yang dibuat oleh developer untuk mengidentifikasi transaksi.

Menawarkan penagihan alternatif dengan Pilihan Pengguna

Bagian ini menjelaskan cara menawarkan penagihan alternatif kepada pengguna dengan pilihan untuk menggunakan sistem penagihan Google Play. Sebelum menggunakan API ini, pastikan hal berikut:

Rekomendasi modul integrasi Layanan Penagihan Google Play lainnya sama dengan yang sudah dimiliki developer untuk integrasi mereka saat ini.

Selain itu, sebaiknya siapkan konfigurasi integrasi Google Play Developer API karena integrasi backend akan memanfaatkannya.

Mengonfigurasi di Konsol Play

Developer yang telah menyelesaikan pendaftaran program penagihan alternatif dengan pilihan pengguna terkait dan terintegrasi dengan API penagihan alternatif dapat mengelola setelan penagihan alternatif mereka melalui Konsol Play:

  • Untuk setiap aplikasi yang memenuhi syarat, Anda dapat memilih apakah akan menawarkan sistem penagihan alternatif atau tidak.
  • Upload logo metode pembayaran sesuai dengan pedoman, dengan mengikuti semua spesifikasi pemformatan. Gambar yang tidak sesuai dengan panduan ini tidak akan ditampilkan untuk sistem penagihan alternatif Anda di layar pilihan pengguna. (Catatan: Menyertakan logo metode pembayaran bersifat opsional, meskipun sangat direkomendasikan.)
  • Jika Anda menawarkan langganan, berikan link pengelolaan langganan yang diperlukan.
UI tiruan, yang ditujukan untuk ilustrasi, dapat berubah.

Pengalaman pengguna

API sisi klien mengaktifkan fungsi berikut:

  • Google Play merender dan mengelola informasi yang berlaku dan layar pilihan pengguna.
  • Jika pengguna memilih untuk menggunakan sistem penagihan Google Play, alur penagihan akan terus menggunakan antarmuka standar penagihan Google Play.

Aplikasi developer.

Layar pilihan penagihan.

Contoh hanya untuk ilustrasi.

Layar pilihan pengguna

Layar pilihan pengguna memberi pengguna opsi untuk menggunakan sistem penagihan alternatif developer atau sistem penagihan Google Play.

Anatomi opsi penagihan alternatif

Opsi penagihan alternatif di layar pilihan pengguna mencakup elemen UI berikut:

  1. Ikon aplikasi.
  2. Nama aplikasi.
  3. Aset gambar yang menyertakan metode pembayaran yang ditawarkan oleh developer.
  4. Indikator tambahan (dan elemen UI lainnya bukan bagian dari aset gambar).

Aset gambar untuk metode pembayaran

Aset gambar tunggal terdiri dari beberapa kartu metode pembayaran dan harus mengikuti spesifikasi yang ditentukan dalam panduan ini.

Dimensi

192dp X 20dp

Spasi kartu

8dp

Format file

PNG, latar belakang transparan

Variasi metode pembayaran

Developer dapat memilih jumlah ikon metode pembayaran yang tersedia dan ingin disertakan dalam aset gambar, hingga maksimum 5.

Tidak ada gambar atau teks lain yang harus disertakan dalam gambar.

Spesifikasi kartu

Kartu metode pembayaran yang disertakan dalam aset gambar harus mengikuti pedoman ukuran, spasi, dan gaya berikut.

Dimensi kartu 32dp X 20dp
Padding dalam 3dp
Garis batas 1 dp (goresan dalam disertakan dalam dimensi), Radius 2 dp, #E0E0E0
Latar belakang kartu Warna solid (sebaiknya putih)

Langkah berikutnya

Untuk mulai mengintegrasikan API penagihan alternatif dengan pilihan pengguna, ikuti panduan mendalam untuk integrasi dalam aplikasi dan integrasi backend.

Hanya menawarkan penagihan alternatif

Bagian ini menjelaskan cara menawarkan penagihan alternatif kepada pengguna tanpa pilihan untuk menggunakan sistem penagihan Google Play. Sebelum menggunakan API ini, pastikan hal berikut:

Sebaiknya siapkan konfigurasi integrasi Google Play Developer API karena integrasi backend akan memanfaatkannya.

Mengonfigurasi di Konsol Play

Developer yang telah menyelesaikan pendaftaran dan terintegrasi dengan API penagihan alternatif dapat mengelola setelan penagihan alternatif mereka melalui Konsol Play:

  • Untuk setiap aplikasi yang memenuhi syarat, pilih antara ikut serta atau tidak dalam menawarkan penagihan alternatif saja (tanpa pilihan pengguna) di setiap negara yang tersedia
UI tiruan, yang ditujukan untuk ilustrasi, dapat berubah.

Layar informasi untuk pengguna

Layar informasi membantu pengguna memahami bahwa hanya sistem penagihan alternatif yang ditawarkan dalam aplikasi yang memenuhi syarat. Layar informasi akan ditampilkan kepada pengguna pada awal pembelian pertama mereka di aplikasi Anda setelah penagihan alternatif diaktifkan. Pesan ini tidak akan ditampilkan pada pembelian berikutnya oleh pengguna yang sama di aplikasi Anda pada perangkat yang sama. Perhatikan bahwa mungkin adakalanya dialog ditampilkan lagi kepada pengguna dalam situasi seperti jika pengguna menghapus cache di perangkatnya.

Langkah berikutnya

Untuk mulai mengintegrasikan API penagihan alternatif, ikuti panduan mendalam untuk integrasi dalam aplikasi dan integrasi backend.