Betalingen & belastingen · voor Hosts

Revolut-betalingen koppelen (met sandbox en testkaarten)

Koppel je Revolut Business-merchantaccount: sandboxsleutels en testkaarten, webhook, betaalmethoden, borg als reservering of afschrijving, dan live.

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.

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.

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.

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

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.

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 #

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.