Checklist integrasi

Gunakan checklist berikut untuk memastikan Anda telah menyelesaikan semua langkah yang diperlukan dalam integrasi web.

Tentang lingkungan pengujian

Konfigurasi pengujian Google Pay API tidak menampilkan informasi pembayaran langsung dan dikenai biaya, tetapi memungkinkan Anda menguji elemen alur kerja pembelian. Berikut adalah elemen yang dapat diuji:

  • Halaman konfirmasi
  • Tanda Terima
  • Alamat penagihan (opsional)
  • Nomor telepon penagihan (opsional)
  • Alamat pengiriman (opsional)
  • Alamat email (opsional)

Untuk menggunakan lingkungan pengujian dengan contoh respons data pembayaran, lakukan inisialisasi PaymentsClient baru dengan objek JavaScript yang berisi properti lingkungan yang ditetapkan ke TEST.

Berikut adalah contoh kode: 
var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

Menguji dengan konsol developer browser Anda

Uji situs Anda di browser yang didukung versi terbaru. Untuk melakukannya, buka alat developer browser Anda untuk melihat pesan konsol yang terkait dengan situs Anda. Pesan mencakup error atau peringatan dari library klien JavaScript Google Pay API. Google Pay API mendukung Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera, dan UCWeb UC Browser.

Error tambahan mungkin ditampilkan di jendela dialog pemilihan pembayaran Google setelah Anda memanggil loadPaymentData(). Saat Anda mengklik Lanjutkan atau Oke setelah melihat pesan error, pesan tersebut mungkin menampilkan detail tambahan dalam Promise yang ditolak yang ditangani oleh situs Anda.

Menguji di perangkat yang kompatibel

Meskipun Google Pay API tersedia di banyak pasar, kartu yang di-token hanya tersedia di sebagian negara. Jika kartu yang di-token ditetapkan sebagai metode pembayaran yang diizinkan, uji kartu tersebut di perangkat Android dengan Chrome untuk Android versi 59 atau yang lebih baru dan layanan Google Play versi 16.0.0 atau yang lebih baru. Jika metode pembayaran Anda didukung di negara Anda dan oleh bank penerbit Anda, lakukan pengujian dengan kartu yang disimpan di aplikasi Google Pay.

Untuk melihat error dan peringatan konsol Chrome untuk Android, lakukan pengujian dengan pen-debugan jarak jauh dari Chrome untuk Desktop. Untuk mengetahui informasi selengkapnya tentang kemungkinan kesalahan, lihat log dari perangkat Android Anda. Anda mungkin dapat melihat log error dengan jendela alat Logcat di Android Studio, dengan alat command line adb logcat, atau di dalam laporan bug Android. Untuk melihat pesan error terkait Google Pay API, telusuri WalletMerchantError.

Berikut adalah contoh kode:

adb logcat -s WalletMerchantError

Menguji integrasi Anda

Sebelum mengirimkan integrasi Anda ke Google untuk divalidasi dengan PaymentsClient yang dikonfigurasi untuk lingkungan TEST, pastikan Anda telah memenuhi kriteria keluar untuk setiap pemeriksaan fungsional dan branding berikut.

1. Dasar-dasar
Pastikan pemeriksaan dan kontrol risiko yang ada untuk transaksi kartu atau PAN juga diterapkan pada transaksi Google Pay. Validasi dan pemeriksaan penipuan Google Pay tidak dimaksudkan untuk menggantikan proses pengelolaan risiko Anda.
Jika Anda secara selektif memicu 3D Secure (autentikasi tambahan) untuk transaksi kartu normal berdasarkan kriteria risiko, pastikan untuk menggunakan kriteria risiko yang sama untuk memicu 3D Secure untuk transaksi PAN_ONLY PAN Google Pay.
Pastikan Anda telah membaca, dan siap menyetujui, Persyaratan Layanan kami. Pendaftaran dengan Google Pay API mensyaratkan bahwa alamat email Anda harus dikaitkan dengan Akun Google, dan sebaiknya email bisnis yang dikaitkan dengan domain bisnis Anda, seperti "admin@myownpersonaldomain.com". Pilih Gunakan alamat email saya saat ini sebagai gantinya di alur pembuatan Akun Google untuk mengaitkan email Anda dengan Akun Google.
Menggunakan data yang diterima dari Google Pay API hanya untuk memproses transaksi. Semua kasus penggunaan lainnya memerlukan izin terpisah dan eksplisit dari pengguna.
Konfirmasi jaringan kartu dan metode autentikasi kartu yang diterima oleh pemroses pembayaran Anda di negara Anda.
Jika Anda menyelesaikan integrasi DIRECT tokenizationSpecification type, Anda harus mengganti kunci enkripsi publik Anda setiap tahun dan memberikan Pernyataan PCI kepada Google menggunakan Konsol Google Pay & Wallet. Pengesahan PCI dapat dikirimkan oleh pihak ketiga atau Qualified Security Assessor yang disertifikasi oleh PCI Security Standards Council, dan disetujui oleh Vendor yang Disetujui atau Qualified Assessor.

2. Pengujian merek
Gunakan aset kami yang disetujui dan patuhi semua elemen Pedoman merek kami.
Pastikan tombol pembayaran Google Pay hanya muncul setelah situs Anda mengonfirmasi kemampuan pengguna untuk membayar melalui fungsi isReadyToPay().
Konfirmasi bahwa dimensi tombol pembayaran Google Pay yang ditampilkan cocok dengan tombol dan elemen serupa di halaman.
Pilih tombol yang sesuai berdasarkan warna latar belakang area tempat tombol tersebut muncul.

