Wie man abgelaufene oder fehlende Zugriffstoken für Cloudbeds Marketplace-Integrationen behebt

Übersicht

Wenn Sie eine Cloudbeds-Marketplace-Anwendung verwenden (wie einen Self-Check-in-Anbieter, Channel-Manager oder Buchhaltungssystem) und fehlgeschlagene Datensynchronisierungen, Authentifizierungsfehler oder fehlende Informationen feststellen, kann die Ursache ein abgelaufener oder fehlender Zugriffs-/Aktualisierungstoken sein.

Diese Token sind entscheidend, damit die App sicher mit Cloudbeds kommunizieren kann; wenn sie ablaufen oder ungültig werden, bricht die Verbindung ab.

Dieser Artikel führt Sie durch das erneute Autorisieren der Anwendung, Testen der Verbindung und Sammeln von Details für den Support, falls weitere Hilfe benötigt wird.

Häufige Symptome

  • Die Funktionalität der integrierten Anwendung (z. B. Check-in-Ablauf, Reservierungssynchronisierung, Berichterstattung) funktioniert nicht oder wird nicht ausgelöst.
  • Die Anwendung meldet einen Authentifizierungsfehler, ein Token-Problem oder einen „Unauthorized“-Fehler.
  • Es werden keine neuen Daten von Cloudbeds synchronisiert, obwohl dies zuvor erfolgreich war.
  • Spezifische Fehlermeldungen vom Partner-System, wie:
    • HTTP 401: { "error": "server_error", "error_description": "The authorization code is invalid or has expired." }
    • HTTP 200: { "success": false, "message": "User who approved this connection is not active anymore" }

Lösungsschritte

Schritt 1: Anwendung erneut autorisieren, um einen neuen Token zu generieren

Zugriffs- und Aktualisierungstoken werden nur während der ersten Verbindung oder einer erneuten Autorisierung generiert. Wenn ein Token verloren geht oder abläuft, ist die schnellste Lösung, die Anwendung in Ihrem Cloudbeds-Konto zu trennen und erneut zu verbinden. Dieser Vorgang erstellt einen neuen gültigen Zugriffs- und Aktualisierungstoken.

  1. Gehen Sie zu Ihrem Kontomenü Account menu icon.png → Apps & Marketplace Apps and Marketplace icon.png → Verbundene Apps.
  2. Suchen Sie die problematische App in der Liste (z. B. Trevo, Sweeply).
  3. Klicken Sie auf Trennen und bestätigen Sie die Aktion.
  4. Klicken Sie auf Verbinden und folgen Sie den bildschirmbezogenen Autorisierungsschritten für diese Anwendung. Dies beinhaltet in der Regel die Anmeldung auf der Partnerplattform oder die Bestätigung von Berechtigungen.

  Dieser Vorgang veranlasst Cloudbeds, einen komplett neuen Zugriffs- und Aktualisierungstoken auszustellen.

Schritt 2: Verbindung testen

  1. Öffnen Sie einen relevanten Testfall im Cloudbeds PMS (z. B. eine Testreservierung für eine Self-Check-in-App oder lösen Sie eine Datensynchronisation für eine Reporting-App aus).
  2. Führen Sie den Ablauf oder die Aktion aus, die zuvor fehlgeschlagen ist (z. B. Check-in initiieren, Synchronisation erzwingen).
  3. Verifizieren Sie, dass der Vorgang ohne Fehler abgeschlossen wird und die Daten wie erwartet synchronisiert werden.

Dies stellt sicher, dass das neue Token gültig ist und wie erwartet funktioniert.

Schritt 3: Falls das Problem weiterhin besteht

Wenn die erneute Autorisierung das Problem nicht behebt, kontaktieren Sie den Cloudbeds-Support und geben Sie folgende Informationen an:

  • Ihre Cloudbeds-Unterkunfts-ID
  • Das ungefähre Datum und die Uhrzeit der erneuten Autorisierung der App
  • Eine aktuelle Reservierungsnummer (oder eine andere relevante ID), bei der das Problem nach der Wiederverbindung aufgetreten ist

