# Revolut-betalingen koppelen (met sandbox en testkaarten)

Gasten betalen de toeristenbelasting, de borg en extra's via **je eigen Revolut Business-merchantaccount**. Het geld gaat rechtstreeks naar jou; wij houden het nooit vast. Je hebt een Revolut Business-account nodig waarop het product **Merchant** (kaartbetalingen accepteren) is ingeschakeld.

We raden sterk aan eerst de **sandbox** te koppelen. De sandbox is een aparte testkopie van Revolut Business: er wordt geen echt geld overgemaakt en je kunt elke uitkomst uitproberen met testkaarten.

## 1. Maak een Revolut-sandboxaccount aan

1. Ga naar `https://sandbox-business.revolut.com/signup` en registreer je.
2. Twijfel je welke rechtsvorm je moet kiezen, kies dan **Public Limited Company** (accounts voor freelancers worden in de sandbox niet ondersteund).
3. Als je wordt gevraagd je e-mailadres te verifiëren, klik dan op **Skip email verification**. Klik voor de bevestigingscode op **Autofill code**. Goedkeuringen in de sandbox gaan automatisch.

> **Belangrijk:** Sandboxsleutels werken alleen in sandboxmodus en livesleutels alleen in live-modus. Je kunt ze niet door elkaar gebruiken.

## 2. Kopieer de API-sleutels van de sandbox

1. Log in op `https://sandbox-business.revolut.com/signin`.
2. Open **Merchant**, klik op het menu **⋯** en kies **Merchant API** (directe link: `https://sandbox-business.revolut.com/settings/apis?tab=merchant-api`).
3. Klik op **Generate** naast de **Secret key** als die er nog niet is, en kopieer hem (begint met `sk_`).
4. Kopieer ook de **Public key** (begint met `pk_`). Die is nodig voor de knoppen van Apple Pay en Google Pay.

## 3. Vul de sleutels in je dashboard in

1. Open **Settings → Payments**.
2. Plak de **Secret API key** en de **Public API key**.
3. Vink **Sandbox mode (test payments with Revolut test cards)** aan.
4. Klik op **Save** en daarna op **Test connection**. Je zou *Connected to Revolut (sandbox)* moeten zien.
5. Klik op **Register webhook**. Revolut laat je portaal nu direct weten wanneer een betaling slaagt of mislukt, of wanneer een borgreservering wordt geïnd of vrijgegeven. De status verandert in *Registered*.

De geheime sleutel wordt versleuteld opgeslagen. Kom je later terug, dan wordt hij gemaskeerd getoond; laat hem zo staan om de opgeslagen sleutel te behouden.

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

## 4. Testen met de testkaarten van Revolut

Maak een testboeking met je eigen e-mailadres, open de gastenlink en betaal. Gebruik in de sandbox een willekeurige **vervaldatum in de toekomst** en **een willekeurige CVV van 3 cijfers**.

| Kaartnummer | Merk | Resultaat |
|---|---|---|
| `4929 4205 7359 5709` | Visa | Betaling slaagt |
| `5281 4388 0180 4148` | Mastercard | Betaling slaagt |
| `4929 5736 3812 5985` | — | Geweigerd: onvoldoende saldo |
| `4532 3367 4387 4205` | — | Geweigerd: kaart verlopen |
| `2720 9988 3777 9594` | — | Geweigerd: do not honour (uitgever) |
| `4242 4242 4242 4242` | — | 3-D Secure-verificatie mislukt (alleen bij bedragen van €30,00 of meer) |
| `5215 6741 1512 7070` | — | Mislukt: uitgever vraagt aanvullende verificatie |
| `2223 0000 1047 9399` | — | Blijft in verwerking (autorisatie gestart) |

Bedragen onder €30,00 (of £25,00) zijn in de sandbox vrijgesteld van 3-D Secure en slagen zonder verificatie. Wil je een mislukte 3-D Secure-verificatie zien, gebruik dan een testboeking met een borg van minstens €30.

Controleer in het dashboard of:

- de toeristenbelasting **Paid** toont en de borg **Held** (pre-autorisatie) of **Paid** (afschrijvingsmodus),
- het gastenportaal wordt ontgrendeld zodra alle stappen klaar zijn,
- er een e-mail met ontvangstbewijs binnenkomt,
- **Release deposit** in de boeking de reservering terugbetaalt of vrijgeeft.

### Testen vanuit Settings → Payments

Je hebt geen boeking nodig om de hele keten te testen. Vul onder **Settings → Payments → Test payments** een bedrag in (1–50) en klik op:

- **Test charge & refund**: betaal de testbestelling in het nieuwe tabblad en klik daarna op **Refund**. Zo werken belastingen, extra's en borgen in de modus *charge & refund* (afschrijven en terugbetalen).
- **Test deposit hold & release**: betaal de testbestelling (het bedrag wordt alleen op de kaart gereserveerd) en klik daarna op **Release hold**, of op **Keep half, release rest** en vervolgens **Refund the kept part**. Dit is de borgmodus *hold* (reservering).

