> For the complete documentation index, see [llms.txt](https://docs.mrsherlock.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mrsherlock.ai/configuration/integrations/paiements.md).

# Paiements

Connectez vos comptes Stripe à Mr Sherlock pour encaisser les cautions et les services additionnels proposés à vos voyageurs.

La sous-section **Paiements** de **Configuration** > **Intégrations** relie vos comptes **Stripe** à Mr Sherlock. Une fois connectés, ils servent aux **cautions** et aux **paiements des services** commandés par vos voyageurs depuis la Guest App.

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-1686ac62a2fc89dfd4bf3d070996e9e6604bdd72%2Fpaiements-integrations-stripe-par-defaut-1280.png?alt=media" alt="Sous-onglet Paiements : Stripe Connect avec deux connexions, Stripe Conciergerie Azur (PAR DÉFAUT, Actif) et Stripe Azur Cannes (Actif)"><figcaption><p>Les fournisseurs de paiement de l'espace</p></figcaption></figure>

### Pourquoi déléguer les paiements à Mr Sherlock ?

Une fois Stripe connecté, Mr Sherlock prend en charge **tout le cycle** des paiements liés à un séjour, sans intervention manuelle.

#### Caution

* La caution suit le **parcours configuré** pour chaque logement : moment où la carte du voyageur est demandée, mode d'autorisation (empreinte immédiate, différée, renouvelée ou aucune), **dispense de caution** payante proposée au voyageur. Voir [Paramètres › Caution](https://docs.mrsherlock.ai/logements/details-dun-logement/parametres/caution.md).
* **Suivi du statut** de chaque caution : carte enregistrée, autorisation, capture, libération, échec.
* **Information du voyageur** à chaque étape, par les messages de la Smart Journey si elle est activée.
* **Résolution des erreurs** : en cas d'échec (carte refusée, plafond atteint, authentification demandée par la banque…), Sherlock propose directement au voyageur une solution adaptée, sans allers-retours avec le gestionnaire.

#### Services additionnels

* **Création du lien de paiement**, **suivi du statut** et **information du voyageur** à chaque étape, comme pour la caution.
* Paiement immédiat ou sur la **carte enregistrée** du voyageur, selon le réglage du service.
* **Suite donnée à la commande** : une validation, manuelle ou automatique, est confirmée au voyageur ; un refus lui est annoncé avec les motifs que vous avez renseignés, formulés avec tact.
* **Résolution des erreurs de paiement** : Sherlock accompagne le voyageur en cas de paiement échoué ou expiré (nouvel essai, autre moyen de paiement…).

Mr Sherlock orchestre ainsi la génération des liens, le suivi, la communication avec le voyageur et la résolution des incidents.

{% hint style="warning" %}
**Voyageurs Booking.com** : autorisez les domaines de Mr Sherlock dans l'Extranet Booking.com, sinon Booking.com supprime les liens de caution et de paiement des messages. Voir [Autoriser les liens de Mr Sherlock sur Booking.com](https://docs.mrsherlock.ai/booking.com/autoriser-les-liens-de-mr-sherlock.md).
{% endhint %}

### Fournisseur pris en charge

* **Stripe Connect**, connecté par **OAuth**.

### Connecter un compte Stripe

Sur la carte **Stripe Connect**, cliquez sur **+ Connecter** (ou sur **Ajouter une connexion** si un compte est déjà connecté). Une fenêtre s'ouvre pour vous authentifier auprès de Stripe et autoriser Mr Sherlock à effectuer des opérations sur votre compte. Le détail est décrit dans [Configuration de Stripe](https://docs.mrsherlock.ai/configuration/integrations/paiements/configuration-de-stripe.md).

Chaque connexion peut recevoir un **nom personnalisé** (par exemple « Stripe Azur Cannes ») pour la retrouver facilement.

Dans la fenêtre d'ajout, Mr Sherlock demande aussi **« Mettre cette connexion par défaut ? »** : la case est cochée si l'espace n'a pas encore de connexion par défaut, décochée sinon.

### Connexion Stripe par défaut

Un même workspace peut connecter **plusieurs comptes Stripe**. L'un d'eux est la **connexion par défaut** : elle reçoit l'argent des **services voyageurs**, de la **dispense de caution** et de la **commission d'assurance** (si « défaut » est choisi) pour les logements qui n'ont pas choisi leur propre connexion. La connexion choisie dans les paramètres d'un logement prime sur celle de l'espace (voir [Paramètres › Intégrations](https://docs.mrsherlock.ai/logements/details-dun-logement/parametres/integrations.md)).

{% hint style="info" %}
La **caution** ne prend **jamais** la connexion par défaut : chaque logement choisit la connexion qui reçoit sa caution, dans l'écran [Caution](https://docs.mrsherlock.ai/logements/details-dun-logement/parametres/caution.md).
{% endhint %}

* La connexion par défaut porte le badge **★ Par défaut**.
* Pour en changer, cliquez sur **☆ Mettre par défaut** sur la connexion à choisir. Si une connexion par défaut existe déjà, une fenêtre de confirmation dit combien de logements vont changer de connexion.
* Retirer la connexion par défaut est refusé tant que des logements la suivent : choisissez-en une autre à la place.

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-2e7562ae31b9682d781231c2816a5cdaba51f8d4%2Fzoom-paiements-integrations-badge-par-defaut.png?alt=media" alt="Ligne de la connexion Stripe Conciergerie Azur avec les badges PAR DÉFAUT et Actif" width="530"><figcaption><p>Le badge de la connexion par défaut</p></figcaption></figure>

### Gérer une connexion

Chaque ligne de connexion permet de :

* **mettre en pause** ou **reprendre** la connexion ;
* **synchroniser** la connexion ;
* **reconnecter** le compte en cas d'erreur ;
* **supprimer** la connexion ;
* **☆ Mettre par défaut**.

Le statut de chaque connexion s'affiche en couleur :

* 🟢 **Actif**
* ⚪ **En pause**
* 🟠 **Configuration en attente**
* 🔴 **Erreur**

#### Mettre une connexion en pause

Une connexion **en pause** ne reçoit plus **aucune nouvelle demande d'argent**, et **aucune autre connexion ne prend sa place** :

* les voyageurs des logements dont la caution utilise cette connexion ne reçoivent plus de demande de caution ;
* la dispense de caution n'est plus proposée sur ces logements ;
* les services payants qui utilisent cette connexion ne peuvent plus être commandés, et aucune demande de paiement ne peut être envoyée ;
* la commission d'assurance des nouveaux contrats n'est plus partagée sur cette connexion.

**Ce qui est déjà en cours continue** : une caution déjà posée peut toujours être rendue ou encaissée, une commande déjà prise peut toujours être encaissée ou remboursée, sur le compte d'origine. Les liens de caution et de paiement déjà envoyés aux voyageurs restent payables : un voyageur qui paie après la pause un lien reçu avant fait arriver l'argent sur cette connexion.

Avant la pause, une fenêtre liste ce qui s'arrête, logement par logement (par exemple : « Les voyageurs de Studio 12 et Loft Bellecour ne recevront plus de demande de caution. »). Sur la fiche d'un logement concerné, le bandeau rouge **« La connexion Stripe de la caution est en pause »** le rappelle. Le bouton lecture (▶) de la connexion la remet en service.

#### Accès retiré depuis Stripe

Si vous retirez l'accès de Mr Sherlock depuis votre tableau de bord Stripe, la connexion passe en **Erreur** avec le message « Accès retiré depuis Stripe ». Plus aucune nouvelle demande d'argent ne part sur ce compte, et les logements dont la caution l'utilise affichent le bandeau rouge **« La connexion Stripe de la caution ne marche plus »**. Aucune notification n'est envoyée.

Contrairement à la pause, **rien ne continue** : ce qui est en cours sur ce compte (rendre, encaisser ou rembourser une caution ou une commande) ne repartira qu'une fois le compte reconnecté. Reconnectez-le vite : une empreinte non encaissée tombe d'elle-même au bout de 7 jours.

Pour repartir, cliquez sur **Reconnecter** sur la ligne de la connexion et autorisez de nouveau **le même compte Stripe** : la connexion revient telle quelle, avec tous les logements, services et réglages qui l'utilisaient. Si vous autorisez un autre compte Stripe, une nouvelle connexion est ajoutée à côté.

#### Supprimer une connexion

La suppression demande toujours une confirmation. Deux cas :

* aucun logement ne l'utilise : la fenêtre le dit (« Aucun logement ne l'utilise ») avant de supprimer ;
* la connexion sert encore : la suppression est refusée avec la liste de ce qui l'utilise (logement, caution ou commande en cours avec le prénom du voyageur, service). Choisissez une autre connexion pour ces logements, ou attendez la fin des cautions et commandes en cours, puis supprimez-la.

### Pages de configuration

{% content-ref url="/pages/zPXWF2SnTj68UnbKKfCB" %}
[Configuration de Stripe](https://docs.mrsherlock.ai/configuration/integrations/paiements/configuration-de-stripe.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mrsherlock.ai/configuration/integrations/paiements.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
