Referensi klien

Dokumentasi com.google.android.gms.wallet berisi dokumentasi lengkap untuk library di beberapa versi Google Pay API. Berikut adalah ringkasan objek dan metode yang paling berlaku untuk versi terbaru Google Pay API: versi 2.0

Wallet

Buat PaymentsClient untuk lingkungan pengujian atau produksi.

Contoh

mPaymentsClient = Wallet.getPaymentsClient(
  this,
  new Wallet.WalletOptions.Builder()
      .setEnvironment(WalletConstants.ENVIRONMENT_TEST)
      .build()
);

PaymentsClient

Klien untuk berinteraksi dengan Google Pay API.

isReadyToPay(IsReadyToPayRequest)

Gunakan metode isReadyToPay(IsReadyToPayRequest) untuk menentukan kemampuan pengguna dalam menampilkan bentuk pembayaran dari Google Pay API.

Jika perangkat mendukung Google Pay, dan pengguna telah menyimpan metode pembayaran atau dapat menambahkannya, IsReadyToPay akan menampilkan true. Untuk menentukan apakah pengguna telah menyimpan metode pembayaran di Google Pay, tetapkan IsReadyToPayRequest.existingPaymentMethodRequired ke true.

loadPaymentData(PaymentDataRequest)

Menampilkan sheet pembayaran Google Pay yang memungkinkan pemilihan metode pembayaran dan parameter yang dikonfigurasi secara opsional.

IsReadyToPayRequest

Buat objek Java IsReadyToPayRequest yang cocok untuk digunakan dengan PaymentsClient.isReadyToPay().

fromJson(java.lang.String)

Buat objek Java IsReadyToPayRequest dari string berformat JSON. Lihat referensi objek IsReadyToPayRequest untuk mengetahui struktur yang diharapkan dari string berformat JSON yang disediakan.

PaymentDataRequest

Buat objek Java PaymentDataRequest yang cocok untuk digunakan dengan PaymentsClient.loadPaymentData.

fromJson(java.lang.String)

Buat objek Java PaymentDataRequest dari string berformat JSON. Lihat referensi objek PaymentDataRequest untuk mengetahui struktur yang diharapkan dari string berformat JSON yang disediakan.

PaymentData

Tangani respons berformat JSON Google Pay API untuk digunakan di aplikasi Anda.

toJson()

Output respons Google Pay API sebagai string berformat JSON. Lihat referensi objek PaymentData untuk mengetahui informasi selengkapnya tentang struktur objek JSON.

PayButton

public void initialize(ButtonOption buttonOptions)

Metode praktis ini digunakan untuk menginisialisasi tombol pembayaran Google Pay yang ditata dengan branding Google Pay terbaru.

Argumen

Nama Deskripsi
buttonOptions Objek yang mengonfigurasi tombol pembayaran Google Pay. Lihat ButtonOptions untuk mengetahui properti yang dapat dikonfigurasi.

Contoh: Menginisialisasi tombol pembayaran dengan konfigurasi kustom:

PayButton googlePayPaymentButton = layoutBinding.googlePayPaymentButton;
JSONArray paymentMethods = new JSONArray().put(getBaseCardPaymentMethod());
googlePayPaymentButton.initialize(
       ButtonOptions.newBuilder()
               .setButtonTheme(ButtonConstants.ButtonTheme.DARK)
               .setButtonType(ButtonConstants.ButtonType.BUY)
               .setCornerRadius(100)
               .setAllowedPaymentMethods(paymentMethods.toString())
               .build()
);

public void setVisibility(View view)

Metode praktis ini menetapkan visibilitas tombol pembayaran.

Argumen

Nama Deskripsi
View

View.VISIBLE menetapkan tombol pembayaran agar terlihat (default).

View.GONE menyembunyikan tombol dari pengguna.

Contoh:

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

Metode dipanggil saat pengguna mengklik tombol pembayaran Google Pay.

Argumen

Nama Deskripsi
listener Callback pemroses peristiwa yang akan dipanggil saat peristiwa klik dikirimkan ke tombol pembayaran Google Pay button.

BasePaymentDataCallbacksService

Class layanan dasar yang menghosting callback data pembayaran yang dimulai oleh layanan Google Play dalam alur PaymentsClient.loadPaymentData(PaymentDataRequest).

