Pemecahan masalah

Panduan pemecahan masalah Web mencakup masalah dan pertanyaan terkait topik berikut.

Pendaftaran dan akses

Anda mungkin mengalami error berikut di beberapa titik dalam integrasi Anda. Daftar ini memberikan beberapa saran pemecahan masalah yang berguna jika terjadi error ini.

Penjual ini tidak mengaktifkan Google Pay
Google Pay API memerlukan merchantId Google untuk situs yang mengonfigurasi PaymentsClient untuk lingkungan PRODUCTION. merchantId Google dikaitkan dengan satu atau beberapa domain yang sepenuhnya memenuhi syarat melalui Konsol Google Pay & Wallet. Periksa detail error yang ditampilkan untuk mengetahui informasi selengkapnya.
Penjual ini belum menyelesaikan pendaftaran untuk menggunakan Google Pay API. Buka konsol (https://pay.google.com/business/console) untuk memverifikasi.
Anda belum menyelesaikan proses pendaftaran situs untuk Google Pay API. Tinjau Minta akses produksi untuk mendaftar menggunakan Konsol Google Pay & Wallet dan minta peninjauan penggunaan Google Pay API di situs Anda.
Profil penjual ini tidak memiliki akses ke fitur ini
Google belum mengonfigurasi situs Anda untuk menggunakan Google Pay API. Tinjau Minta akses produksi untuk meminta peninjauan penggunaan Google Pay API di situs Anda melalui Konsol Google Pay & Wallet.
Integrasi Google Pay API ini dinonaktifkan. Hubungi kami untuk mengetahui informasi selengkapnya (https://developers.google.com/pay/api/faq#how-to-get-support).
Hubungi kami untuk mempelajari lebih lanjut langkah-langkah yang diperlukan untuk mengaktifkan kembali Google Pay API untuk Akun Google Anda.
Domain Anda "example.com" tidak terdaftar untuk menggunakan API ini
Domain tempat checkout Anda dihosting tidak terkait dengan merchantId yang Anda gunakan. Pastikan parameter merchantId sudah benar dan domain Anda terdaftar melalui Konsol Google Pay & Wallet.
Google Pay API harus dipanggil dalam konteks yang aman.
Google Pay API hanya dapat digunakan di situs dalam konteks yang aman. Untuk mengetahui informasi selengkapnya, lihat Konteks aman.
Tidak ada kunci yang ditemukan untuk profil penjual ini
Anda harus mendaftarkan kunci enkripsi publik Anda ke Google melalui Konsol Google Pay & Wallet untuk menyelesaikan integrasi DIRECTtokenizationSpecification type.

merchantId

Anda mungkin mengalami error berikut terkait merchantId di beberapa titik dalam integrasi Anda. Daftar ini memberikan beberapa saran pemecahan masalah yang berguna jika error ini muncul.

merchantId harus ditetapkan.
Parameter merchantId di dalam PaymentDataRequest harus disetel ke nilai yang diberikan menggunakan Konsol Google Pay & Wallet. Parameter merchantId hanya diperlukan saat Anda menggunakan PaymentsClient yang dikonfigurasi untuk lingkungan PRODUCTION. Tinjau Daftar periksa integrasi kami untuk meminta peninjauan penggunaan Google Pay API di situs Anda dan untuk mendapatkan merchantId.
merchantId bukan string
Parameter merchantId di dalam PaymentDataRequest harus selalu berupa string. Pastikan jenis parameter merchantId yang Anda gunakan adalah string sebelum Anda memanggil API.
merchantId tidak terdaftar.
Parameter merchantId di dalam PaymentDataRequest harus disediakan melalui Konsol Google Pay & Wallet. Tinjau Meminta akses produksi untuk mengetahui informasi selengkapnya.

Validitas gateway

Anda mungkin mengalami error berikut terkait validitas gateway di beberapa titik dalam integrasi. Daftar ini memberikan beberapa saran pemecahan masalah yang berguna jika error ini muncul.

Gateway tidak dikenal 'yourgateway'
Parameter gateway yang Anda tentukan di paymentMethodTokenizationParameters.parameters saat ini tidak didukung oleh Google. Hubungi gateway Anda untuk mengetahui informasi selengkapnya tentang ID gateway dan kolom terkaitnya, seperti gatewayMerchantId.
Gateway 'example' tidak dapat digunakan dalam mode produksi
Nilai parameter gateway contoh hanya digunakan untuk tujuan pengujian dan tidak dapat digunakan dengan PaymentsClient yang dikonfigurasi untuk lingkungan PRODUCTION. Hubungi gateway Anda untuk mengetahui informasi selengkapnya tentang nilai parameter PaymentMethodTokenizationSpecification yang perlu Anda tetapkan untuk digunakan dengan Google Pay API.

Validitas objek

Anda mungkin mengalami error berikut terkait validitas objek di beberapa titik dalam integrasi Anda. Daftar ini memberikan beberapa saran pemecahan masalah yang berguna jika error ini muncul.

PaymentDataRequest Google Pay bukan json yang valid
Parameter yang diberikan ke loadPaymentData harus selalu berupa objek PaymentDataRequest yang valid.
transactionInfo harus ditetapkan.
Parameter transactionInfo di dalam PaymentDataRequest harus selalu berupa objek TransactionInfo yang valid.

Penjual langsung

Anda mungkin mengalami error berikut terkait penjual langsung di beberapa titik dalam integrasi Anda. Daftar ini memberikan beberapa saran pemecahan masalah yang berguna jika error ini terjadi.

Verifikasi tanda tangan
Anda mungkin mengalami error verifikasi tanda tangan jika merchantId salah. Hal ini dapat terjadi di lingkungan TEST saat Anda menggunakan library paymentmethodtoken Tink. Untuk menghindari masalah ini, tetapkan YOUR_MERCHANT_ID ke 12345678901234567890 di:
.recipientId("merchant:YOUR_MERCHANT_ID")
Tidak dapat mendekripsi token
Jika Anda menggunakan library paymentmethodtoken Tink untuk mendekripsi token, perhatikan hal berikut:
  • Pastikan lingkungan respons Google Pay API sesuai dengan lingkungan paymentmethodtoken Tink. Untuk detail selengkapnya, lihat contoh berikut:
    • Jika respons Google Pay API ditampilkan oleh lingkungan TEST, maka Tink menunjuk ke lingkungan pengujian untuk dekripsi.
  • Jangan ubah respons dari Google Pay API sebelum diteruskan ke Tink. Pastikan Anda meneruskan seluruh token yang ditampilkan dari respons Google Pay API. Untuk mengetahui detail selengkapnya, lihat catatan berikut:
  • Pastikan Anda memiliki kunci pribadi yang tepat yang terkait dengan kunci publik yang Anda daftarkan di Google.
Membuat pasangan kunci publik dan pribadi di Windows
Jika Anda menggunakan Windows, dan ingin mengikuti langkah-langkah yang disebutkan di Menggunakan OpenSSL untuk membuat pasangan kunci pribadi dan publik, pastikan Anda menginstal Cygwin di komputer Anda. Hal ini diperlukan untuk menjalankan perintah Linux.

Objek error

Objek error adalah objek yang ditampilkan oleh promise yang ditolak dari metode JavaScript klien.

PaymentsError
Objek ini berisi detail tentang error yang ditampilkan oleh metode JavaScript klien. Error mungkin tidak ditampilkan dalam dialog yang ditampilkan kepada pengguna.
Properti Jenis Deskripsi
statusCode String Kode singkat yang menjelaskan jenis error.
statusMessage String Pesan yang ditampilkan kepada developer yang menjelaskan error yang terjadi dan kemungkinan langkah-langkah untuk memperbaikinya.
Error umum
Objek ini menampilkan error yang mungkin Anda temui di semua metode JavaScript. Pastikan untuk memeriksa konsol developer untuk melihat pesan error tambahan.
Kode Status Deskripsi
BUYER_ACCOUNT_ERROR Pengguna Google saat ini tidak dapat memberikan informasi pembayaran.
DEVELOPER_ERROR

Parameter yang diteruskan tidak diformat dengan benar. Pesan error mungkin muncul di konsol browser untuk semua lingkungan yang dikonfigurasi.
MERCHANT_ACCOUNT_ERROR

Situs yang mengakses Google Pay API tidak memiliki izin yang tepat. Hal ini dapat disebabkan oleh konfigurasi yang salah atau ID penjual yang salah yang ditetapkan dalam permintaan. Untuk mengetahui detail selengkapnya, periksa kolom statusMessage. Jika Anda masih mengalami masalah, hubungi dukungan.
INTERNAL_ERROR Error server umum.

CardInfo

Apa yang dimaksud dengan fitur CardInfo?
Google Pay menunjukkan kepada konsumen bahwa ada kartu di balik tombol pembayaran Google Pay, yang merender jaringan merek kartu dan empat digit terakhir kartu.
Mengapa fitur CardInfo tidak dirender dalam penerapan saya?

Agar fitur CardInfo berfungsi, kami memerlukan kondisi berikut:

Mengapa tombol pembayaran Google Pay dimuat tanpa batas waktu?
Jangan hapus pemroses peristiwa onLoad. Jika Anda menghapus pemroses peristiwa onLoad, tombol pembayaran Google Pay dapat dimuat tanpa batas.
Mengapa tidak ada perintah pembayaran setelah saya mengklik tombol pembayaran Google Pay?
Tetapkan callback pemroses peristiwa ke peristiwa ButtonOptions.onClick.

OR_BIBED_15 error

Anda mungkin mengalami error OR_BIBED_15 di beberapa titik dalam integrasi Anda. Daftar ini memberikan beberapa saran pemecahan masalah yang berguna jika error ini muncul.

Menggunakan WebView
Ikuti panduan untuk Android dan iOS untuk memastikan integrasi Anda kompatibel dengan WebView.
Header respons HTTP Cross-Origin-Opener-Policy
Jika header respons HTTP Cross-Origin-Opener-Policy disetel ke same-origin, hal ini dapat mencegah browser membuka pop-up yang diperlukan agar pengguna dapat menyelesaikan transaksi. Coba ubah nilai header menjadi same-origin-allow-popups untuk mengurangi masalah tersebut.
Penundaan antara peristiwa klik pengguna dan panggilan ke loadPaymentData()
Jika ada penundaan setelah mengklik tombol Google Pay (atau tombol checkout serupa) dan sebelum panggilan loadPaymentData() (contoh: setTimeout(), panggilan jaringan tambahan, atau logika yang berjalan lama serupa), hal ini dapat menyebabkan mekanisme pemblokiran pop-up browser dipicu. Sebaiknya tidak ada jeda antara klik pengguna dan panggilan loadPaymentData().