Mengaktifkan pembayaran

Sebagai bagian dari integrasi Pesan dengan Google secara menyeluruh, Anda dapat mengikutsertakan penjual untuk menerima pembayaran dari pengguna saat mereka membuat pemesanan, janji temu, atau reservasi. Google bekerja sama dengan pemroses pembayaran untuk menyiapkan tokenisasi. Pemroses pembayaran selanjutnya menggunakan token unik untuk membayar penjual secara aman.

Untuk pemesanan yang aman untuk pembayaran, kami merender modul Info Pembayaran dalam alur checkout. Hal ini memungkinkan pengguna memasukkan informasi kartu kreditnya.

Dukungan untuk 3DS1 dan 3DS2 tersedia, lihat tutorial ini tentang implementasinya.

Kelayakan

Agar penjual dapat menerima pembayaran melalui Pesan dengan Google, Anda harus memenuhi persyaratan berikut:

  1. Gunakan pemroses pembayaran yang didukung. Daftar terbaru pemroses yang didukung dapat ditemukan di situs Google Pay.
  2. Terima pembayaran token sesuai dengan pemroses Anda.
  3. Pembayaran tidak dapat diaktifkan untuk pemesanan yang memerlukan konfirmasi asinkron .

Perubahan pada feed dan server pemesanan untuk pembayaran

Pembayaran dilakukan melalui proses keikutsertaan di tingkat penjual. Anda harus mengaktifkan pembayaran untuk setiap penjual yang perlu menerima pembayaran untuk setiap layanan mereka. Untuk mengaktifkan pembayaran, perubahan harus dilakukan pada feed dan server pemesanan.

Feed

  • Feed Penjual: Tentukan informasi pembayaran melalui tokenization_parameter yang ditetapkan di kolom tokenization_config. Kumpulan ini bergantung pada pemroses pembayaran yang dipilih. Set ini adalah kumpulan paymentMethodTokenizationParameters.parameters yang sama yang akan diteruskan ke Google Pay jika Anda berintegrasi dengannya.
  • Feed Layanan/Ketersediaan: Tentukan persyaratan pembayaran berdasarkan kasus penggunaan yang sesuai. Untuk mengetahui detail selengkapnya, lihat Kasus penggunaan untuk pembayaran.

Server Pemesanan

Kasus penggunaan untuk pembayaran

Saat memutuskan apakah akan menerima pembayaran untuk setiap kasus penggunaan ini atau tidak, tinjau Kebijakan Pembayaran kami dan pastikan bahwa Anda dapat mematuhi semua kebijakan yang relevan.

Terdapat kasus penggunaan untuk pembayaran:

Untuk mengetahui informasi lebih lanjut tentang cara mengimplementasikan setiap kasus penggunaan ini, lihat tutorial tentang Mengonfigurasi Pembayaran.

Menyelesaikan pemesanan dengan pembayaran di muka

Gambar 1 menunjukkan alur aktivitas di antara pengguna, Anda (partner penjadwalan), Google, dan pemroses pembayaran.

Gambar 1: Diagram urutan pemesanan prabayar
Gambar 1: Diagram urutan pemesanan prabayar
  • Pembayaran harus sebesar 100% dari jumlah biaya layanan. Dengan kata lain, layanan harus dibayar penuh pada saat pemesanan.
Perubahan pada feed layanan

Deposit dan denda ketidakhadiran

Deposit dan denda ketidakhadiran disiapkan dengan cara serupa. Gambar 2 menunjukkan alur aktivitas ini di antara pengguna, Anda (partner penjadwalan), Google, dan pemroses pembayaran.

Gambar 2: Diagram urutan pemesanan deposit atau ketidakhadiran
Gambar 2: Diagram urutan pemesanan deposit atau ketidakhadiran

Deposit dan biaya ketidakhadiran dapat digunakan untuk memastikan pengguna datang ke layanan yang mereka pesan.

  • Deposit dapat ditagihkan ke kartu kredit pengguna di muka atau di lain waktu.
  • Biaya ketidakhadiran dapat ditagihkan kepada pengguna jika mereka tidak hadir dalam pemesanan.
  • Jika perlu, deposit dan biaya ketidakhadiran dapat diterapkan bersamaan untuk pemesanan.
  • Meskipun tidak memerlukan pembayaran di muka, server pemesanan harus merespons permintaan CreateBooking dengan PaymentInformation yang berisi payment_transaction_id, yang harus unik. payment_transaction_id tidak perlu disediakan oleh pemroses pembayaran, tetapi dapat dibuat oleh server pemesanan.
Perubahan pada feed layanan atau ketersediaan

Deposit dan biaya ketidakhadiran dapat ditentukan di tingkat Layanan atau di tingkat slot Ketersediaan untuk penjual. Jika Anda menentukannya di tingkat slot ketersediaan, hal tersebut akan menggantikan definisi tingkat layanan.

  • Untuk mengaktifkan deposit, tetapkan kolom deposit pada tingkat slot layanan atau ketersediaan.
  • Untuk mengaktifkan denda ketidakhadiran, tetapkan kolom no_show_fee di tingkat slot layanan atau ketersediaan.
  • Tetapkan kolom require_credit_card ke REQUIRE_CREDIT_CARD_CONDITIONAL di tingkat slot layanan atau ketersediaan.
  • (opsional) Tetapkan prepayment_type ke REQUIRED atau OPTIONAL.

Kartu kredit diperlukan

Mungkin ada kasus penggunaan lain yang memerlukan kartu kredit pada saat pemesanan.

  • Tetapkan kolom require_credit_card ke REQUIRE_CREDIT_CARD_ALWAYS di tingkat Layanan atau di tingkat slot Ketersediaan untuk penjual.

Pembatalan dan Pengembalian Dana

Pembatalan dan pengembalian dana dimulai oleh partner (Anda) atau pengguna melalui Pesan dengan Google. Dalam kedua kasus tersebut, Anda harus mematuhi CancellationPolicy yang ditetapkan di Tingkat layanan dan dikomunikasikan kepada pengguna saat checkout.

Jika Anda tidak memberikan CancellationPolicy, diasumsikan bahwa semua pembatalan dalam periode pembatalan yang ditentukan oleh min_advance_online_canceling yang ditetapkan pada Tingkat layanan dapat dikembalikan dananya. Jika min_advance_online_canceling tidak ditentukan, nilainya adalah 0 (artinya dapat dibatalkan kapan saja).

Jika Anda harus menonaktifkan pembatalan dari sisi Pesan dengan Google, diskusikan dengan POC Google Anda.

Perubahan pada RTU
  • Setelah memberikan pengembalian dana kepada pengguna, Anda harus mengirim RTU pembaruan pemesanan untuk mengubah status pembayaran pemesanan. Tetapkan update_mask ke status,payment_information.prepayment_status, lalu tetapkan payment_information.prepayment_status = PREPAYMENT_REFUNDED dan status = CANCELED.
    • Gunakan BookingStatus = CANCELED dan PrepaymentStatus = PREPAYMENT_REFUNDED yang baru. Nilai enum CANCELED_AUTOMATIC_REFUND tidak digunakan lagi untuk Maps Booking API dan template gRPC.
Ubah ke Server Pemesanan
  • Saat Pesan dengan Google mengirimkan UpdateBookingRequest dan hal ini akan memicu pengembalian dana untuk pengguna, tetapkan booking.payment_information.prepayment_status = PREPAYMENT_REFUNDED di UpdateBookingResponse.