- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- BookingFailure
- Przyczyna
- PaymentFailureInformation
- ThreeDS1Parameters
Aktualizuje istniejące 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 |
Nazwa zasobu rezerwacji: |
Parametry zapytania
Parametry | |
---|---|
updateMask |
Maska pola wszystkich pól rezerwacji do zaktualizowania Jest to lista rozdzielonych przecinkami pełnych i jednoznacznych nazw pól. Przykład: |
bookingFailure |
Jeśli przetwarzanie asynchronicznie potwierdzonej prośby o rezerwację się nie uda, a stan rezerwacji zostanie zmieniony na NIEPRAWIDŁOWA, to pole powinno odzwierciedlać błąd logiki biznesowej (np. użytkownik ma już rezerwację zbyt blisko tej godziny). To pole należy ustawić tylko podczas aktualizowania stanu rezerwacji na BŁĄD. W przeciwnym razie będzie ignorowane. |
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 asynchroniczne przetwarzanie rezerwacji nie powiodło się. Celem BookingFailure jest głównie wykrywanie błędów logiki biznesowej.
Zapis JSON |
---|
{ "cause": enum ( |
Pola | |
---|---|
cause |
Przyczyna niepowodzenia rezerwacji. (pole wymagane) |
rejectedCardType |
(wymagane tylko wtedy, gdy przyczyna to PAYMENT_ERROR_CARD_TYPE_REJECTED) |
description |
To opcjonalne pole służy partnerowi do podawania dodatkowych informacji wyłącznie do celów debugowania. (opcjonalnie) |
paymentFailure |
Informacje o nieudanych płatności. |
Przyczyna
Wyliczenie przyczyn niepowodzenia.
Wartości w polu enum | |
---|---|
CAUSE_UNSPECIFIED |
Wartość domyślna: nie używać; 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 we wskazanym przedziale dostępności. |
LEASE_EXPIRED |
Wynajem (jeśli został podany) wygasł i nie można go już wykorzystać do zrealizowania żądanej rezerwacji. |
OUTSIDE_CANCELLATION_WINDOW |
Z powodu ograniczeń czasowych określonych przez sprzedawcę w zasadach anulowania w tej chwili nie można dokonać żądanego anulowania. |
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 związany z pakietem lub członkostwem użytymi do opłacenia rezerwacji. Możliwe, że nie zostało użyte żadne ważne konto, karta wygasła 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 jest on zgodny z podanym powyżej błędem płatności. |
USER_CANNOT_USE_PAYMENT_OPTION |
Użytkownik nie może użyć danej opcji płatności (np. użytkownik próbuje użyć ceny za pierwszym razem). |
BOOKING_ALREADY_CANCELLED |
Rezerwacja, którą użytkownik próbował anulować, została już anulowana. |
BOOKING_NOT_CANCELLABLE |
Rezerwacji, którą użytkownik próbował anulować, nie można anulować. |
OVERLAPPING_RESERVATION |
Użytkownik ma już rezerwację, która przypada zbyt blisko tej godziny. |
USER_OVER_BOOKING_LIMIT |
Rezerwacja nie powiodła się, ponieważ użytkownik przekroczył ustalony przez pośrednika limit rezerwacji na użytkownika. |
PAYMENT_REQUIRES_3DS1 |
Określ, kiedy płatność ma zostać odrzucona, ponieważ prosisz o ponowną próbę realizacji transakcji, ale tym razem po wykonaniu testu zabezpieczającego/odpowiedzi 3DS1. Pamiętaj, że stan błędu bieżącej transakcji pozostanie niepowodzeniem. Ponawiam próbę. Jeśli jest to przyczyna niepowodzenia, musisz ustawić parametr paymentFailure.3DS1_parameters. Jeśli tak nie jest, obecna przyczyna jest traktowana tak, jakby była to PAYMENT_ERROR. |
PaymentFailureInformation
Informacje o nieudanych płatności.
Zapis JSON |
---|
{
"threeds1Parameters": {
object ( |
Pola | |
---|---|
threeds1Parameters |
Parametry używane przez agregator RwG do inicjowania protokołu uwierzytelniania 3DS1 u użytkownika. Jest ignorowana, chyba że BookingFailure.cause ma wartość PAYMENT_REQUIRES_3DS1. |
ThreeDS1Parameters
Parametry żądające od RwG zadania 3DS1.
Parametry są ustawiane przez opis protokołu 3DS1 podany przez EMVCo.
Zapis JSON |
---|
{ "acsUrl": string, "paReq": string, "transactionId": string, "mdMerchantData": string } |
Pola | |
---|---|
acsUrl |
Adres URL, z którego ma zostać wczytany formularz, który zostanie przedstawiony użytkownikowi w celu uwierzytelnienia. |
paReq |
Żądanie uwierzytelniania PaymentAuth. Do opublikowania w formularzu ACSUrl, jeśli jest podany. |
transactionId |
Identyfikator używany przez dostawcę usługi ACS. Do opublikowania w formularzu ACSUrl, jeśli jest podany. |
mdMerchantData |
Dane sprzedawcy. Do opublikowania w formularzu ACSUrl, jeśli jest podany. |