Elke test toont wat Revolut bij elke stap antwoordde en vinkt **Webhook received** aan zodra de ondertekende melding van Revolut Guestbud heeft bereikt; die melding bevestigt gastbetalingen automatisch. Komt de webhook nooit aan, klik dan op **Register webhook**. In live-modus gebruikt de test een echte kaart en wordt het bedrag meteen terugbetaald; Revolut kan zijn kosten inhouden.

## 5. Live gaan

1. Open in je live Revolut Business-account (`https://business.revolut.com`) **Merchant → ⋯ → Merchant API** en kopieer de live secret key en public key.
2. Plak ze in **Settings → Payments**, vink **Sandbox mode** uit, klik op **Save** en **Test connection** (*live*).
3. Klik opnieuw op **Register webhook**: het live-account heeft een eigen webhook nodig.
4. Doe een kleine echte betaling met je eigen kaart en betaal die in Revolut terug.

## Betaalmethoden

Kies onder **Payment methods** wat gasten aangeboden krijgen:

- **Card payment**: de gehoste checkout van Revolut (alle grote kaarten, 3-D Secure).
- **Apple Pay** en **Google Pay**: zie [Apple Pay en Google Pay](/docs/apple-pay-google-pay).
- **Manual payment**: standaard uit. Zet dit aan om gasten contant of per bankoverschrijving te laten betalen; je bevestigt de betaling met **Mark as paid** in de boeking. Voeg instructies toe, zoals je IBAN.

![Wat de gast ziet bij het afrekenen](/site/img/docs/m-payment-sheet.webp "Wat de gast ziet bij het afrekenen")

## Borg: reserveren of afschrijven

Een borg kan een **pre-autorisatie op de kaart** zijn (het geld wordt gereserveerd maar niet afgeschreven en na het uitchecken vrijgegeven) of een **afschrijving** die je later terugbetaalt. Reserveringen verlopen standaard na 7 dagen; vink **Deposits as card pre-authorisation for up to 30 days** aan als je Revolut-account verlengde autorisaties heeft. Details: [Borg en vrijstellingen](/docs/deposits-and-waivers).

## Problemen oplossen

### Test connection meldt dat Revolut de sleutel heeft geweigerd (401)?

Waarschijnlijk heb je een livesleutel in sandboxmodus geplakt of andersom, of de public key in het veld voor de secret key gekopieerd. De secret key begint met `sk_`.

### De gast heeft betaald, maar de boeking staat nog op wachten op de bank?

De webhook ontbreekt of wijst naar een oud adres. Klik opnieuw op **Register webhook**. Het portaal controleert openstaande betalingen ook opnieuw telkens wanneer de gast de pagina opent.

### Kan ik één Revolut-account voor meerdere bedrijven gebruiken?

Elke tenant koppelt zijn eigen merchantaccount. Beheer je onder één bedrijf accommodaties voor meerdere eigenaren, dan volstaat één account.

### Slaat het gastenportaal kaartgegevens op?

Nee. Kaartgegevens worden ingevoerd op de pagina's van Revolut of in het betaalvenster van Revolut en komen nooit op onze servers.

## Borgmodus, vrijgavetermijn en veiligheid in de sandbox

![Borgmodus, vrijgavetermijn en de testmail in de sandbox](/site/img/docs/d-payments-deposit.webp "Borgmodus, vrijgavetermijn en de testmail in de sandbox")

Onder **Settings → Payments → Revolut Merchant**:

- **Deposit mode** (borgmodus): *Charge & refund* (de standaard): de borg wordt vooraf afgeschreven en na het uitchecken geheel of gedeeltelijk terugbetaald, veilig voor elke verblijfsduur. *Hold (pre-authorisation)*: het bedrag wordt alleen op de kaart geblokkeerd en automatisch vrijgegeven, maar een reservering duurt maximaal 7 dagen (30 met pre-autorisatie), dus dit past alleen bij korte verblijven. Elke accommodatie volgt deze standaard, tenzij in **Guide editor → Payments → How it is taken** iets anders staat; vink **Use this deposit mode for all properties** aan om ze allemaal op de standaard te zetten.
- **Release the hold this many days after check-out** (standaard 2): je termijn om de accommodatie te inspecteren en geld voor schade in te houden voordat Revolut de reservering zelf vrijgeeft. 0 = vrijgeven bij het uitchecken.
- **Sandbox test email**: zolang **Sandbox mode** aanstaat, worden echte gasten nooit benaderd: e-mails aan gasten gaan naar dit adres (leeg = het e-mailadres van de host) en berichten via het boekingskanaal worden tegengehouden. Zet de sandbox pas uit als je klaar bent om echte betalingen met een livesleutel te ontvangen.