3. Pengujian fungsional
Verifikasi bahwa loadPaymentData() dipanggil secara sinkron saat Anda mengklik tombol pembayaran Google Pay, dan bahwa tombol tersebut mempertahankan perilaku aktivasi pengguna browser yang memungkinkan Google Pay API menampilkan halaman pembayaran. Validasi bahwa lembar pembayaran Google Pay tidak diblokir oleh pemblokir pop-up.

Saat Anda meminta jenis metode pembayaran CARD dengan autentikasi kartu PAN_ONLY, selesaikan langkah-langkah berikut untuk melakukan pengujian kartu tersimpan:

  1. Jika berlaku, hapus semua kartu yang tersimpan dari pay.google.com.
  2. Kembali ke integrasi Anda.
  3. Klik Google Pay.
  4. Pastikan Anda melihat opsi untuk menambahkan kartu.
  5. Tambahkan kartu dari jaringan yang didukung, sebagaimana ditentukan dalam parameters.allowedCardNetworks.
  6. Validasi bahwa Anda melihat kartu yang ditambahkan dengan logo jaringan di pemilih.

Pengujian berikut hanya berlaku untuk Chrome di Android.

Saat Anda meminta jenis metode pembayaran CARD dengan autentikasi kartu CRYPTOGRAM_3DS, selesaikan langkah-langkah berikut untuk melakukan pengujian token perangkat Android:

  1. Pastikan penerbit kartu Anda didukung, dan tambahkan kartu yang memenuhi syarat di aplikasi Android Google Pay.
  2. Kembali ke integrasi Anda.
  3. Klik tombol pembayaran Google Pay.
  4. Pastikan Anda melihat kartu yang ditambahkan, dengan gambar kartu, di pemilih.

Jika Anda mengonfirmasi bahwa prosesor Anda mendukung autentikasi kartu 3D-Secure, Anda dapat melanjutkan, meskipun token perangkat Android tidak tersedia untuk Anda sebagai pengguna Android atau pemegang kartu.

Jika Anda memerlukan alamat pengiriman, uji pemrosesan alamat pengiriman dalam berbagai status penyelesaian, seperti berikut:

  • Variasi nama lengkap yang akan diuraikan ke dalam kolom terstruktur, seperti "John", "John Doe", dan "Jane Doe Smith".
  • Mengurai semua baris alamat yang ditampilkan oleh Google Pay API secara akurat, yang mungkin melebihi jumlah total baris alamat yang biasanya dikumpulkan dalam alur checkout standar Anda.
  • Pastikan komponen negara yang ditampilkan dari alamat cocok dengan tujuan pengiriman yang didukung di situs Anda. Jika Anda menentukan batasan pengiriman, uji batasan tersebut: masukkan alamat pengiriman yang tidak didukung dan tidak diizinkan di halaman pembayaran kami, lalu lihat apakah batasan tersebut berfungsi.

Jika Anda telah menerapkan dukungan untuk Authorize Payments, verifikasi hal berikut:

  • Jika autentikasi pembayaran gagal, fungsi ini akan menampilkan ERROR transactionState dan PaymentDataError dengan intent PAYMENT_AUTHORIZATION.

Jika Anda telah menerapkan dukungan untuk Pembaruan Harga Dinamis, selesaikan langkah-langkah berikut:

  1. Menambahkan kartu dan detail alamat di lembar pembayaran.
  2. Perbarui opsi pengiriman, daftar pesanan, dan total harga.
    3. Penting: Pastikan total harga sama dengan jumlah transaksi. Jika tidak, hal ini dapat memengaruhi nilai Indikator E-Commerce (ECI) dan pihak yang bertanggung jawab.
  3. Tambahkan dan pilih alamat pengiriman.
  4. Perbarui opsi pengiriman, daftar pesanan, dan total harga.
  5. Pilih opsi pengiriman.
  6. Perbarui daftar pesanan dan total harga.
  7. Validasi hasil Anda:
    • Jika alamat pengiriman tidak memiliki opsi pengiriman yang tersedia, pastikan Anda mendapatkan PaymentDataError dengan maksud SHIPPING_ADDRESS.
    • Jika opsi pengiriman yang dipilih tidak valid, validasi bahwa Anda mendapatkan PaymentDataError dengan maksud SHIPPING_OPTION.
    • Jika autentikasi pembayaran gagal, pastikan Anda mendapatkan ERROR transactionState dan PaymentDataError dengan maksud PAYMENT_AUTHORIZATION.
Jika Anda memerlukan nomor telepon, minta dari alamat penagihan. Kemudian, uji apakah Anda dapat mengurai dan menyimpan nomor telepon ke standar data situs Anda dengan berbagai format seperti "+8005550100", "18005550100", dan "(800) 555-0100".
Pastikan Google Pay ditampilkan dengan paritas yang sama dengan metode pembayaran pihak ketiga lainnya.
Untuk pengguna yang sebelumnya memilih Google Pay saat checkout dan menunjukkan Google Pay sebagai metode pembayaran pilihan mereka di situs Anda, Google Pay harus ditetapkan sebagai metode pembayaran default untuk pembelian berikutnya.
Harga akhir harus ditampilkan kepada pengguna sebelum transaksi diproses. Jika jumlah yang akan ditagih bervariasi berdasarkan data yang diterima dari Google Pay API, Anda diharapkan menampilkan halaman konfirmasi dengan harga akhir.