- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- BookingFailure
- Ursache
- PaymentFailureInformation
- ThreeDS1Parameters
Aktualisiert eine vorhandene Buchung (Booking
).
HTTP-Anfrage
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
booking.name |
Ressourcenname der Buchung: |
Abfrageparameter
Parameter | |
---|---|
updateMask |
Feldmaske aller Buchungsfelder, die aktualisiert werden sollen Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: |
bookingFailure |
Wenn die Verarbeitung einer asynchron bestätigten Buchungsanfrage fehlschlägt und der Buchungsstatus zu FAILED geändert wird, sollte in diesem Feld der Fehler in der Geschäftslogik angezeigt werden. Beispielsweise kann der Nutzer zu dieser Zeit schon eine Reservierung haben. Das Feld sollte nur beim Aktualisieren des Buchungsstatus auf FAILED gesetzt werden. Ansonsten wird es ignoriert. |
Anfragetext
Der Anfragetext enthält eine Instanz von Booking
.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Booking
.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/mapsbooking
BookingFailure
Statusdaten, die Aufschluss darüber geben, warum die asynchrone Verarbeitung einer Buchung fehlgeschlagen ist. Mit "BookingFailure" sollen in erster Linie Fehler in der Geschäftslogik erfasst werden.
JSON-Darstellung |
---|
{ "cause": enum ( |
Felder | |
---|---|
cause |
Der Grund, warum die Buchung fehlgeschlagen ist (Pflichtfeld) |
rejectedCardType |
(nur erforderlich, wenn der Grund PAYMENT_ERROR_CARD_TYPE_REJECTED ist) |
description |
In diesem optionalen Feld kann der Partner zusätzliche Angaben zu Debugging-Zwecken machen. (optional) |
paymentFailure |
Informationen zu Zahlungsfehlern |
Cause
Optionen für Fehlerursachen
Optionen | |
---|---|
CAUSE_UNSPECIFIED |
Standardwert: Nicht verwenden; entspricht "Unbekannter Fehler" |
SLOT_UNAVAILABLE |
Der referenzierte verfügbare Slot ist nicht mehr verfügbar. |
SLOT_ALREADY_BOOKED_BY_USER |
Der Nutzer hat bereits einen Termin für den referenzierten verfügbaren Slot gebucht. |
LEASE_EXPIRED |
Die Lease (falls vorhanden) ist abgelaufen und kann nicht mehr für die angeforderte Buchung verwendet werden. |
OUTSIDE_CANCELLATION_WINDOW |
Aufgrund von Zeitbeschränkungen in den Stornierungsrichtlinien des Händlers ist die angeforderte Stornierung derzeit nicht möglich. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
Bei der Verarbeitung der Zahlung ist ein Fehler aufgetreten, weil der angegebene Kreditkartentyp vom Händler nicht akzeptiert wurde. Der Kreditkartentyp muss in "rejectedCardType" angegeben werden. |
PAYMENT_ERROR_CARD_DECLINED |
Bei der Verarbeitung der Zahlung ist ein Fehler aufgetreten, weil die angegebene Kreditkarte abgelehnt wurde. |
PAYMENT_OPTION_NOT_VALID |
Bei Paketen oder Mitgliedschaften, die für die Buchung verwendet wurden, ist ein Fehler aufgetreten. Möglicherweise sind sie aufgebraucht oder abgelaufen. |
PAYMENT_ERROR |
Bei der Verarbeitung der Zahlung für diese Buchung ist ein Fehler aufgetreten. Verwende diesen Wert, um einen allgemeinen zahlungsbezogenen Fehler anzugeben, wenn der Fehler keinem bestimmten oben angegebenen Zahlungsfehler entspricht. |
USER_CANNOT_USE_PAYMENT_OPTION |
Der Nutzer darf die angegebene Zahlungsoption nicht verwenden, z. B. ein Nutzer, der zum zweiten Mal den Preis für Neueinsteiger auswählt. |
BOOKING_ALREADY_CANCELLED |
Eine Buchung, die der Nutzer stornieren wollte, ist bereits storniert. |
BOOKING_NOT_CANCELLABLE |
Eine Buchung, die der Nutzer stornieren wollte, kann nicht storniert werden. |
OVERLAPPING_RESERVATION |
Der Nutzer hat eine bestehende Reservierung, die zu nahe bei dieser Reservierung liegt. |
USER_OVER_BOOKING_LIMIT |
Die Buchung ist fehlgeschlagen, weil der Nutzer das Limit für Buchungen pro Nutzer des Aggregators überschritten hat. |
PAYMENT_REQUIRES_3DS1 |
Lege diese Option fest, wenn die Transaktion nach einer abgelehnten Zahlung wiederholt werden soll, diesmal aber nach der 3DS1-Challenge/Response-Authentifizierung. Am Fehlerstatus der aktuellen Transaktion ändert sich dadurch nichts. Die Wiederholung ist ein komplett eigenständiger Vorgang. Wenn das die Fehlerursache ist, MUSS "paymentFailure.3DS1_parameters" festgelegt werden. Andernfalls wird die aktuelle Ursache wie PAYMENT_ERROR behandelt. |
PaymentFailureInformation
Informationen zu Zahlungsfehlern
JSON-Darstellung |
---|
{
"threeds1Parameters": {
object ( |
Felder | |
---|---|
threeds1Parameters |
Parameter, die von einem RwG-Aggregator verwendet werden, um ein 3DS1-Authentifizierungsprotokoll mit dem Nutzer zu initiieren. Wird ignoriert, wenn "BookingFailure.cause" nicht auf PAYMENT_REQUIRES_3DS1 gesetzt ist. |
ThreeDS1Parameters
Parameter, über die angefordert wird, dass RwG eine 3DS1-Bestätigung durchführt.
Die Parameter beruhen auf der EMVCo-Beschreibung des 3DS1-Protokolls.
JSON-Darstellung |
---|
{ "acsUrl": string, "paReq": string, "transactionId": string, "mdMerchantData": string } |
Felder | |
---|---|
acsUrl |
Die URL, von der aus ein Formular geladen wird, das dem Nutzer zur Authentifizierung angezeigt wird. |
paReq |
Eine "PaymentAuthentication"-Anfrage. Wird an das ACSUrl-Formular gesendet, falls angegeben. |
transactionId |
Eine vom ACS-Anbieter verwendete Kennung. Wird an das ACSUrl-Formular gesendet, falls angegeben. |
mdMerchantData |
Händlerdaten: Wird an das ACSUrl-Formular gesendet, falls angegeben. |