Comment connecter KdoFid à SumUp

SumUp est la solution de paiement favorite des petits commerces, auto-entrepreneurs et marchés ambulants. Si vous utilisez SumUp pour encaisser vos clients, ce guide vous montre comment synchroniser votre terminal SumUp avec KdoFid afin que chaque paiement génère automatiquement des points de fidélité. Aucune compétence technique requise.

Temps estimé : 15 à 25 minutes

Sommaire

• Prérequis
• Étape 1 : Préparer votre compte SumUp
• Étape 2 : Générer votre clé API KdoFid
• Étape 3 : Activer l'intégration SumUp dans KdoFid
• Étape 4 : Configurer le crédit automatique de points
• Étape 5 : Valider la connexion avec un paiement test
• Problèmes fréquents et solutions
• Conclusion

Prérequis

Pour connecter KdoFid à SumUp, vous aurez besoin de :

• Un compte KdoFid actif (offre Pro ou Enterprise)
• Un compte SumUp actif avec au moins un terminal configuré
• L'application SumUp installée sur votre smartphone ou tablette (version 4.0 minimum)
• Votre programme de fidélité KdoFid déjà créé et actif
• Un accès administrateur sur les deux comptes

Compatibilité SumUp : KdoFid est compatible avec SumUp Air, SumUp Solo, SumUp 3G et SumUp POS. L'intégration fonctionne via l'API SumUp — votre terminal n'a besoin d'aucune mise à jour matérielle.

Étape 1 : Préparer votre compte SumUp

Avant de configurer l'intégration dans KdoFid, vous devez activer l'accès API dans votre compte SumUp et créer les autorisations nécessaires.

Accès au portail développeur SumUp :

1. Rendez-vous sur developer.sumup.com
2. Cliquez sur "Sign In" et connectez-vous avec vos identifiants SumUp habituels
3. Une fois connecté, cliquez sur "Create Application" (ou "Mes applications" si vous en avez déjà une)

Création d'une application SumUp :

1. Cliquez sur "+ New Application"
2. Remplissez le formulaire :

- Application Name : KdoFid Fidélité

- Description : Programme de fidélité automatique

- Redirect URI : https://app.kdofid.fr/integrations/sumup/callback (copiez cette URL exactement)

1. Cliquez sur "Create"

1. Sur la page de votre nouvelle application, notez les informations suivantes :

