> ## Documentation Index
> Fetch the complete documentation index at: https://help.firby.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Paiements voyageurs (Stripe)

> Relier en lecture seule le compte Stripe qui encaisse vos réservations en direct, pour récupérer les frais réels de chaque paiement.

Vos réservations **en direct** sont encaissées sur votre propre compte Stripe. Votre
PMS, lui, ne connaît ni les **frais Stripe réels** de chaque paiement, ni sa **date
d’encaissement** : sans eux, une commission calculée sur une base « net » l’est sur des
frais absents, donc surévaluée.

En connectant ce compte Stripe **en lecture seule**, Firby lit les paiements, les
rapproche de vos réservations et applique les frais réels.

> [!NOTE]
>
> Rien à voir avec l’[Encaissement](https://help.firby.fr/factures/paiements.md), qui **prélève vos
> propriétaires** par mandat SEPA. Ici, Firby ne fait que **lire** ce que vos voyageurs
> ont payé : il ne peut ni créer, ni modifier, ni déclencher un paiement.

## Où ça se passe

La section **Paiements voyageurs** est en bas de la page **Paramètres → Connexion
PMS**. Elle apparaît si vous avez une connexion Superhote — le cas où le PMS ne remonte
pas ces frais — ou si vous avez déjà connecté un compte Stripe.

## Connecter votre compte Stripe

1. Cliquez **Connecter un compte Stripe**.
2. Nommez la connexion — laissez vide pour reprendre le nom du compte Stripe — et,
   si ce compte n’encaisse que les séjours d’un seul propriétaire, choisissez-le dans
   **Propriétaire lié**.
3. **Continuer vers Stripe**, puis autorisez l’accès.

Vous revenez dans Firby, qui lance aussitôt la **première lecture** des paiements.
Firby ne conserve aucun secret : vous pouvez retirer l’autorisation à tout moment
depuis votre tableau de bord Stripe.

> [!NOTE]
>
> Une connexion déjà créée avec une **clé restreinte** continue de fonctionner : sa clé se
> remplace depuis **Modifier**, sans perdre les paiements déjà lus. Ce mode n’est plus
> proposé pour une nouvelle connexion.

> [!TIP]
>
> Une seule connexion couvre tous les logements encaissés sur ce compte. N’en ajoutez
> une seconde que si vous avez **plusieurs comptes Stripe** — par exemple un compte par
> propriétaire.

## Le rapprochement avec vos réservations

Firby rapproche chaque paiement d’une réservation, et reste volontairement
**prudent**. Il lit d’abord ce que le PMS écrit sur le paiement (référence de la
réservation, à défaut date d’arrivée et voyageur du libellé). Pour le reste, il n’associe
que ce qui est certain : un paiement dont le montant correspond exactement à une seule
réservation, ou une combinaison de deux ou trois paiements (acompte et solde) qui tombe
juste et sans autre possibilité. Une caution annoncée comme telle n’est jamais prise
pour un paiement de séjour.

Dans le doute, Firby préfère ne rien rapprocher plutôt que fausser une facture. Seules
les réservations **confirmées** hors séjour propriétaire sont rapprochées
automatiquement.

## Revoir et trancher les paiements

La liste des comptes affiche, pour chacun, les paiements **lus**, **rapprochés** et **à
traiter**, ces derniers étant les paiements **ambigus** (plusieurs réservations
possibles) ou **sans correspondance**. Les comptes qui demandent votre attention
remontent en tête.

**Voir les paiements** ouvre la revue d’un compte, filtrable en **À traiter**,
**Rapprochés**, **Écartés** et **Tous**. Vous y décidez ligne par ligne :

| Action | Effet |
| - | - |
| **Rattacher** | Associe le paiement à une réservation. Les candidates sont classées par pertinence : total identique d’abord, puis date la plus proche. Sur un paiement ambigu, un clic sur l’une des réservations proposées suffit. |
| **Modifier** | Change la réservation d’un paiement déjà rapproché. |
| **Écarter** | Sort le paiement du rapprochement (caution, frais annexes). |
| **Détacher** ou **Rétablir** | Annule votre décision et rend le paiement au rapprochement automatique. |

Vos décisions sont **conservées à chaque lecture**, et les brouillons concernés sont
recalculés aussitôt.

## Ce que ça change sur vos factures

Le frais réel remplace la valeur du PMS dans les **frais de paiement** de la
réservation. Il est donc déduit des bases de commission **« net »** et **« net hors
ménage »**, et apparaît dans le
[compte rendu de gestion](https://help.firby.fr/crg/composer.md) au sein des frais plateforme. Les **brouillons**
des séjours dont les frais changent sont recalculés automatiquement à chaque lecture ;
les factures déjà envoyées restent figées.

Un montant que vous avez [corrigé à la main](https://help.firby.fr/factures/generation.md#corriger-montants)
sur une réservation reste prioritaire : la correction manuelle prime sur Stripe, qui
prime sur le PMS.

## Mise à jour et suppression

Firby relit vos paiements **chaque nuit**. **Synchroniser**, dans le menu d’un compte,
force une lecture immédiate, et **Tout synchroniser** les lit tous. Le même menu permet
de **modifier** le nom et le propriétaire lié, de **reconnecter** ou de **supprimer** le
compte.

Pour agir sur plusieurs comptes, cochez-les : synchroniser la sélection, la rattacher à
un propriétaire ou la supprimer. À partir de 8 comptes, une recherche et des filtres (À
traiter, En erreur, Jamais synchronisé) s’ajoutent à la liste.

> [!WARNING]
>
> Supprimer la connexion efface les paiements lus depuis ce compte : les réservations
> concernées reprennent les montants du PMS, et leurs **brouillons** sont recalculés. Les
> factures **déjà envoyées** ne changent pas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.