- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan Otorisasi
- BookingFailure
- Cause
- PaymentFailureInformation
- ThreeDS1Parameters
Memperbarui Booking
yang ada.
Permintaan HTTP
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
booking.name |
Nama resource pemesanan: |
Parameter kueri
Parameter | |
---|---|
updateMask |
Mask kolom untuk semua kolom pemesanan yang akan diperbarui Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: |
bookingFailure |
Jika pemrosesan permintaan pemesanan yang dikonfirmasi secara asinkron gagal dan status pemesanan sedang diperbarui ke FAILED, kolom ini harus mencerminkan error logika bisnis (mis., pengguna memiliki reservasi yang terlalu dekat dengan waktu saat ini). Kolom ini hanya boleh ditetapkan saat memperbarui status pemesanan ke FAILED dan akan diabaikan jika tidak. |
Isi permintaan
Isi permintaan memuat instance Booking
.
Isi respons
Jika berhasil, isi respons memuat instance Booking
.
Cakupan Otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/mapsbooking
BookingFailure
Data status yang menunjukkan alasan pemrosesan pemesanan gagal secara asinkron. BookingFailure ditujukan terutama untuk mengambil error logika bisnis.
Representasi JSON |
---|
{ "cause": enum ( |
Kolom | |
---|---|
cause |
Alasan pemesanan gagal. (wajib) |
rejectedCardType |
(hanya wajib jika penyebabnya adalah PAYMENT_ERROR_CARD_TYPE_TOPICED) |
description |
Kolom opsional ini digunakan partner guna menyertakan informasi tambahan hanya untuk tujuan proses debug. (opsional) |
paymentFailure |
Informasi tentang kegagalan pembayaran. |
Cause
Enumerasi penyebab kegagalan.
Enum | |
---|---|
CAUSE_UNSPECIFIED |
Nilai default: Jangan digunakan; menghasilkan "error tidak diketahui" |
SLOT_UNAVAILABLE |
Slot ketersediaan yang direferensikan tidak tersedia lagi. |
SLOT_ALREADY_BOOKED_BY_USER |
Pengguna telah memesan janji temu untuk slot ketersediaan yang direferensikan. |
LEASE_EXPIRED |
Lease (jika tersedia) telah habis masa berlakunya dan tidak dapat digunakan lagi untuk menyelesaikan pemesanan yang diminta. |
OUTSIDE_CANCELLATION_WINDOW |
Pembatalan yang diminta tidak dapat dilakukan saat ini karena pembatasan waktu dalam kebijakan pembatalan dari penjual. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
Terjadi error saat memproses pembayaran karena jenis kartu kredit yang diberikan tidak diterima oleh penjual. Jenis kartu kredit harus diberikan dalam rejectedCardType. |
PAYMENT_ERROR_CARD_DECLINED |
Terjadi error saat memproses pembayaran karena kartu kredit yang diberikan ditolak. |
PAYMENT_OPTION_NOT_VALID |
Terjadi error dengan paket/keanggotaan yang digunakan untuk membayar pemesanan. Mungkin tidak ada penggunaan valid yang tersisa, bisa jadi sudah habis masa berlakunya, dll. |
PAYMENT_ERROR |
Terjadi error saat memproses pembayaran untuk pemesanan ini. Gunakan nilai ini untuk menunjukkan error terkait pembayaran umum, hanya jika error tidak cocok dengan error pembayaran tertentu di atas. |
USER_CANNOT_USE_PAYMENT_OPTION |
Pengguna tidak dapat menggunakan opsi pembayaran tertentu (mis., pengguna mencoba menggunakan harga pengguna baru untuk kedua kalinya). |
BOOKING_ALREADY_CANCELLED |
Pemesanan yang coba dibatalkan oleh pengguna sudah dibatalkan. |
BOOKING_NOT_CANCELLABLE |
Pemesanan yang coba dibatalkan oleh pengguna tidak dapat dibatalkan. |
OVERLAPPING_RESERVATION |
Pengguna sudah memiliki reservasi yang terlalu dekat dengan waktu saat ini. |
USER_OVER_BOOKING_LIMIT |
Pemesanan gagal karena pengguna melebihi batas pemesanan gabungan per pengguna dari agregator. |
PAYMENT_REQUIRES_3DS1 |
Ditetapkan jika pembayaran ditolak karena Anda meminta agar transaksi dicoba lagi, tetapi kali ini setelah menyelesaikan tantangan/respons 3DS1. Perhatikan bahwa status kegagalan transaksi saat ini akan tetap gagal. Percobaan ulang akan sepenuhnya terpisah. Jika ini adalah alasan kegagalan, paymentFailure.3DS1_parameters HARUS ditetapkan. Jika tidak, penyebab saat ini akan ditangani seolah-olah sebagai PAYMENT_ERROR. |
PaymentFailureInformation
Informasi tentang kegagalan pembayaran.
Representasi JSON |
---|
{
"threeds1Parameters": {
object ( |
Kolom | |
---|---|
threeds1Parameters |
Parameter yang digunakan oleh agregator RwG untuk memulai protokol autentikasi 3DS1 dengan pengguna. Akan diabaikan kecuali jika BookingFailure.cause ditetapkan ke PAYMENT_REQUIRES_3DS1. |
ThreeDS1Parameters
Parameter yang meminta agar RwG menjalankan tantangan 3DS1.
Parameter ditetapkan oleh deskripsi protokol 3DS1 dari EMVCo.
Representasi JSON |
---|
{ "acsUrl": string, "paReq": string, "transactionId": string, "mdMerchantData": string } |
Kolom | |
---|---|
acsUrl |
URL tempat memuat formulir yang akan ditampilkan kepada Pengguna untuk autentikasi. |
paReq |
Permintaan PaymentAuthentication. Untuk diposting ke formulir ACSUrl jika disediakan. |
transactionId |
ID yang digunakan oleh penyedia ACS. Untuk diposting ke formulir ACSUrl jika disediakan. |
mdMerchantData |
Data penjual. Untuk diposting ke formulir ACSUrl jika disediakan. |