💡 Cet article explique ce qu'est l'Enterprise API de Payflip, ce qu'elle fait et tout ce dont votre équipe a besoin pour démarrer. Les parties prenantes métier trouveront la valeur ajoutée dans les premières sections (1–4) ; votre équipe IT/développement trouvera tout ce dont elle a besoin pour construire l'intégration dans les sections suivantes (5–9).
1. Qu'est-ce que l'Enterprise API? 📘
L'Enterprise API de Payflip est un moyen de connecter votre système RH directement à Payflip. Au lieu de tenir à jour manuellement les données des collaborateurs et des salaires à deux endroits, votre équipe IT construit une intégration unique et à partir de là, tout se synchronise automatiquement.
Votre système RH reste la seule source de vérité. Plus d'exports, plus d'imports, plus de réconciliations fastidieuses.
⚠️ L'Enterprise API est destinée aux organisations disposant d'une équipe IT/développement interne, ou souhaitant faire appel à un partenaire IT externe. Payflip ne propose pas ce service d'implémentation elle-même.
2. Qu'est-ce que cela vous apporte? 🫵🏼
Voici ce qui change une fois l'intégration en production :
Plus de double saisie : les modifications des informations collaborateurs et des salaires dans votre système RH arrivent automatiquement dans Payflip.
Moins d'erreurs : les imports manuels sont une source fréquente de problèmes de qualité des données : mauvais salaires, collaborateurs manquants, contrats obsolètes. L'API élimine toute cette catégorie de problèmes.
Fonctionne pour plusieurs entités : que vous ayez une entité juridique ou dix, une seule intégration les couvre toutes. Pas de configuration séparée par entité.
Votre admin RH se concentre sur ce qui compte : il n'intervient que lorsque quelque chose nécessite réellement son attention : un conflit, un départ, un élément à réviser manuellement. Tout le reste passe automatiquement.
Standardisé et évolutif : toutes les sociétés utilisent le même schéma API. Aucun développement sur mesure côté Payflip, et cela évolue avec votre croissance.
3. Qu'est-ce qui est synchronisé et qu'est-ce qui ne l'est pas? 🔁
✅ Ce qui entre
Les données des collaborateurs (nom, e-mail, langue, date de début, type de contrat, entité juridique, ID de paie)
Les contrats salariaux (salaire, régime de travail, coefficients ONSS, y compris les modifications en cours d'année)
❌ Ce qui est actuellement hors périmètre
Les budgets calculés manuellement (comme la prime de fin d'année ou les budgets bonus calculés de votre côté)
Les choix effectués par les collaborateurs dans Payflip
L'historique des contrats salariaux des années précédentes (uniquement à partir du début de l'année en cours)
Les données allant de Payflip vers votre système RH ➡️ il s'agit d'une API unidirectionnelle, en entrée uniquement
4. Comment ça fonctionne 💡
Le modèle est simple : votre système envoie les données vers Payflip. Payflip ne récupère jamais rien de votre côté.
Voici ce qui se passe à chaque envoi de données :
Votre système RH (ou une couche middleware) appelle l'Enterprise API avec les données des collaborateurs ou des contrats.
Payflip valide les données et les place dans une couche de staging.
Un job de synchronisation les traite et les intègre dans Payflip.
Si quelque chose nécessite une attention humaine (un conflit, un départ, un élément à réviser), votre administrateur RH reçoit une notification dans l'outil.
Considérez cela comme un système « push and forget » ➡️ une fois l'intégration en place, votre équipe IT n'a pas besoin de la surveiller. Votre admin RH gère les exceptions ponctuelles dans Payflip, et c'est tout.
💡 Les données n'apparaissent pas dans Payflip immédiatement après l'envoi ➡️ elles passent d'abord par un court processus de staging. En cas d'urgence, votre admin RH peut déclencher une synchronisation manuelle depuis l'outil.
5. Avant que votre équipe IT commence à développer 🚧
Assurez-vous d'avoir les éléments suivants en place avant le début du développement :
Un développeur (ou une équipe) ayant de l'expérience dans la création d'intégrations API REST.
L'accès aux données des collaborateurs et des salaires de votre système RH, ou une couche middleware/ETL capable de les extraire.
Les ID d'entreprise Payflip pour chacune de vos entités juridiques ➡️ vous ne savez pas où les trouver? Consultez notre article à ce sujet.
Une personne de contact désignée de votre côté pour recevoir les identifiants API.
6. Obtenir l'accès 🔑
L'activation de l'Enterprise API se fait conjointement avec vous. Voici comment cela se déroule :
Contactez l'équipe support de Payflip via le bouton bleu dans l'outil admin ou envoyez un e-mail à [email protected] en indiquant que vous souhaitez activer l'Enterprise API.
Ils l'activeront sur votre compte et feront appel à l'équipe technique de Payflip.
L'équipe technique génère des identifiants API spécifiques à votre organisation.
Vos identifiants sont partagés via un lien Bitwarden sécurisé. Le mot de passe de ce lien est envoyé séparément via un second canal de votre choix (Slack, Intercom, e-mail, etc.)
Votre package d'identifiants comprendra :
Auth0 Client ID et Client Secret
URL de l'endpoint token Auth0
URL de base de l'API
⚠️ Gardez votre Client Secret confidentiel. Ne le partagez jamais par e-mail ou via un canal non chiffré.
7. Authentification 🛡️
L'Enterprise API utilise l'authentification OAuth2 Machine-to-Machine (M2M) via Auth0. En pratique, cela fonctionne ainsi :
Votre système demande un token à l'endpoint Auth0 en utilisant votre Client ID et votre Secret.
Auth0 renvoie un token bearer JWT signé.
Ce token est inclus dans le header
Authorization: Bearer <token>de chaque appel API que vous effectuez.
Les tokens expirent, donc votre intégration doit gérer le renouvellement automatiquement (en général en demandant un nouveau token lorsque le token actuel est sur le point d'expirer).
Pour tous les détails, exemples de requêtes et codes d'erreur: enterprise.payflip.be
8. Ce que votre équipe IT doit développer? 🛠️
Deux endpoints, c'est tout :
POST /employees➡️ pour envoyer les données des collaborateursPOST /contracts➡️ pour envoyer les contrats salariaux
Logique upsert : les deux endpoints fonctionnent en upsert. Chaque enregistrement possède une clé unique (employeeKey ou contractKey) que vous définissez et gérez de votre côté. Si la clé existe déjà dans Payflip, l'enregistrement est mis à jour. Sinon, il est créé. Veillez simplement à ce que les clés restent cohérentes à chaque envoi.
Les envois en masse fonctionnent : vous pouvez envoyer plusieurs enregistrements en un seul appel. Si certains enregistrements du lot sont invalides, les valides passent quand même et la réponse vous indique exactement ce qui a réussi, ce qui a échoué, et pourquoi.
L'ordre est important : un enregistrement collaborateur doit exister dans Payflip avant de pouvoir envoyer un contrat salarial pour ce collaborateur.
Pour la référence complète des champs, les champs obligatoires vs. optionnels et les exemples de payloads: enterprise.payflip.be
9. Tester avant le lancement 🧪
Ne déployez pas immédiatement sur l'ensemble de votre population de collaborateurs. Nous recommandons une approche progressive :
Commencez petit : envoyez 5 à 10 collaborateurs et vérifiez que leurs enregistrements apparaissent correctement dans Payflip.
Testez les contrats : envoyez les contrats salariaux pour ces mêmes collaborateurs et confirmez que le lien est correct.
Testez un départ : envoyez un enregistrement collaborateur avec un
endDateEmployeret vérifiez que le marquage apparaît correctement pour votre administrateur RH.Vérification multi-entités (le cas échéant) : envoyez des enregistrements pour différentes entités et confirmez qu'ils arrivent au bon endroit.
Lancez une fois que tout est correct. 🚀
Quelques situations spécifiques 📌
Quelques situations spécifiques 📌
Un collaborateur quitte la société
Renvoyez l'enregistrement collaborateur avec le champ endDateEmployer défini sur son dernier jour. Payflip révoquera son accès à cette date et le marquera pour que votre administrateur RH fasse le suivi.
⚠️ L'API gère le signal, pas le processus complet de départ. Votre admin RH doit encore compléter manuellement la procédure de sortie dans Payflip (des informations sont requises, comme les détails du solde de tout compte, que l'API ne peut pas fournir). Le marquage dans Payflip est leur signal pour agir.
Réembauche d'un ancien collaborateur
Si un collaborateur précédemment désactivé revient, cela ne peut pas être géré via l'API. Contactez l'équipe support de Payflip — elle archivera l'ancien enregistrement et liera le nouveau à votre intégration.
Plusieurs entités juridiques
Pas besoin de plusieurs clés API. Un seul ensemble d'identifiants couvre toutes vos entités. Utilisez simplement le champ companyId sur chaque enregistrement collaborateur pour le diriger vers la bonne entité juridique.
Vous avez envoyé des données incorrectes
Renvoyez le même enregistrement (employeeKey ou contractKey) avec les valeurs correctes et il sera écrasé. Si les données avaient déjà été synchronisées dans Payflip, votre administrateur RH pourrait voir un conflit dans le Module d'intégration qui nécessite une résolution manuelle
Pour toute question, contactez l'équipe support de Payflip via le bouton bleu dans l'outil admin Payflip ou envoyez un e-mail à [email protected]. Si nécessaire, ils vous mettront en contact avec l'équipe technique de Payflip.
Pour la référence technique complète (endpoints, définitions des champs, format requête/réponse, exemples de payloads), consultez la spec API en direct sur enterprise.payflip.be.