Zahlungen & Steuern · für Gastgeber

Revolut-Zahlungen verbinden (inkl. Sandbox und Testkarten)

Revolut-Business-Händlerkonto verbinden: Sandbox-Schlüssel und Testkarten, Webhook, Zahlungsarten, Kaution als Reservierung oder Abbuchung, Livegang.

Gäste zahlen Touristensteuer, Kaution und Extras über Ihr eigenes Revolut-Business-Händlerkonto. Das Geld geht direkt an Sie; wir verwahren es nie. Sie benötigen ein Revolut-Business-Konto mit aktiviertem Merchant-Produkt (Kartenakzeptanz).

Wir empfehlen dringend, zuerst die Sandbox zu verbinden. Die Sandbox ist eine separate Testkopie von Revolut Business: Es fließt kein echtes Geld, und Sie können mit Testkarten jedes Ergebnis ausprobieren.

1. Revolut-Sandbox-Konto erstellen #

1. Rufen Sie https://sandbox-business.revolut.com/signup auf und registrieren Sie sich.
2. Wenn Sie unsicher sind, welche Rechtsform Sie wählen sollen, nehmen Sie Public Limited Company (Freiberufler-Konten werden in der Sandbox nicht unterstützt).
3. Wenn Sie aufgefordert werden, Ihre E-Mail-Adresse zu bestätigen, klicken Sie auf Skip email verification. Für den Bestätigungscode klicken Sie auf Autofill code. Sandbox-Freigaben erfolgen automatisch.

2. Sandbox-API-Schlüssel kopieren #

