> 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 et Swikly pour permettre à l'IA de gérer entièrement vos paiements
La sous-section **Paiements** permet de relier vos fournisseurs de paiement à Mr Sherlock. Une fois connectés, ils peuvent être utilisés pour les **cautions** et les **paiements de services additionnels** facturés aux voyageurs depuis la Guest App.
### Pourquoi déléguer la gestion des paiements à Mr Sherlock ?
Connecter votre fournisseur de paiement permet à Mr Sherlock de prendre en charge **tout le cycle de vie** des paiements liés à un séjour - caution et services additionnels - sans intervention manuelle de votre part.
#### Caution
* **Création automatique du lien de dépôt** de caution à chaque réservation éligible.
* **Suivi du statut** : succès, échec, capture, libération.
* **Notification automatique du voyageur** à chaque étape, via la Smart Journey si elle est activée :
* *Lien de caution* - à la génération du lien.
* *Caution confirmée* - à la capture / validation.
* *Échec caution* - en cas d'échec.
* *Caution restituée* - à la libération.
* **Résolution proactive des erreurs** : en cas d'échec de dépôt (carte refusée, plafond, pré-autorisation impossible, etc.), l'IA propose **directement au voyageur** une solution adaptée pour résoudre la situation **sans friction** ni allers-retours avec le gestionnaire.
#### Paiements de services additionnels
* Même logique que pour la caution : **création du lien de paiement**, **suivi du statut** (en attente, autorisé, payé, échec, expiré) et **notification du voyageur** à chaque étape via la Smart Journey.
* **Notification de la suite donnée à la commande** par le gestionnaire :
* en cas de **validation / approbation** d'une commande (manuelle ou automatique), un message confirme la prise en compte au voyageur ;
* en cas de **refus**, un message est envoyé au voyageur **avec les motifs** que vous aurez renseignés, tout en restant formulé avec tact.
* **Résolution proactive des erreurs** de paiement : comme pour la caution, l'IA accompagne le voyageur en cas de paiement échoué ou expiré (proposition de réessayer, d'utiliser un autre moyen, etc.).
Concrètement, vous ne pilotez plus les paiements à la main : Mr Sherlock orchestre la **génération des liens**, le **suivi**, la **communication avec le voyageur** et la **résolution des incidents** de bout en bout.
### Fournisseurs supportés
* **Stripe Connect** - connexion par **OAuth**
* **Swikly** - connexion par **identifiants** (clé API) - *Bientôt disponible*
### Connecter un fournisseur de paiement
Sur la carte du fournisseur souhaité, cliquez sur **Connecter**.
* **Stripe Connect** : une fenêtre s'ouvre pour vous authentifier auprès de Stripe et autoriser Mr Sherlock à effectuer des opérations sur votre compte.
* **Swikly** : renseignez votre **clé API** Swikly.
Vous pouvez donner un **nom personnalisé** à chaque connexion (par exemple « Mon compte Stripe ») pour la retrouver facilement si vous en avez plusieurs.
### Connexion Stripe par défaut
Définissez le compte Stripe par défaut du workspace
Vous pouvez connecter **plusieurs comptes Stripe Connect** à un même workspace. Un de ces comptes peut être désigné comme **connexion Stripe par défaut** : il sera alors utilisé pour tous les paiements de services lorsqu'aucune connexion spécifique n'est définie au niveau du logement.
* La connexion par défaut est marquée par un badge **PAR DÉFAUT** sur sa ligne.
* Pour la modifier, cliquez sur l'**étoile** située sur la ligne de la connexion à promouvoir.
### Gérer une connexion
Une fois la connexion établie, chaque ligne de connexion vous permet de :
* **Activer / Désactiver** la connexion ;
* **Synchroniser** la connexion ;
* **Reconnecter** (Stripe) ou **Modifier la clé API** (Swikly) en cas d'erreur ;
* **Supprimer** la connexion ;
* **Définir comme connexion par défaut** (Stripe uniquement).
Le statut de chaque connexion s'affiche en couleur :
* 🟢 **Actif**
* ⚪ **Inactif**
* 🟠 **Configuration en attente**
* 🔴 **Erreur**
### Pages de configuration
{% content-ref url="/pages/zPXWF2SnTj68UnbKKfCB" %}
[Configuration de Stripe](/configuration/integrations/paiements/configuration-de-stripe.md)
{% endcontent-ref %}
{% content-ref url="/pages/hDRdqYVHpkc3qwCQKAK4" %}
[Configuration de Swikly](/configuration/integrations/paiements/configuration-de-swikly.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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.mrsherlock.ai/configuration/integrations/paiements.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.