# Revolut-Zahlungen verbinden (inkl. Sandbox und Testkarten)

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.

> **Wichtig:** Sandbox-Schlüssel funktionieren nur im Sandbox-Modus und Live-Schlüssel nur im Live-Modus. Sie lassen sich nicht mischen.

## 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.

![Settings → Payments](/site/img/docs/d-settings-payments.webp "Settings → Payments")

## 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**.

| Kartennummer | Marke | Ergebnis |
|---|---|---|
| `4929 4205 7359 5709` | Visa | Zahlung erfolgreich |
| `5281 4388 0180 4148` | Mastercard | Zahlung erfolgreich |
| `4929 5736 3812 5985` | — | Abgelehnt: unzureichende Deckung |
| `4532 3367 4387 4205` | — | Abgelehnt: Karte abgelaufen |
| `2720 9988 3777 9594` | — | Abgelehnt: „do not honour“ (Kartenaussteller) |
| `4242 4242 4242 4242` | — | 3-D-Secure-Prüfung schlägt fehl (nur bei Beträgen ab €30.00) |
| `5215 6741 1512 7070` | — | Fehlgeschlagen: Kartenaussteller verlangt zusätzliche Verifizierung |
| `2223 0000 1047 9399` | — | Bleibt in Bearbeitung (Autorisierung gestartet) |

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](/docs/apple-pay-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.

![Was der Gast beim Bezahlen sieht](/site/img/docs/m-payment-sheet.webp "Was der Gast beim Bezahlen sieht")

## 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](/docs/deposits-and-waivers).

## 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

![Kautionsmodus, Freigabefrist und die Sandbox-Test-E-Mail](/site/img/docs/d-payments-deposit.webp "Kautionsmodus, Freigabefrist und die Sandbox-Test-E-Mail")

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.