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

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.

> **Important :** les clés sandbox ne fonctionnent qu'en mode sandbox et les clés réelles (live) qu'en mode réel. Vous ne pouvez pas les mélanger.

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

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

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

| Numéro de carte | Réseau | Résultat |
|---|---|---|
| `4929 4205 7359 5709` | Visa | Paiement réussi |
| `5281 4388 0180 4148` | Mastercard | Paiement réussi |
| `4929 5736 3812 5985` | — | Refusé : fonds insuffisants |
| `4532 3367 4387 4205` | — | Refusé : carte expirée |
| `2720 9988 3777 9594` | — | Refusé : do not honour (émetteur) |
| `4242 4242 4242 4242` | — | Échec de l'authentification 3-D Secure (uniquement pour les montants de 30,00 € ou plus) |
| `5215 6741 1512 7070` | — | Échec : l'émetteur exige une vérification supplémentaire |
| `2223 0000 1047 9399` | — | Reste en cours de traitement (autorisation lancée) |

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

![Ce que voit le voyageur au moment de payer](/site/img/docs/m-payment-sheet.webp "Ce que voit le voyageur au moment de payer")

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

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

![Mode de dépôt, délai de libération et e-mail de test sandbox](/site/img/docs/d-payments-deposit.webp "Mode de dépôt, délai de libération et e-mail de test 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.