Perluas layanan ini di aplikasi Anda dan deklarasikan di AndroidManifest.xml dengan izin com.google.android.gms.permission.BIND_PAYMENTS_CALLBACK_SERVICE dan filter intent untuk com.google.android.gms.wallet.callback.PAYMENT_DATA_CALLBACKS.

createPaymentDataCallbacks()

Menampilkan implementasi BasePaymentDataCallbacks untuk menangani peristiwa callback masuk. Dipanggil sekali per peristiwa callback.

BasePaymentDataCallbacks

Class dasar abstrak yang berisi pengendali callback data pembayaran yang diimplementasikan oleh penjual untuk mendukung Update Harga Dinamis dan Otorisasi Pembayaran.

onPaymentDataChanged(intermediatePaymentData, onCompleteListener)

Metode ini menangani perubahan data pembayaran di sheet pembayaran seperti alamat pengiriman dan opsi pengiriman.

Argumen

Nama Jenis Deskripsi
intermediatePaymentData IntermediatePaymentData Objek yang berisi alamat dan opsi pengiriman yang dipilih di sheet pembayaran. Untuk mengetahui detailnya, lihat IntermediatePaymentData.
onCompleteListener OnCompleteListener<PaymentDataRequestUpdate> Pemroses untuk menyelesaikan dengan informasi transaksi, opsi pengiriman, dan error data pembayaran yang diperbarui. Teruskan instance PaymentDataRequestUpdate ke complete().

Contoh

override fun onPaymentDataChanged(
    intermediatePaymentData: IntermediatePaymentData,
    onCompleteListener: OnCompleteListener<PaymentDataRequestUpdate>
) {
    val paymentDataRequestUpdateJson = handlePaymentDataChanged(intermediatePaymentData.toJson())
    val update = PaymentDataRequestUpdate.fromJson(paymentDataRequestUpdateJson.toString())
    onCompleteListener.complete(update)
}

onPaymentAuthorized(paymentData, onCompleteListener)

Metode ini dipanggil saat pembayaran diotorisasi di sheet pembayaran.

Argumen

Nama Jenis Deskripsi
paymentData PaymentData Objek yang berisi data pembeli yang diminta. Untuk mengetahui detailnya, lihat PaymentData.
onCompleteListener OnCompleteListener<PaymentAuthorizationResult> Pemroses untuk menyelesaikan dengan hasil otorisasi. Teruskan PaymentAuthorizationResult instance ke complete().

Contoh

override fun onPaymentAuthorized(
    paymentData: PaymentData,
    onCompleteListener: OnCompleteListener<PaymentAuthorizationResult>
) {
    val paymentAuthorizationResultJson = handlePaymentAuthorized(paymentData.toJson())
    val result = PaymentAuthorizationResult.fromJson(paymentAuthorizationResultJson.toString())
    onCompleteListener.complete(result)
}

IntermediatePaymentData

Tangani data callback perantara yang diteruskan ke BasePaymentDataCallbacks.onPaymentDataChanged.

toJson()

Menampilkan data permintaan callback sebagai string berformat JSON. Lihat referensi objek IntermediatePaymentData untuk mengetahui informasi selengkapnya tentang struktur objek JSON.

getLastSavedState()

Menampilkan Bundle yang berisi status yang disimpan selama iterasi callback sebelumnya.

PaymentDataRequestUpdate

Buat objek Java PaymentDataRequestUpdate untuk ditampilkan di BasePaymentDataCallbacks.onPaymentDataChanged.

fromJson(java.lang.String)

Buat objek Java PaymentDataRequestUpdate dari string berformat JSON. Lihat referensi objek PaymentDataRequestUpdate untuk mengetahui struktur yang diharapkan dari string berformat JSON yang disediakan.

withUpdatedSavedState(Bundle)

Melampirkan Bundle status yang diperbarui untuk dipertahankan di antara pemanggilan callback.

PaymentAuthorizationResult

Buat objek Java PaymentAuthorizationResult untuk ditampilkan di BasePaymentDataCallbacks.onPaymentAuthorized.

fromJson(java.lang.String)

Buat objek Java PaymentAuthorizationResult dari string berformat JSON. Lihat referensi objek respons PaymentAuthorizationResult untuk mengetahui struktur yang diharapkan dari string berformat JSON yang disediakan.