Übersicht

Übersicht

Im Rahmen der Ende-zu-Ende-Integration von „Mit Google reservieren“ können Sie festlegen, dass Anzahlungen, Gebühren für Nichterscheinen oder im Voraus bezahlte Artikel für alle Transaktionen, für die Zahlungen erforderlich sind, mit Ihrer Buchungsseite verlinkt werden. Wenn Sie Zahlungen auf diese Weise aktivieren, können Sie den gesamten Buchungsablauf und die Transaktion auf der von Ihnen angegebenen Buchungsseite abwickeln.

Voraussetzungen

Um Zahlungen zu bestimmten Reservierungen hinzuzufügen, müssen die folgenden Voraussetzungen erfüllt sein:

  1. Eine vorhandene Live-E2E-Integration.
  2. Die Möglichkeit, einen Deeplink direkt zu einer Buchungsseite zu erstellen, auf der Zahlungen verarbeitet werden können.
  3. Einhaltung unserer Richtlinien zur Weiterleitung von Zahlungen

Implementierungsschritte für die Weiterleitung von Zahlungen

  1. URL-Vorlage und zusätzliche Felder einrichten
  2. Zahlungsarten für Ihre Slots angeben
  3. Conversion-Tracking für Ihre Integration aktivieren

Buchungsänderungen

In diesem Abschnitt wird beschrieben, wie Buchungsänderungen und ‑stornierungen mit der Weiterleitung von Zahlungen interagieren, einschließlich des Ausschlusses von Slots und der Fehlerbehandlung.

Buchungen mit Weiterleitung von Zahlungen

Buchungen, die über die Weiterleitung von Zahlungen erstellt werden, werden direkt auf der Buchungsplattform des Partners abgeschlossen. Google speichert oder verwaltet diese Buchungen nicht, so daher können Nutzer sie nicht über „Mit Google reservieren“ ansehen oder ändern. Änderungen oder Stornierungen von Buchungen mit Weiterleitung von Zahlungen müssen direkt auf der Plattform des Partners vorgenommen werden.

Ende-zu-Ende-Buchungen ändern

Wenn ein Nutzer eine vorhandene Ende-zu-Ende-Reservierung ändert (die ursprünglich mit CreateBooking erstellt wurde), schließt Google automatisch alle Slots aus, die mit linkout_required_reason: PAYMENT_REQUIRED gekennzeichnet sind. Diese werden in der Änderungsansicht nicht angezeigt (sind nicht verfügbar oder ausgegraut). So wird verhindert, dass Nutzer eine Ende-zu-Ende-Reservierung in einen Slot mit Weiterleitung von Zahlungen (z.B. mit Anzahlung) ändern, ohne die Zahlung abzuschließen.

UpdateBooking-Anfragen verarbeiten

Der API-Endpunkt UpdateBooking unterstützt nicht die Weiterleitung eines Nutzers zum Ablauf für die Weiterleitung von Zahlungen oder die Rückgabe einer Weiterleitungs-URL. In dem unwahrscheinlichen Fall, dass der Server des Partners eine UpdateBooking-Anfrage für einen Slot mit Weiterleitung von Zahlungen (z. B. mit Anzahlung) erhält (z. B. wenn ein Nutzer eine Änderung vornimmt, bevor die aktualisierte Verfügbarkeit vollständig in den Caches bereitgestellt wurde):

  • Lehnen Sie die Anfrage ab , indem Sie eine UpdateBookingResponse mit einem booking_failure zurückgeben.
  • Ursache des Fehlers: Legen Sie booking_failure.cause auf SLOT_UNAVAILABLE fest. So wird dem Nutzer eine klare Meldung angezeigt („Leider ist dieser Termin nicht mehr verfügbar.“) und es wird verhindert, dass falsche Bestätigungs-E-Mails gesendet werden.
  • Fehlerbeschreibung: Geben Sie in booking_failure.description eine explizite Beschreibung an (z. B. "UpdateBooking not allowed on PR slots"), um die Protokollierung und Fehlerbehebung zu erleichtern.

Sandbox-Tests

Sobald die Weiterleitung von Zahlungen für die Integration des Partners aktiviert ist, kann dieses Verhalten direkt in der Sandbox-Umgebung überprüft werden:

  1. Erstellen Sie mit CreateBooking eine Standard-Ende-zu-Ende-Reservierung.
  2. Geben Sie Verfügbarkeits-Slots mit einer Mischung aus Standard- und PAYMENT_REQUIRED-Slots an.
  3. Öffnen Sie die Reservierung in der Buchungsverwaltung der Sandbox, um eine Änderung vorzunehmen, und prüfen Sie, ob PAYMENT_REQUIRED-Slots als nicht verfügbar (ausgegraut) angezeigt werden.
  4. Prüfen Sie, ob der Server unerwartete UpdateBooking-Aufrufe für kostenpflichtige Slots mit SLOT_UNAVAILABLE ablehnt.