Method: notification.partners.bookings.patch

Aktualizuje dotychczasowy Booking.

Żądanie HTTP

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
booking.name

string

Nazwa zasobu rezerwacji: partners/{partner ID}/bookings/{booking ID}

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska pola wszystkich pól rezerwacji do zaktualizowania

Jest to rozdzielana przecinkami lista w pełni kwalifikowanych nazw pól. Przykład: "user.displayName,photo".
bookingFailure

object (BookingFailure)

Jeśli przetwarzanie asynchronicznie potwierdzonego żądania rezerwacji się nie powiedzie, a stan rezerwacji się zmieni na FAILED, to pole powinno odzwierciedlać błąd logiki biznesowej (np. użytkownik ma istniejącą rezerwację zbyt blisko tej daty). To pole należy ustawić tylko podczas aktualizowania stanu rezerwacji na NIEPOWODZENIE. W przeciwnym razie zostanie zignorowane.

Treść żądania

Treść żądania zawiera wystąpienie elementu Booking.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Booking.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/mapsbooking

BookingFailure

Dane o stanie, które informują, dlaczego asynchronicznie nie udało się przetworzyć rezerwacji. Funkcja BookingFailure ma przede wszystkim wykrywać błędy logiki biznesowej.

Zapis JSON 
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
Pola
cause

enum (Cause)

Powód niepowodzenia rezerwacji. (wymagane)
rejectedCardType

enum (CreditCardType)

(wymagane tylko wtedy, gdy przyczyna to PAYMENT_ERROR_CARD_TYPE_REJECTED)
description

string

To opcjonalne pole pozwala partnerowi podać dodatkowe informacje tylko do celów debugowania. (opcjonalnie)
paymentFailure

object (PaymentFailureInformation)

informacje o niepowodzeniu płatności;

Przyczyna

Lista przyczyn niepowodzenia.

Wartości w polu enum
CAUSE_UNSPECIFIED Wartość domyślna: nie używaj; oznacza „nieznany błąd”
SLOT_UNAVAILABLE Wskazany przedział dostępności nie jest już dostępny.
SLOT_ALREADY_BOOKED_BY_USER Użytkownik zarezerwował już spotkanie w podanym przedziale czasu.
LEASE_EXPIRED Dzierżawa (jeśli została określona) wygasła i nie można jej już wykorzystać do dokonania rezerwacji.
OUTSIDE_CANCELLATION_WINDOW W tej chwili nie można anulować wybranej prośby ze względu na ograniczenia czasowe określone w zasadach anulowania u sprzedawcy.
PAYMENT_ERROR_CARD_TYPE_REJECTED Podczas przetwarzania płatności wystąpił błąd, ponieważ podany typ karty kredytowej nie został zaakceptowany przez sprzedawcę. Typ karty kredytowej musi być podany w odrzuconym typie karty.
PAYMENT_ERROR_CARD_DECLINED Podczas przetwarzania płatności wystąpił błąd, ponieważ podana karta kredytowa została odrzucona.
PAYMENT_OPTION_NOT_VALID Wystąpił błąd dotyczący pakietu lub subskrypcji użytej do opłacenia rezerwacji. Być może nie ma już więcej prawidłowych zastosowań, mogły wygasnąć itp.
PAYMENT_ERROR Podczas przetwarzania płatności za tę rezerwację wystąpił błąd. Użyj tej wartości, aby wskazać ogólny błąd związany z płatnościami, tylko wtedy, gdy nie pasuje on do konkretnego błędu płatności powyżej.
USER_CANNOT_USE_PAYMENT_OPTION Użytkownik nie może użyć danej opcji płatności (np. próbuje po raz drugi użyć ceny za pierwszym razem).
BOOKING_ALREADY_CANCELLED Rezerwacja, którą użytkownik próbował anulować, została już anulowana.
BOOKING_NOT_CANCELLABLE Rezerwacja, którą użytkownik próbował anulować, nie może zostać anulowana.
OVERLAPPING_RESERVATION Użytkownik ma istniejącą rezerwację zbyt blisko tej godziny.
USER_OVER_BOOKING_LIMIT Rezerwacja nie powiodła się, ponieważ użytkownik przekroczył limit rezerwacji na użytkownika agregatora.
PAYMENT_REQUIRES_3DS1

Ustaw, gdy płatność zostanie odrzucona, ponieważ prosisz o ponowną próbę zrealizowania transakcji, ale tym razem po przeprowadzeniu wyzwania/odpowiedzi 3DS1. Pamiętaj, że stan błędu bieżącej transakcji pozostanie niepowodzenie. Proces będzie przebiegał osobno.

Jeśli jest to przyczyna niepowodzenia, TRZEBA ustawić parametr paymentFailure.3DS1_parameters. Jeśli tak nie jest, bieżąca przyczyna zostanie potraktowana tak, jakby to była PAYMENT_ERROR.

PaymentFailureInformation

informacje o niepowodzeniu płatności;

Zapis JSON 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
Pola
threeds1Parameters

object (ThreeDS1Parameters)

Parametry używane przez agregator RwG do zainicjowania protokołu uwierzytelniania 3DS1 z użytkownikiem. Będzie ignorowana, chyba że ustawienie BookingFailure.cause ma wartość PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Parametry żądające wykonania testu 3DS1 przez RwG.

Te parametry są określane w opisie protokołu 3DS1 przez EMVCo.

Zapis JSON 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
Pola
acsUrl

string

Adres URL, z którego ma zostać wczytany formularz, który ma zostać wyświetlony użytkownikowi w celu uwierzytelnienia.
paReq

string

a PaymentAuthentication Request. Do opublikowania w formularzu ACSUrl, jeśli został podany.
transactionId

string

Identyfikator używany przez dostawcę ACS. Do opublikowania w formularzu ACSUrl, jeśli został podany.
mdMerchantData

string

Dane sprzedawcy. Do opublikowania w formularzu ACSUrl, jeśli został podany.