# FedaPay

Brancher le compte FedaPay du parc pour que les chauffeurs paient leur versement par Mobile Money : clé publique, webhook, test, mode test et mode réel.

FedaPay encaisse les versements des chauffeurs par MTN MoMo, Moov Money et Celtiis Cash, directement sur le compte FedaPay du parc. Flot Pilot ne touche pas à l'argent : il ouvre la fenêtre de paiement, puis enregistre le versement quand FedaPay le confirme.

:::note
Cette intégration encaisse les chauffeurs, sur le compte du parc. L'abonnement du parc à Flot Pilot se règle à part : voir [Abonnement et factures](https://docs.flotpilot.com/settings/billing/).
:::

## Ce qui change une fois FedaPay active

- Dans l'[App chauffeur](https://docs.flotpilot.com/driver-app/), un chauffeur qui loue son véhicule touche **Payer maintenant**, choisit son opérateur (MTN MoMo, Moov Money ou Celtiis Cash), puis valide le paiement dans la fenêtre FedaPay et sur son téléphone.
- Si la fenêtre s'est fermée, le bouton **Ouvrir la fenêtre de paiement** la rouvre.
- Quand FedaPay confirme le paiement, le versement s'inscrit tout seul au journal de la [Caisse](https://docs.flotpilot.com/cash/). Personne n'a rien à saisir.
- Un paiement refusé, annulé, échoué ou expiré chez FedaPay n'inscrit rien.
- Les espèces ne passent pas par FedaPay : elles s'encaissent comme avant, à la [Caisse](https://docs.flotpilot.com/cash/) ou avec l'[App de collecte](https://docs.flotpilot.com/collect/).

## Les deux champs

| Champ | Où le trouver |
| --- | --- |
| **Clé publique** | Tableau de bord FedaPay › Paramètres › Clés API. Elle commence par `pk_sandbox_` (essais) ou `pk_live_` (paiements réels) |
| **Secret du webhook** | FedaPay › Paramètres › Webhooks : créez un webhook vers l'adresse affichée dans le formulaire, puis collez le secret que FedaPay affiche |

Ne donnez jamais la clé secrète du compte (elle commence par `sk_`) : Flot Pilot n'en a pas besoin.

## Brancher FedaPay

1. Dans **Réglages**, section **Intégrations**, cliquez sur **Configurer** sur la ligne **FedaPay**.
2. Sous **Adresse du webhook à déclarer chez FedaPay**, cliquez sur **Copier**. Cette adresse est propre à votre parc.
3. Dans votre tableau de bord FedaPay, créez un webhook vers cette adresse, puis copiez le secret qu'il affiche.
4. Revenez dans Flot Pilot : collez la **Clé publique** et le **Secret du webhook**, puis cliquez sur **Enregistrer**.
5. Cliquez sur **Tester**, puis sur **Activer**.

## Ce que vérifie le test

Le test ne contacte pas FedaPay : sans la clé secrète, il n'y a rien à interroger. Il vérifie la forme de ce que vous avez saisi. C'est le premier paiement confirmé qui prouve que le webhook est bien déclaré.

| Message | Ce qu'il faut faire |
| --- | --- |
| « Clé publique sandbox acceptée. Le premier paiement confirmera le webhook. » (ou « live ») | Rien : cliquez sur **Activer** |
| « Ce n'est pas une clé publique FedaPay : elle commence par pk_sandbox_ ou pk_live_. » | Vous avez collé autre chose que la clé publique, par exemple la clé secrète, ou une clé incomplète. Recopiez la clé publique depuis Paramètres › Clés API |
| « Le secret du webhook semble incomplet. » | Le secret est trop court. Recopiez-le en entier depuis la page du webhook dans FedaPay |

## Mode test et paiements réels

**Clé `pk_sandbox_`** : c'est le mode test de FedaPay, aucun argent réel ne circule. Le service s'affiche **Active · test**.

**Clé `pk_live_`** : les chauffeurs paient pour de vrai. Deux conditions pour l'activer :

1. Les paiements réels doivent être ouverts sur la plateforme Flot Pilot. Tant qu'ils ne le sont pas, l'écran affiche « Clé live détectée. Les paiements réels ne sont pas encore ouverts sur la plateforme : cette intégration ne peut pas être activée pour l'instant. » et le bouton **Activer** n'apparaît pas.
2. Vous cochez **J'autorise les débits réels** avant de cliquer sur **Activer**. Cette autorisation se donne une fois ; elle est à redonner si vous changez les clés.

Le service s'affiche alors **Active · live**.

:::caution
Un paiement d'essai confirmé en mode test s'inscrit quand même au journal, comme un vrai versement. Faites vos essais avec un chauffeur de test, puis annulez l'écriture par une contre-passation (voir [Caisse](https://docs.flotpilot.com/cash/)).
:::

## Ce que Flot Pilot peut faire avec vos clés

Avec la seule clé publique, Flot Pilot peut ouvrir une fenêtre de paiement FedaPay au nom de votre parc. Il ne peut ni lire votre compte, ni en faire sortir de l'argent.

Le secret du webhook sert uniquement à vérifier que les confirmations viennent bien de FedaPay : un message dont la signature ne correspond pas est refusé.

## Couper FedaPay ou changer de clé

- Flot Pilot n'accepte les confirmations de FedaPay que tant que l'intégration est active. Coupez-la quand aucun chauffeur n'est en train de payer.
- Pour passer du mode test aux paiements réels, cliquez sur **Modifier**, collez la clé `pk_live_` (et le secret du webhook correspondant s'il a changé), puis **Enregistrer**, **Tester** et **Activer**. Entre l'enregistrement et la nouvelle activation, le service est coupé.

Voir aussi la marche commune à tous les services dans [Intégrations](https://docs.flotpilot.com/integrations/).

Source : https://docs.flotpilot.com/integrations/fedapay/