Intégration API PayFit
Nous développons votre connecteur PayFit
Nous connectons PayFit à votre SIRH, votre planning et votre comptabilité : collaborateurs, contrats, absences, journal de paie. Pour un dossier unique, la Customer API Key. Le programme partenaire n'est pas ouvert.
- Équipe produit senior
- connecteurs paie et SIRH en production
- du cadrage au monitoring
À quoi sert l'API PayFit et pourquoi connecter PayFit à son logiciel RH ou comptable ?
PayFit est un logiciel de paie et SIRH conçu pour les ETI et PME françaises. Son API permet à votre application de lire les informations collaborateurs, les contrats, les bulletins de paie et les absences, et d'injecter des variables de paie en fin de mois. On l'intègre quand PayFit est le système de paie en place et qu'on veut éliminer les exports manuels vers le logiciel comptable, synchroniser les absences avec un outil de planning, ou alimenter un dashboard RH avec les données consolidées sans ressaisie. L'accès API nécessite un contrat direct avec PayFit.
Ce que nos clients branchent sur l'API PayFit
L'arrivée crée le dossier paie
Le SIRH métier pousse le collaborateur et le contrat France. L'admin PayFit finalise. Plus de compte applicatif créé à la main, plus de compte qui survit au départ.
Le planning pousse les absences
Les congés validés dans PayFit ferment un créneau, ou l'inverse. Attention : une absence poussée par l'API est déjà validée, pas une demande en attente.
L'OD de paie rejoint la compta
Après le run, le journal v2 part vers Sage, Odoo, Pennylane ou Loop. Contrôle d'équilibre, pas de CSV envoyé par mail.
Le portail affiche le bulletin
payslips:read pour le salarié, sans donner l'admin PayFit à tout le monde. NIR et RIB hors des logs.
Ce qu'une intégration PayFit change pour votre business
La technique au service d'un résultat mesurable : moins de saisie RH, une OD juste, un accès API cadré dès le devis.
PayFit reste le moteur de paie
Votre SIRH ou votre planning reste l'outil du quotidien. La paie, les bulletins et la DSN restent dans PayFit.
L'accès est tranché avant le devis
Clé sur votre dossier, ou accès partenaire si le programme est ouvert. On ne vend pas une app marketplace tant que les demandes sont fermées.
Un rejeu ne double pas l'écriture
Collaborateur et période de paie portent une référence stable. Un mois renvoyé n'écrit pas deux fois dans la compta.
Les données sensibles restent minimales
NIR, RIB, bulletins : droits stricts, pas de log, jeux de test anonymisés. On ne demande que ce dont le parcours a besoin.
Comment nous connectons PayFit à votre système
Cadrage
Customer Key ou Partner OAuth, pays du dossier, scopes, flux (collaborateurs, absences, journal). Vérifier que le partenariat n'est pas requis, ou qu'il est ouvert.
Mapping
Correspondance matricule, contrats France, absences, paramétrage comptable du journal v2. Un champ ajouté dans l'export UI n'est pas forcément dans l'API.
Développement et recette
Cache du jeton, 50/20 req/s, retry 429, collecte du journal après clôture. Recette sur un dossier de test, jamais de bulletin nominatif en log.
Monitoring
Alerte sur 429, rapport d'écart de l'OD, statut de paie de la période. Vous savez qu'un mois n'est pas parti avant le cabinet.
Ce que permet PayFit
- Collaborateurs et contrats
- Liste paginée, CRUD collaborateurs, contrats France en création. Un collaborateur sans contrat est invisible dans l'app. Un contrat API n'est pas finalisé : l'admin complète avant la paie.
- Temps et absences
- time:read / time:write, temps travaillé par contrat France, POST /absences déjà validé. Ce n'est pas un circuit manager.
- Bulletins et journal de paie
- contracts:payslips:read, accounting:read. Journal v1 CSV, v2 France calqué sur les exports comptables paramétrés dans PayFit.
- France : titres restaurant, mutuelle
- Endpoints localisés, hors marchés UK/ES. Fichier de virement et statut de paie d'une période en complément.
Le vocabulaire d'une intégration PayFit
- Customer API Key
- Clé créée dans l'app par un admin, affichée une fois, scopes choisis, Bearer sur partner-api.payfit.com. La voie pour le dossier de l'entreprise elle-même.
- Partner API
- OAuth multi-entreprises, marketplace. Au 17 août 2026, PayFit n'accepte plus de nouvelles demandes, sans date de réouverture. On ne la promet pas.
- Un token, une entreprise
- Pas de jeton groupe. Multi-sociétés PayFit = un flow par société. Régénérer un token supprime le précédent.
- Contrat non finalisé
- POST contrat France : le contrat existe, l'admin doit le compléter dans PayFit avant la paie. Créer un collaborateur sans contrat : invisible dans l'app.
- Journal v2
- JSON calqué sur les exports comptables paramétrés. Des champs ajoutés dans l'UI « will not be exported » via l'API. Cinq champs de synchro pour un logiciel de compta.
- Absence déjà validée
- POST /absences ne crée pas une demande. Un outil de planning qui pousse un congé contourne le circuit manager PayFit.
Les contraintes réelles d'une intégration PayFit
Le partenariat API est fermé
QuickStart et Integrations Requirements : PayFit n'accepte plus de nouvelles demandes d'intégrations via son API, sans date. Promettre de brancher PayFit pour n'importe quel SaaS est faux tant que ce moratoire tient.
Créer n'est pas mettre en paie
Collaborateur sans contrat : invisible. Contrat API : non finalisé. Le gap se documente dans le process RH, pas dans une promesse de provisioning magique.
Pas de webhook de run de paie
La collecte du journal se fait après clôture, pas en push. PayFit annonce un événement à venir : on ne le vend pas aujourd'hui. Réconciliation mensuelle obligatoire.
Données sensibles et quotas
NIR, RIB, bulletins : minimisation, pas de copie en test. Partner API : 50 lect./s et 20 écr./s par application, retry sur X-RateLimit-Remaining-Second.
PayFit ou Lucca, et ce que ça implique
PayFit produit la paie. Lucca gère le SIRH en amont (congés, temps, notes de frais). Ce n'est pas le même connecteur, souvent les deux.
| Critère | PayFitCette page | LuccaSIRH en amont |
|---|---|---|
| Rôle | Paie et SIRH cloud, bulletins, OD | Congés, temps, notes de frais, référentiel |
| Accès API | Customer Key ouverte, Partner fermé sans date | API REST publique, OAuth client credentials |
| Quota | 50 lect./s, 20 écr./s (Partner API) | 50 requêtes par minute, domaine partagé |
| Temps réel | Svix sur demande, pas d'événement de run | Webhooks congés, à accuser sous 3 s |
| Écriture RH | Contrat non finalisé, absence déjà validée | Congé dans le circuit Lucca, puis webhook |
| Effort d'intégration | Moyen, surtout accès et mapping comptable | Moyen, surtout quota et double génération d'API |
| Le bon cas | PME qui internalise la paie et veut brancher SIRH ou compta | Organisation qui a Lucca et veut un planning ou une paie en aval |
Nous ne revendiquons ni partenariat PayFit ni présence marketplace : nous développons sur l'API documentée, pour le dossier du client, tant que le programme partenaire reste fermé.
Ce que nous mesurons sur un projet PayFit
Les autres outils de paie et de SIRH
Le choix se fait sur l'outil déjà en place chez vous, et sur qui produit la paie.
PayFitNous développons votre connecteur PayFitCette page
LuccaLe SIRH en amont : congés, temps, notes de frais, référentiel collaborateurs.
SilaeLa paie de cabinet. L'accès API se joue avec le partenaire, dossier par dossier.On combine PayFit avec
La stack qui entoure PayFit sur nos projets.
Intégration PayFit : vos questions
D'abord trancher l'accès. Pour le dossier de l'entreprise, un admin crée une Customer API Key, on introspecte le company_id, on cache le Bearer. Pour un produit multi-clients, il faudrait la Partner API en OAuth : au 17 août 2026, PayFit n'accepte plus de nouvelles demandes, sans date de réouverture. Ensuite on mappe matricule et contrats, on respecte 50/20 req/s, et on collecte le journal après clôture. La difficulté réelle n'est pas l'appel HTTP, c'est le process RH (contrat incomplet) et le mapping comptable du journal v2.
Non, pas au 17 août 2026. Les pages QuickStart et Integrations Requirements indiquent que, du fait d'une demande élevée, PayFit n'accepte plus temporairement de nouvelles demandes d'intégrations via son API, sans date. Nous ne promettons donc ni marketplace, ni badge partenaire, ni app multi-tenant PayFit. Ce que nous faisons : un connecteur sur la Customer API Key du client, pour son propre dossier, et une architecture prête si le programme rouvre.
Cela dépend des flux : collaborateurs seulement, absences et temps, portail bulletins, ou OD vers la comptabilité. Une remontée d'entrées/sorties se chiffre bien plus bas qu'une chaîne complète avec journal v2 vers Sage ou Loop. L'état du paramétrage comptable dans PayFit pèse autant que la technique : le JSON v2 suit l'export UI, pas l'inverse. Nous cadrons le périmètre en amont et donnons une estimation ferme.
Oui, c'est un cas fréquent. On attend la clôture de période, on lit accounting v2, on contrôle l'équilibre (date, compte, libellé, débit, crédit), on pose une clé période plus dossier, puis on injecte. Un champ ajouté dans l'export PayFit n'est pas forcément exposé par l'API : on le vérifie au cadrage. Pas de webhook de run : la collecte est un job mensuel, avec rapport d'écart avant écriture réelle.
Oui pour le dossier, avec les limites documentées. POST collaborateur sans contrat : invisible dans PayFit. POST contrat France : contrat non finalisé, l'admin complète avant la paie. Les absences poussées par API sont déjà validées. Lucca reste souvent l'amont (congés, temps), PayFit la paie. Les deux connecteurs se parlent via vos identifiants internes, pas via un pont officiel PayFit-Lucca, et ce mapping se signe au cadrage.
Un projet d'intégration PayFit ?
Parlons-en. 30 minutes pour cadrer l'accès (clé Customer, pas un partenariat fermé) et vous dire franchement ce qui est faisable.
Parler de mon projet PayFit