- Client ID (identifiant de l'application)

- Client Secret (secret de l'application — affiché une seule fois)

Note importante : Contrairement à d'autres plateformes, SumUp nécessite d'accorder explicitement les autorisations d'accès depuis l'application mobile SumUp. Cette étape se fait à l'Étape 3.

Vérification du compte marchand SumUp :

Assurez-vous que votre compte SumUp est bien vérifié (identité confirmée, IBAN renseigné). Un compte non vérifié peut bloquer les appels API même si les identifiants sont corrects.

Étape 2 : Générer votre clé API KdoFid

En parallèle, préparez votre clé API KdoFid dédiée à l'intégration SumUp.

Dans votre tableau de bord KdoFid :

1. Connectez-vous à app.kdofid.fr
2. Allez dans Paramètres > API et intégrations
3. Cliquez sur "Créer une clé API"
4. Nommez-la : SumUp - [Nom de votre commerce]
5. Environnement : Production (live)
6. Permissions à activer :

- transactions:write

- customers:read

- customers:write

- rewards:read

- rewards:write

1. Cliquez sur "Générer la clé" et copiez la clé immédiatement

Vous disposez maintenant des informations des deux plateformes. Passons à la configuration de l'intégration.

Étape 3 : Activer l'intégration SumUp dans KdoFid

Depuis le tableau de bord KdoFid :

1. Allez dans Paramètres > API et intégrations
2. Dans la section "Intégrations prêtes à l'emploi", repérez la carte "SumUp"
3. Cliquez sur "Connecter SumUp"

L'assistant de connexion SumUp s'ouvre en 3 étapes :

Assistant — Étape A : Saisie des identifiants SumUp

Renseignez les champs avec les informations récupérées à l'étape 1 :

• Client ID SumUp : collez votre Client ID
• Client Secret SumUp : collez votre Client Secret

Cliquez sur "Autoriser SumUp". Une fenêtre de consentement SumUp s'ouvre dans votre navigateur (ou vous êtes redirigé vers sumup.com).

Autorisation OAuth SumUp :

Dans la fenêtre de consentement SumUp :

1. Connectez-vous à votre compte SumUp si ce n'est pas déjà fait
2. Lisez les permissions demandées par KdoFid :

- Accès à votre historique de transactions

- Accès aux informations de votre compte marchand

1. Cliquez sur "Autoriser" (ou "Allow")

Vous êtes automatiquement redirigé vers votre tableau de bord KdoFid. L'étape A se marque comme complétée.

Assistant — Étape B : Sélection du compte SumUp

Si vous avez plusieurs comptes SumUp (plusieurs commerces), sélectionnez dans la liste déroulante le compte marchand à connecter à ce programme KdoFid.

Assistant — Étape C : Paramétrage de la synchronisation

Définissez comment KdoFid traite les données SumUp :

• Identificateur client : Choisissez comment identifier le client dans SumUp :

- Par numéro de téléphone (renseigné lors du paiement SumUp)

- Par email (si vous avez activé l'envoi de reçu par email dans SumUp)

• Délai de synchronisation : Les points peuvent être crédités :

- Instantanément dès la confirmation du paiement (recommandé)

- Après un délai de X heures (utile pour les commerces avec taux de retour important)

Cliquez sur "Finaliser la connexion".

Confirmation KdoFid : La carte SumUp dans votre tableau de bord affiche le statut "Connecté" avec l'heure de la dernière synchronisation. Votre intégration est active.

Étape 4 : Configurer le crédit automatique de points

L'intégration est établie, mais vous devez encore définir les règles selon lesquelles les points sont attribués.

Depuis Paramètres > API et intégrations > SumUp > Règles de points :

Règle principale :

Définissez le ratio de conversion :

• 1 point par euro dépensé — règle simple et facile à communiquer
• X points par euro — adaptez selon votre programme
• 1 point par transaction — pour les commerces à tickets faibles (boulangeries, cafés)

Montant minimum :

• Fixez un montant minimum de transaction pour éviter les micro-achats (recommandé : 2€ minimum)
• Laissez à 0 si vous souhaitez récompenser toutes les transactions sans exception

Produits ou catégories exclus :

Si certains de vos produits SumUp ne doivent pas générer de points (promotion déjà avantageuse, produits réglementés), activez les exclusions et sélectionnez les catégories concernées depuis votre catalogue SumUp.

Points de bienvenue pour les nouveaux clients :

Si un paiement SumUp est effectué par un client qui n'existe pas encore dans KdoFid, KdoFid peut :

• Créer automatiquement sa fiche client et créditer les points (recommandé)
• Ignorer la transaction jusqu'à ce que le client s'inscrit manuellement

Activez ou désactivez l'option "Création automatique de client" selon votre préférence.

Cliquez sur "Enregistrer les règles" pour valider.

Étape 5 : Valider la connexion avec un paiement test

Avant de mettre en service l'intégration auprès de vos vrais clients, effectuez un test grandeur nature.

Réalisation du paiement test :

1. Ouvrez l'application SumUp sur votre terminal
2. Créez une transaction de test (exemple : 1€ ou le montant minimum de votre règle)
3. Au moment de l'encaissement, saisissez le numéro de téléphone ou email d'un compte client test que vous avez créé dans KdoFid
4. Finalisez le paiement normalement

Vérification dans KdoFid :

1. Connectez-vous à app.kdofid.fr
2. Allez dans Clients et recherchez votre client test
3. Ouvrez sa fiche et consultez l'onglet "Historique de points"
4. La transaction SumUp doit apparaître en moins d'une minute avec :

- La date et l'heure du paiement

- Le montant de la transaction

- Le nombre de points crédités

- La source : "SumUp - [Nom de votre commerce]"

Si la transaction apparaît correctement : votre intégration est 100% fonctionnelle.

Vérification des logs :

Pour un suivi détaillé, consultez Paramètres > API et intégrations > SumUp > Logs. Chaque appel API y est enregistré avec son statut (succès/erreur) et les données échangées.

Problèmes fréquents et solutions

Q: L'autorisation OAuth SumUp échoue avec le message "Redirect URI mismatch".

R: Ce message signifie que l'URL de callback saisie dans votre application SumUp (Étape 1) ne correspond pas exactement à celle attendue. Retournez dans le portail développeur SumUp, ouvrez votre application KdoFid, et vérifiez que le champ "Redirect URI" contient exactement : https://app.kdofid.fr/integrations/sumup/callback — sans espace, sans majuscule, sans slash final. Enregistrez et relancez la connexion.

Q: Les points ne sont pas crédités pour les paiements SumUp en mode hors ligne.

R: Lorsque votre terminal SumUp fonctionne hors ligne (zone sans réseau), les transactions sont stockées localement et synchronisées avec les serveurs SumUp dès la reconnexion. KdoFid reçoit ces transactions avec un léger délai (quelques minutes à quelques heures selon la durée de la coupure réseau). Les points seront bien crédités, mais pas instantanément. Ce comportement est normal et ne nécessite aucune action de votre part.

Q: Comment faire si un client oublie de donner son numéro lors du paiement SumUp ?

R: Si un client n'a pas été identifié lors du paiement, il est possible d'attribuer les points manuellement a posteriori. Depuis votre tableau de bord KdoFid, allez dans Clients > [Nom du client] > Ajouter des points manuels, saisissez le nombre de points correspondant à l'achat et ajoutez une note pour justifier l'ajout. Cette procédure est disponible pour les 30 derniers jours de transactions. Pour les transactions plus anciennes, contactez le support KdoFid.

Conclusion

Votre terminal SumUp est maintenant connecté à KdoFid. Chaque paiement effectué via SumUp génère automatiquement des points sur la carte de fidélité de votre client — sans manipulation supplémentaire, sans formulaire, sans saisie.

Cette intégration est particulièrement précieuse pour les commerces qui utilisent SumUp en mode mobile (marchés, livraisons, événements) : vos clients fidèles accumulent des points où que vous soyez, et votre programme de fidélité fonctionne en toutes circonstances.

Pour optimiser davantage votre expérience, pensez à activer les notifications SMS ou email dans KdoFid afin que vos clients reçoivent automatiquement un message confirmant leurs points après chaque paiement SumUp.

Prêt à lancer votre programme de fidélité ?

Créez votre compte KdoFid gratuitement →

Article mis à jour le 2026-03-01. Catégorie : Guides pratiques. Temps de lecture : 9 min.