Bitten Sie außerdem das Support-Team des Partners (z. B. Trevo Support, Sweeply Support), Folgendes bereitzustellen:

  • API-Anfrage- und Antwortprotokolle, die die Verwendung des fehlgeschlagenen Tokens oder Fehlermeldungen zeigen. Diese Protokolle helfen dem Cloudbeds-Integrations-Team, das Problem genau zu lokalisieren.

Häufig gestellte Fragen

Warum laufen Cloudbeds-Marketplace-Tokens ab oder gehen verloren?

Zugriffs- und Aktualisierungstokens können nach Inaktivität oder Sicherheitszurücksetzungen ablaufen. Sie werden auch ungültig, wenn der Cloudbeds-Benutzer, der ursprünglich die Verbindung autorisiert hat, inaktiv wird. In diesen Fällen ist eine erneute Verbindung mit einem aktiven Benutzer erforderlich.

Beeinflusst das Ablaufdatum von Tokens andere Cloudbeds-Integrationen oder verbundene Apps?

Ja. Der gleiche Fehlerbehebungsprozess des Trennens und erneuten Verbindens gilt für die meisten anderen Cloudbeds-Marketplace-Apps, die tokenbasierte Authentifizierung (OAuth 2.0) verwenden. Wenn ein Partner Fehler wie „Der Autorisierungscode ist ungültig oder abgelaufen“ oder „Der Benutzer, der diese Verbindung genehmigt hat, ist nicht mehr aktiv“ meldet, ist in der Regel eine erneute Autorisierung erforderlich.

Gibt es Integrationen, die eine andere Authentifizierungsmethode als Cloudbeds-Marketplace-Tokens verwenden?

Ja, einige Integrationen können unterschiedliche Authentifizierungsmethoden haben. Zum Beispiel werden Omniboost-Integrationen anders gehandhabt. Konsultiere immer die spezifischen Integrationsanleitungen oder den Cloudbeds-Support, wenn du unsicher bist.

Was bedeutet der Fehler „Der ConnectionTokenProvider deiner App hat den bereitgestellten Abschlussblock nicht innerhalb von 60 Sekunden aufgerufen“ in der Cloudbeds-App?

Diese Meldung erscheint, wenn die Cloudbeds-App versucht, eine Verbindung zu den Servern herzustellen, der sichere Verbindungsprozess jedoch länger als 60 Sekunden dauert. Dies passiert meist bei der Verwendung eines Lesegeräts für Zahlungen (wie Stripe oder Cloudbeds Payments) und wird häufig durch ein schwaches Netzsignal, eine vorübergehende Serververzögerung oder ein Verbindungsproblem mit dem Lesegerät verursacht.

Unten sehen Sie ein Beispiel, wie der Fehler in der App angezeigt wird:

Mögliche Ursachen

  • Instabile oder schwache WLAN- oder Mobilfunkverbindung.
  • Die App wurde während des Verbindungsprozesses minimiert oder unterbrochen.
  • Das Lesegerät für Zahlungen hat die Verbindung verloren oder wurde nicht korrekt gekoppelt.
  • Vorübergehende Verzögerung bei der Erstellung des Verbindungstokens auf Serverseite.

Lösungsschritte

  • Schließe die Cloudbeds-App vollständig und öffne sie erneut.
  • Stelle sicher, dass das Gerät ein starkes WLAN- oder Mobilfunksignal hat, und versuche es erneut.
  • Überprüfe, ob das Lesegerät eingeschaltet und korrekt gekoppelt ist.
  • Aktualisiere die Cloudbeds-App auf die neueste Version.

Wenn das Problem nach diesen Schritten weiterhin besteht, kontaktiere bitte den Cloudbeds-Support und gib die App-Version, das Modell des Lesegeräts sowie den Zeitpunkt des Auftretens des Fehlers an, damit unser Team dir weiterhelfen kann.

Wenn Sie weitere Unterstützung oder Informationen benötigen, steht Ihnen unser Support-Team gerne zur Verfügung!

War dieser Beitrag hilfreich?
0 von 0 fanden dies hilfreich

Kommentare

0 Kommentare

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.