Relier votre logiciel métier à PayFit : ce que l'API permet vraiment

Clé d'API ou OAuth 2.0 : quelle porte pour votre projet ?

Le choix dépend de qui développe, et pour qui. La documentation développeur de PayFit décrit deux accès distincts.

Deux détails pèsent sur la conception. La clé n'est affichée qu'une fois : PayFit ne permet pas de la relire. Côté OAuth, une entreprise ne peut détenir qu'un jeton par client_id, et en générer un nouveau remplace l'ancien. Surtout, la page « How to become a partner », consultée en octobre 2026, indique qu'en raison d'une forte demande, PayFit n'accepte temporairement plus de nouvelles demandes d'intégration, sans donner de date de réouverture : la situation peut évoluer, elle se vérifie sur cette page. Pour une PME qui relie un outil interne à sa propre paie, la clé d'API reste donc la voie réaliste.

Quelles données de paie un programme peut-il lire ou écrire ?

La référence de l'API, servie depuis partner-api.payfit.com, classe ses appels par objet. Plusieurs ne valent que pour la France, PayFit opérant aussi au Royaume-Uni et en Espagne.

Les droits sont découpés finement : informations générales des collaborateurs (collaborators:read), données personnelles, numéro de sécurité sociale, coordonnées bancaires, contrats, comptabilité (accounting:read) et temps (time:read, limité pour l'instant aux jours travaillés). Écrire une absence demande time:write. Les réponses sont en JSON avec gestion des ETag, et la spécification OpenAPI v3 se télécharge depuis le portail développeur.

Les règles de l'API qui façonnent la liaison

• Débit. PayFit limite par défaut chaque application cliente à 50 requêtes de lecture et 20 requêtes d'écriture par seconde. Au-delà, l'API répond 429 avec le message « API rate limit exceeded », et PayFit recommande d'attendre avant de réessayer ; les en-têtes X-RateLimit indiquent le quota restant.
• Absences sans retouche. Une absence créée par l'API est enregistrée comme validée, et aucun appel ne la modifie : on l'annule, puis on crée la nouvelle version. La documentation interdit d'envoyer brouillons et demandes en attente, et cite les causes de refus : dates incohérentes, chevauchement avec une absence existante, type non activé pour le salarié.
• Journal de paie mensuel. Le journal est produit quand l'administrateur exécute la paie ; PayFit conseille de le collecter chaque mois après ce passage et précise qu'un webhook de fin de paie reste à venir. Chaque écriture compte cinq champs (date, numéro de compte, libellé, débit, crédit) ; les champs ajoutés au paramétrage de l'export ne sortent pas par l'API.
• Webhooks réservés. Les notifications d'événements sont ouvertes aux partenaires, sur demande à PayFit, qui annonce d'autres événements liés au cycle de vie des salariés.
• Créations à compléter. La création d'un collaborateur n'existe que pour la France. Les RH doivent ensuite compléter sa fiche dans PayFit avant tout bulletin, et un contrat créé peut mettre 2 à 5 minutes à apparaître.

Quatre liaisons utiles entre PayFit et vos outils

1. Les congés validés dans le planning partent en paie. Une entreprise de propreté organise ses agents dans un outil de planning des équipes. Quand le responsable de secteur valide une demande de congés, le service d'intégration crée l'absence dans PayFit avec le bon type (congés payés, RTT). Si la demande change, il annule l'absence PayFit et en recrée une.
2. L'embauche décidée dans l'outil de recrutement crée le salarié. Le candidat retenu devient collaborateur PayFit (nom, prénom, e-mail et adresse personnels), puis son contrat est initialisé avec l'intitulé de poste et la date d'entrée. Les RH terminent la fiche : mutuelle, horaires.
3. Le journal de paie nourrit la rentabilité. Chaque mois, après la paie, le logiciel de gestion récupère les écritures et répartit le coût salarial sur les chantiers à partir des heures pointées, pour suivre la rentabilité par chantier avec des chiffres réels.
4. Les mouvements de personnel mettent à jour les accès. Chaque nuit, l'outil de suivi des habilitations compare la liste des contrats lue dans PayFit à ses propres comptes ; un écart (arrivée, départ) est signalé au responsable, qui ouvre ou ferme badges et accès.

Paie et RGPD : ce que la liaison doit respecter

Les données de paie comptent parmi les plus sensibles de l'entreprise : la liaison doit en faire circuler le strict nécessaire.

• Ne cocher que les périmètres utiles. Une liaison de planning n'a besoin ni du numéro de sécurité sociale ni des coordonnées bancaires.
• Restreindre et tracer. La CNIL rappelle que seules les personnes chargées de la gestion du personnel peuvent consulter les informations des salariés, et que les actions sur ces données doivent être enregistrées (qui, quand, quoi). Le journal technique de la liaison note des identifiants et des statuts, jamais le contenu d'un bulletin.
• Conserver ce qu'il faut, pas plus. Selon la même page de la CNIL, les bulletins de paie peuvent être archivés 5 ans après le départ du salarié ; pour le reste, la CNIL a publié en avril 2026 un référentiel des durées de conservation en gestion des ressources humaines.
• Protéger la clé. Affichée une seule fois, la clé PayFit va dans un coffre de secrets, jamais dans le code ni dans un tableur partagé.

Le cadre complet est détaillé dans notre guide RGPD et logiciel métier.

Faut-il développer, ou une intégration existante suffit-elle ?

Regardez d'abord ce qui existe. PayFit met en avant les intégrations de ses partenaires dans une place de marché intégrée à l'application : si votre logiciel de planning ou de recrutement y figure, l'activer coûte moins cher qu'un développement. Si le seul besoin est d'envoyer le journal de paie au comptable une fois par mois, l'export comptable paramétrable dans PayFit peut suffire.

Le développement se justifie quand :

• l'outil à relier est interne ou spécifique, absent de tout catalogue ;
• la liaison applique vos règles : correspondance entre vos motifs d'absence et les types PayFit, validation à deux niveaux, ventilation analytique ;
• plusieurs flux convergent vers PayFit et doivent être surveillés au même endroit.

Une plateforme sans code peut appeler l'API PayFit pour un flux simple ; l'annulation suivie d'une recréation d'absence, ou la reprise après un refus, s'y expriment plus difficilement. Les mécanismes communs sont décrits dans connecter ses outils par API.

Comment YMHB Web construit et suit une liaison PayFit

Le cadrage se fait avec la personne qui gère la paie : types d'absence en usage, circuit de validation, date de lancement de la paie, données qui doivent sortir de PayFit et pour quel usage. Le chiffrage, en forfait global, vient ensuite.

• La clé d'API est créée par votre administrateur PayFit, avec les périmètres arrêtés au cadrage.
• Le service d'intégration, en Node.js avec une base PostgreSQL pour la correspondance des identifiants et le journal, tourne sur votre hébergement.
• Une absence refusée par PayFit (chevauchement, type non activé) apparaît dans un écran d'anomalies au lieu de disparaître.
• Une alerte prévient en cas d'erreurs 429 répétées ou de clé révoquée.
• Code et documentation vous sont remis et vous appartiennent au paiement intégral.

L'architecture de ces services est présentée dans notre offre API et microservices. Si votre paie est produite par un cabinet sur Silae, la logique d'accès diffère : voir connecter Silae.