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:
- Gunakan pemroses pembayaran yang didukung. Daftar terbaru pemroses yang didukung dapat ditemukan di situs Google Pay.
- Terima pembayaran token sesuai dengan pemroses Anda.
- 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 kolomtokenization_config
. Kumpulan ini bergantung pada pemroses pembayaran yang dipilih. Set ini adalah kumpulanpaymentMethodTokenizationParameters.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
- Berdasarkan jenis pembayaran yang dilakukan pengguna, terapkan
metode
CreateBooking
- Google akan mengirimkan token pembayaran di kolom
payment_processing_parameters.unparsed_payment_method_token
sebagai bagian dariCreateBookingRequest
. Ini adalahpaymentData
yang sama yang akan diterima oleh callback dalam integrasi Google Pay. - Dalam
CreateBookingResponse
, sertakan pesan PaymentInformation yang menentukan jenis pembayaran, status, ID transaksi, dan struktur harga/biaya. - Tetapkan kolom
payment_information.payment_processed_by
kePROCESSED_BY_PARTNER
diCreateBookingResponse
.
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:
- Menyelesaikan pemesanan dengan pembayaran di muka
- Deposit yang diperlukan untuk pemesanan
- Denda ketidakhadiran jika pengguna tidak datang ke layanan yang dipesan
- Kartu kredit diperlukan untuk pemesanan
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.
- Pembayaran harus sebesar 100% dari jumlah biaya layanan. Dengan kata lain, layanan harus dibayar penuh pada saat pemesanan.
-
Tetapkan kolom
prepayment_type
keREQUIRED
untuk layanan tersebut. - Tetapkan kolom
require_credit_card
keREQUIRE_CREDIT_CARD_CONDITIONAL
untuk layanan tersebut.
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.
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 berisipayment_transaction_id
, yang harus unik.payment_transaction_id
tidak perlu disediakan oleh pemroses pembayaran, tetapi dapat dibuat oleh server pemesanan.
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
keREQUIRE_CREDIT_CARD_CONDITIONAL
di tingkat slot layanan atau ketersediaan. - (opsional) Tetapkan
prepayment_type
keREQUIRED
atauOPTIONAL
.
Kartu kredit diperlukan
Mungkin ada kasus penggunaan lain yang memerlukan kartu kredit pada saat pemesanan.
- Tetapkan kolom
require_credit_card
keREQUIRE_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
kestatus,payment_information.prepayment_status
, lalu tetapkanpayment_information.prepayment_status = PREPAYMENT_REFUNDED
danstatus = CANCELED
.- Gunakan
BookingStatus = CANCELED
danPrepaymentStatus = PREPAYMENT_REFUNDED
yang baru. Nilai enumCANCELED_AUTOMATIC_REFUND
tidak digunakan lagi untuk Maps Booking API dan template gRPC.
- Gunakan
- Saat Pesan dengan Google mengirimkan
UpdateBookingRequest
dan hal ini akan memicu pengembalian dana untuk pengguna, tetapkanbooking.payment_information.prepayment_status = PREPAYMENT_REFUNDED
diUpdateBookingResponse
.