Paiements et taxes · pour Hôtes

Connecter les paiements Revolut (sandbox et cartes de test compris)

Connectez votre compte marchand Revolut Business : clés sandbox, cartes de test, webhook, moyens de paiement, dépôt de garantie, passage en réel.

Les voyageurs paient la taxe de séjour, le dépôt de garantie et les extras via votre propre compte marchand Revolut Business. L'argent vous parvient directement ; nous ne le détenons jamais. Il vous faut un compte Revolut Business avec le produit Merchant (acceptation des cartes) activé.

Nous vous recommandons vivement de connecter d'abord la sandbox. La sandbox est une copie de test distincte de Revolut Business : aucun argent réel ne circule, et vous pouvez essayer chaque cas de figure avec des cartes de test.

1. Créer un compte sandbox Revolut #

1. Rendez-vous sur https://sandbox-business.revolut.com/signup et inscrivez-vous.
2. Si vous ne savez pas quelle forme juridique choisir, sélectionnez Public Limited Company (les comptes freelance ne sont pas pris en charge dans la sandbox).
3. Lorsqu'on vous demande de vérifier votre e-mail, cliquez sur Skip email verification. Pour le code de confirmation, cliquez sur Autofill code. Les validations dans la sandbox sont automatiques.

2. Copier les clés API sandbox #

