Method: notification.partners.bookings.patch

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

string

Nama resource pemesanan: partners/{partner ID}/bookings/{booking ID}

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Mask kolom untuk semua kolom pemesanan yang akan diperbarui

Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

bookingFailure

object (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 (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
Kolom
cause

enum (Cause)

Alasan pemesanan gagal. (wajib)

rejectedCardType

enum (CreditCardType)

(hanya wajib jika penyebabnya adalah PAYMENT_ERROR_CARD_TYPE_TOPICED)

description

string

Kolom opsional ini digunakan partner guna menyertakan informasi tambahan hanya untuk tujuan proses debug. (opsional)

paymentFailure

object (PaymentFailureInformation)

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 (ThreeDS1Parameters)
  }
}
Kolom
threeds1Parameters

object (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

string

URL tempat memuat formulir yang akan ditampilkan kepada Pengguna untuk autentikasi.

paReq

string

Permintaan PaymentAuthentication. Untuk diposting ke formulir ACSUrl jika disediakan.

transactionId

string

ID yang digunakan oleh penyedia ACS. Untuk diposting ke formulir ACSUrl jika disediakan.

mdMerchantData

string

Data penjual. Untuk diposting ke formulir ACSUrl jika disediakan.