1. Melden Sie sich unter https://sandbox-business.revolut.com/signin an.
2. Öffnen Sie Merchant, klicken Sie auf das Menü ⋯ und wählen Sie Merchant API (Direktlink: https://sandbox-business.revolut.com/settings/apis?tab=merchant-api).
3. Klicken Sie neben dem Secret key auf Generate, falls noch keiner existiert, und kopieren Sie ihn (beginnt mit sk_).
4. Kopieren Sie auch den Public key (beginnt mit pk_). Er wird für die Buttons von Apple Pay und Google Pay benötigt.

3. Schlüssel im Dashboard eintragen #

1. Öffnen Sie Settings → Payments.
2. Fügen Sie den Secret API key und den Public API key ein.
3. Aktivieren Sie Sandbox mode (test payments with Revolut test cards).
4. Klicken Sie auf Save und dann auf Test connection. Sie sollten Connected to Revolut (sandbox) sehen.
5. Klicken Sie auf Register webhook. Revolut informiert Ihr Portal nun sofort, wenn eine Zahlung erfolgreich ist, fehlschlägt oder eine Kautionsreservierung eingezogen oder freigegeben wird. Der Status wechselt auf Registered.

Der Secret Key wird verschlüsselt gespeichert. Wenn Sie später zurückkehren, wird er maskiert angezeigt – lassen Sie ihn unverändert, um den gespeicherten Schlüssel zu behalten.

4. Mit den Revolut-Testkarten testen #

Legen Sie eine Testbuchung mit Ihrer eigenen E-Mail-Adresse an, öffnen Sie den Gästelink und bezahlen Sie. Verwenden Sie in der Sandbox ein beliebiges Ablaufdatum in der Zukunft und eine beliebige dreistellige CVV.

Beträge unter €30,00 (bzw. £25,00) sind in der Sandbox von 3-D Secure ausgenommen und werden ohne Prüfung erfolgreich verarbeitet. Um einen 3-D-Secure-Fehler zu sehen, verwenden Sie eine Testbuchung mit einer Kaution von mindestens €30.

Prüfen Sie im Dashboard, dass:

• die Touristensteuer Paid und die Kaution Held (Vorautorisierung) bzw. Paid (Abbuchungsmodus) anzeigt,
• das Gästeportal freigeschaltet wird, sobald alle Schritte erledigt sind,
• eine Beleg-E-Mail ankommt,
• Release deposit in der Buchung die Reservierung freigibt bzw. den Betrag erstattet.

Test unter Settings → Payments #

Sie brauchen keine Buchung, um die gesamte Kette zu testen. Geben Sie unter Settings → Payments → Test payments einen Betrag (1–50) ein und klicken Sie auf:

• Test charge & refund – bezahlen Sie die Testbestellung im neuen Tab und klicken Sie dann auf Refund. So funktionieren Steuern, Extras und Kautionen im Modus charge & refund.
• Test deposit hold & release – bezahlen Sie die Testbestellung (der Betrag wird nur auf der Karte reserviert) und klicken Sie dann auf Release hold oder auf Keep half, release rest und anschließend auf Refund the kept part. Das ist der Kautionsmodus hold.

Jeder Test listet auf, was Revolut bei jedem Schritt geantwortet hat, und hakt Webhook received ab, sobald die signierte Benachrichtigung von Revolut bei Guestbud angekommen ist – genau das bestätigt Gästezahlungen automatisch. Kommt der Webhook nie an, klicken Sie auf Register webhook. Im Live-Modus nutzt der Test eine echte Karte und wird sofort erstattet; Revolut kann seine Gebühr einbehalten.

5. Live gehen #

1. Öffnen Sie in Ihrem Live-Konto von Revolut Business (https://business.revolut.com) Merchant → ⋯ → Merchant API und kopieren Sie den Live-Secret-Key und den Live-Public-Key.
2. Fügen Sie sie unter Settings → Payments ein, deaktivieren Sie Sandbox mode, klicken Sie auf Save und Test connection (live).
3. Klicken Sie erneut auf Register webhook – das Live-Konto benötigt einen eigenen Webhook.
4. Führen Sie eine kleine echte Zahlung mit Ihrer eigenen Karte durch und erstatten Sie sie in Revolut.

Zahlungsarten #

Unter Payment methods wählen Sie, was Gästen angeboten wird:

• Card payment – Revolut Hosted Checkout (alle gängigen Karten, 3-D Secure).
• Apple Pay und Google Pay – siehe Apple Pay und Google Pay.
• Manual payment – standardmäßig aus. Aktivieren Sie die Option, damit Gäste Barzahlung oder Überweisung wählen können; Sie bestätigen die Zahlung mit Mark as paid in der Buchung. Hinterlegen Sie Hinweise wie Ihre IBAN.

Kaution: Reservierung oder Abbuchung #

Eine Kaution kann eine Kartenreservierung (Vorautorisierung) sein (das Geld wird reserviert, aber nicht abgebucht; Freigabe nach dem Check-out) oder eine Abbuchung, die Sie später erstatten. Reservierungen verfallen standardmäßig nach 7 Tagen; aktivieren Sie Deposits as card pre-authorisation for up to 30 days, wenn Ihr Revolut-Konto erweiterte Autorisierungen unterstützt. Details: Kautionen und Erlasse.

Fehlerbehebung #

„Test connection“ meldet, dass Revolut den Schlüssel abgelehnt hat (401)? #

Wahrscheinlich haben Sie einen Live-Schlüssel im Sandbox-Modus eingefügt oder umgekehrt, oder den Public Key in das Feld für den Secret Key kopiert. Der Secret Key beginnt mit sk_.

Der Gast hat bezahlt, aber die Buchung zeigt weiterhin „warte auf Bank“? #

Der Webhook fehlt oder zeigt auf eine alte Adresse. Klicken Sie erneut auf Register webhook. Das Portal prüft offene Zahlungen außerdem jedes Mal erneut, wenn der Gast die Seite öffnet.

Kann ich ein Revolut-Konto für mehrere Firmen nutzen? #

Jeder Mandant verbindet sein eigenes Händlerkonto. Wenn Sie Unterkünfte für mehrere Eigentümer unter einer Firma verwalten, genügt ein Konto.

Speichert das Gästeportal Kartendaten? #

Nein. Kartendaten werden auf den Seiten von Revolut oder im Zahlungsfenster von Revolut eingegeben und erreichen nie unsere Server.

Kautionsmodus, Freigabefrist und Sandbox-Sicherheit #

Unter Settings → Payments → Revolut Merchant:

• Deposit mode (Kautionsmodus) – Charge & refund (Standard): Die Kaution wird vorab abgebucht und nach dem Check-out ganz oder teilweise erstattet – sicher für jede Aufenthaltsdauer. Hold (pre-authorisation): Der Betrag wird nur auf der Karte blockiert und automatisch freigegeben, aber eine Reservierung hält höchstens 7 Tage (30 mit Vorautorisierung) und eignet sich daher nur für kurze Aufenthalte. Jede Unterkunft folgt diesem Standard, sofern nicht unter Guide editor → Payments → How it is taken etwas anderes eingestellt ist; aktivieren Sie Use this deposit mode for all properties, um alle auf den Standard umzustellen.
• Release the hold this many days after check-out (Standard 2) – Ihr Zeitfenster, um die Unterkunft zu prüfen und bei Schäden Geld einzubehalten, bevor Revolut die Reservierung selbst freigibt. 0 = Freigabe beim Check-out.
• Sandbox test email – solange Sandbox mode aktiv ist, werden echte Gäste nie kontaktiert: Gäste-E-Mails gehen an diese Adresse (leer = die E-Mail-Adresse des Gastgebers), und Nachrichten über den Buchungskanal werden zurückgehalten. Schalten Sie die Sandbox erst ab, wenn Sie bereit sind, mit einem Live-Schlüssel echte Zahlungen anzunehmen.