1. Connectez-vous sur https://sandbox-business.revolut.com/signin.
2. Ouvrez Merchant, cliquez sur le menu ⋯ et choisissez Merchant API (lien direct : https://sandbox-business.revolut.com/settings/apis?tab=merchant-api).
3. Cliquez sur Generate à côté de Secret key s'il n'en existe pas encore, puis copiez-la (elle commence par sk_).
4. Copiez aussi la Public key (elle commence par pk_). Elle est nécessaire pour les boutons Apple Pay et Google Pay.

3. Saisir les clés dans votre tableau de bord #

1. Ouvrez Settings → Payments.
2. Collez la Secret API key et la Public API key.
3. Cochez Sandbox mode (test payments with Revolut test cards).
4. Cliquez sur Save, puis sur Test connection. Vous devriez voir Connected to Revolut (sandbox).
5. Cliquez sur Register webhook. Revolut informe désormais instantanément votre portail lorsqu'un paiement aboutit ou échoue, ou lorsqu'une pré-autorisation de dépôt est prélevée ou libérée. Le statut passe à Registered.

La clé secrète est stockée chiffrée. Lorsque vous revenez plus tard, elle s'affiche masquée — laissez-la telle quelle pour conserver la clé enregistrée.

4. Tester avec les cartes de test Revolut #

Créez une réservation de test avec votre propre adresse e-mail, ouvrez le lien voyageur et payez. Dans la sandbox, utilisez n'importe quelle date d'expiration future et n'importe quel CVV à 3 chiffres.

Les montants inférieurs à 30,00 € (ou 25,00 £) sont exemptés de 3-D Secure dans la sandbox et aboutissent sans authentification. Pour voir un échec 3-D Secure, utilisez une réservation de test avec un dépôt de garantie d'au moins 30 €.

Vérifiez dans le tableau de bord que :

• la taxe de séjour affiche Paid et le dépôt Held (pré-autorisation) ou Paid (mode débit),
• le portail voyageurs se déverrouille une fois toutes les étapes effectuées,
• un reçu arrive par e-mail,
• Release deposit dans la réservation rembourse ou libère la pré-autorisation.

Tester depuis Settings → Payments #

Vous n'avez pas besoin de réservation pour tester toute la chaîne. Sous Settings → Payments → Test payments, saisissez un montant (1–50) et appuyez sur :

• Test charge & refund : payez la commande de test dans le nouvel onglet, puis appuyez sur Refund. C'est ainsi que fonctionnent les taxes, les extras et les dépôts en mode charge & refund.
• Test deposit hold & release : payez la commande de test (le montant est seulement bloqué sur la carte), puis appuyez sur Release hold, ou sur Keep half, release rest puis Refund the kept part. C'est le mode de dépôt par hold (pré-autorisation).

Chaque test indique ce que Revolut a répondu à chaque étape et coche Webhook received lorsque la notification signée de Revolut est parvenue à Guestbud — c'est elle qui confirme d'elle-même les paiements des voyageurs. Si le webhook n'arrive jamais, appuyez sur Register webhook. En mode réel, le test utilise une vraie carte et est remboursé immédiatement ; Revolut peut conserver ses frais.

5. Passer en mode réel #

1. Dans votre compte Revolut Business réel (https://business.revolut.com), ouvrez Merchant → ⋯ → Merchant API et copiez les clés secrète et publique réelles.
2. Dans Settings → Payments, collez-les, décochez Sandbox mode, puis Save et Test connection (live).
3. Cliquez de nouveau sur Register webhook — le compte réel a besoin de son propre webhook.
4. Effectuez un petit paiement réel avec votre propre carte et remboursez-le dans Revolut.

Moyens de paiement #

Sous Payment methods, choisissez ce qui est proposé aux voyageurs :

• Card payment : page de paiement hébergée par Revolut (toutes les grandes cartes, 3-D Secure).
• Apple Pay et Google Pay : voir Apple Pay et Google Pay.
• Manual payment : désactivé par défaut. Activez-le pour permettre aux voyageurs de choisir les espèces ou le virement bancaire ; vous le confirmez avec Mark as paid dans la réservation. Ajoutez des instructions, par exemple votre IBAN.

Dépôts de garantie : pré-autorisation ou débit #

Un dépôt de garantie peut être une pré-autorisation sur carte (l'argent est réservé mais pas prélevé ; libéré après le départ) ou un débit que vous remboursez ensuite. Les pré-autorisations expirent par défaut au bout de 7 jours ; cochez Deposits as card pre-authorisation for up to 30 days si votre compte Revolut dispose des autorisations prolongées. Détails : Dépôts de garantie et exonérations.

Dépannage #

Test connection indique que Revolut a rejeté la clé (401) ? #

Vous avez probablement collé une clé réelle en mode sandbox ou inversement, ou copié la clé publique dans le champ de la clé secrète. La clé secrète commence par sk_.

Le voyageur a payé mais la réservation indique toujours « en attente de la banque » ? #

Le webhook manque ou pointe vers une ancienne adresse. Cliquez de nouveau sur Register webhook. Le portail revérifie aussi les paiements en cours chaque fois que le voyageur ouvre la page.

Puis-je utiliser un seul compte Revolut pour plusieurs entreprises ? #

Chaque client connecte son propre compte marchand. Si vous gérez des logements pour plusieurs propriétaires au sein d'une seule entreprise, un seul compte suffit.

Le portail voyageurs stocke-t-il les données de carte ? #

Non. Les données de carte sont saisies sur les pages de Revolut ou dans la fenêtre de paiement de Revolut et n'atteignent jamais nos serveurs.

Mode de dépôt, délai de libération et sécurité de la sandbox #

Sous Settings → Payments → Revolut Merchant :

• Deposit mode : Charge & refund (par défaut) — le dépôt est prélevé à l'avance et remboursé après le départ, en tout ou en partie ; sûr quelle que soit la durée du séjour. Hold (pre-authorisation) — le montant est seulement bloqué sur la carte et libéré automatiquement, mais une pré-autorisation dure au maximum 7 jours (30 avec la pré-autorisation prolongée) ; elle ne convient donc qu'aux séjours courts. Chaque logement suit ce réglage par défaut, sauf si son Guide editor → Payments → How it is taken en dispose autrement ; cochez Use this deposit mode for all properties pour faire passer tous les logements au mode par défaut.
• Release the hold this many days after check-out (2 par défaut) : votre délai pour inspecter le logement et retenir de l'argent en cas de dégâts avant que Revolut ne libère lui-même la pré-autorisation. 0 = libération au moment du départ.
• Sandbox test email : tant que Sandbox mode est activé, les vrais voyageurs ne sont jamais contactés — les e-mails destinés aux voyageurs sont envoyés à cette adresse (vide = l'e-mail de l'hôte) et les messages via le canal de réservation sont retenus. Ne désactivez la sandbox que lorsque vous êtes prêt à encaisser de vrais paiements avec une clé réelle.