Comment intégrer l'API SumUp ?

SumUp est une société de technologie de paiement et gestion caisse, utilisée par des millions de commerçants à travers l'Europe et au-delà pour accepter les paiements par carte en magasin et en ligne. Pour les éditeurs de logiciels qui servent des marchands PME, une intégration SumUp ouvre des flux de données financières puissants directement dans votre produit.

Intégrer l'API SumUp vous permet de :

• Récupérer automatiquement les données de transactions et de virements pour la réconciliation ou le reporting
• Accéder aux informations marchands et clients pour alimenter vos flux financiers
• Synchroniser les données de paiement avec un logiciel de comptabilité pour automatiser la saisie comptable
• Construire des outils de prêt ou de gestion de trésorerie à partir de données de ventes réelles

Ce guide couvre tout ce que vous devez savoir sur l'API SumUp : configuration technique, bonnes pratiques, et comment l'API caisse Unifiée de Chift vous aide à éviter le travail le plus fastidieux.

Qu'est-ce que l'API SumUp ?

SumUp expose plusieurs surfaces d'API distinctes, toutes basées sur REST. Chez Chift, nous utilisons la Core REST API, qui alimente notre connecteur SumUp et couvre les principaux flux de données transactionnelles et marchands.

L'API communique en JSON via HTTP standard, en utilisant des URLs orientées ressources et des codes de statut HTTP conventionnels. L'URL de base est https://api.sumup.com.

Les principaux groupes de ressources disponibles via l'API sont :

• Transactions: enregistrements individuels de paiements par carte
• Payouts (virements): données de règlement envoyées aux comptes bancaires marchands
• Checkouts; sessions de paiement en ligne
• Customers (clients): profils clients enregistrés
• Receipts (reçus): données de reçus numériques
• Readers (lecteurs): gestion des terminaux de carte (matériel)
• Merchants (marchands): données de compte et profil marchand
• Members, Memberships, Roles: gestion des utilisateurs et des accès
• Subaccounts (sous-comptes): structures marchands multi-établissements

Chez Chift, nous utilisons principalement l'API SumUp pour lire les transactions, les virements et les données marchands, les trois types de données qui alimentent la plupart des cas d'usage paiements-comptabilité et paiements-fintech.

L'authentification est gérée via OAuth2. Pour se connecter, le client doit fournir un Client ID et un Client Secret, utilisés pour obtenir des tokens d'accès lors des appels API.

Pour la référence technique complète, consultez la documentation API SumUp.

{{CTA-1}}

Exemples de cas d'usage de l'intégration API SumUp

Réconciliation automatique des transactions pour les plateformes comptables

Les solutions de comptabilité et de pré-comptabilité peuvent extraire les données de transactions SumUp via Chift pour réconcilier automatiquement les paiements par carte avec les factures ou les écritures comptables. Cela supprime les exports CSV manuels et réduit considérablement l'administration de fin de journée pour les commerçants et leurs comptables.

Visibilité sur la trésorerie pour les outils de gestion financière

Les outils de gestion de trésorerie et de prévision financière peuvent utiliser les données de virements SumUp pour donner aux commerçants une vue en temps réel de leurs fonds entrants. Au lieu d'attendre les relevés bancaires, votre produit peut afficher ce qui a été traité, réglé et en attente, le tout en un seul endroit.

Données de transactions pour les plateformes de prêt aux entreprises

Les prêteurs aux entreprises et les plateformes fintech peuvent utiliser l'historique des transactions SumUp pour évaluer le chiffre d'affaires des marchands, identifier des tendances et prendre des décisions de crédit basées sur les données. Les données de ventes réelles d'un terminal de carte comptent parmi les indicateurs les plus fiables de la santé d'une entreprise, ce qui fait de SumUp une source précieuse pour les flux de prêt intégré.

‍

Pour plus d'exemples de comment les intégrations paiements peuvent améliorer votre produit, explorez nos études de cas Chift.

Configurer votre intégration API SumUp

Pour vous connecter à l'API SumUp, vous devez configurer une application OAuth2 et obtenir des identifiants depuis le portail développeur SumUp.

Voici comment démarrer :

1. Créez un compte développeur sur developer.sumup.com.
2. Enregistrez votre application pour recevoir un Client ID et un Client Secret.
3. Implémentez le flux d'autorisation OAuth2 pour obtenir des tokens d'accès au nom de vos marchands.
4. Utilisez le token d'accès dans l'en-tête Authorization: Bearer pour chaque requête API.
5. Gérez la logique de rafraîchissement des tokens pour maintenir un accès persistant sans nécessiter une nouvelle authentification.

Si l'API SumUp est bien documentée et accessible, les intégrations en production nécessitent bien plus qu'une simple connexion. Vous devrez gérer le cycle de vie des tokens, la normalisation des données entre marchands, les architectures multi-tenant, la gestion des erreurs et la maintenance continue de l'API, en particulier à mesure que SumUp fait évoluer ses endpoints.

Bonnes pratiques pour l'intégration API SumUp

• Utilisez les endpoints versionnés et non dépréciés. SumUp expose des versions actuelles et dépréciées pour les transactions et les virements (ex. /api/transactions/list vs /api/transactions/list-deprecated). Utilisez toujours les chemins non dépréciés : ils retournent des données plus riches et resteront supportés.
• Stockez les identifiants de façon sécurisée. Les clés API et les identifiants OAuth doivent être stockés dans des variables d'environnement, jamais codés en dur dans votre application. Ne les exposez jamais dans du code côté client, des dépôts publics ou des environnements navigateur.
• Implémentez un backoff exponentiel pour les erreurs de rate limiting. SumUp ne publie pas de limites numériques spécifiques, mais l'API retourne 429 Too Many Requests en cas de dépassement. Construisez une logique de retry avec backoff exponentiel pour gérer ces cas proprement.
• Normalisez les données marchands dès le départ. Les modèles de données marchands peuvent varier entre sous-comptes et contextes d'intégration. Standardisez votre modèle de données interne tôt pour éviter les incohérences en aval, surtout si vous connectez plusieurs marchands via le même pipeline.
• Limitez les permissions OAuth au strict nécessaire. Demandez uniquement les scopes OAuth dont votre intégration a réellement besoin. Cela réduit les risques de sécurité et respecte le principe du moindre privilège.

Pourquoi intégrer SumUp via Chift ?

Construire une intégration SumUp directe est facile à démarrer. Mais une fois que vous avez géré la logique de rafraîchissement des tokens OAuth2, la pagination, les retries sur les limites de débit, la normalisation des données multi-marchands et les inévitables dépréciations d'endpoints, vous devez encore maintenir tout cela à mesure que l'API évolue. Et recommencer pour chaque autre outil de paiement sur votre roadmap.

Avec l'API Paiements Unifiée de Chift, vous intégrez une fois et accédez à SumUp, Stripe, Mollie, Square, MyPOS et bien d'autres, via le même modèle de données normalisé.

Voici ce que cela change concrètement pour votre équipe :

• Votre équipe engineering construit une seule intégration, puis reste concentrée sur votre produit
• Les nouveaux connecteurs s'activent en un clic, sans développement supplémentaire
• L'authentification, la gestion des erreurs et le mapping des données sont entièrement gérés par Chift
• Monitoring intégré, journalisation et maintenance à long terme inclus
• Support expert d'une équipe qui comprend à la fois les aspects techniques et business des intégrations financières

Votre équipe dev gagne du temps. Votre équipe commerciale peut dire oui à plus de demandes d'intégration. Et votre produit devient le choix évident pour les clients qui ont besoin que leurs données de paiement circulent.

Vous voulez voir comment Chift connecte votre produit à SumUp et plus de 50 autres outils financiers ? Contactez notre équipe pour en savoir plus.

FAQ de l'intégration API SumUp

Quels endpoints sont disponibles dans l'API SumUp via Chift ?

Le connecteur SumUp de Chift expose un ensemble standardisé d'endpoints couvrant les données de paiement les plus importantes, notamment :

• Transactions /transactions
• Virements /payouts
• Marchands /merchants

Consultez notre documentation API SumUp pour la liste complète des routes disponibles.

Quelles sont les limites de débit de l'API SumUp ?

SumUp ne publie pas de limites numériques spécifiques dans sa documentation officielle. L'API retourne 429 Too Many Requests en cas de dépassement. La gestion recommandée est d'implémenter une logique de retry avec backoff exponentiel. Augmentez progressivement le délai entre chaque tentative plutôt que de relancer immédiatement.

Quelle API de paiement est gratuite ?

L'API SumUp n'a pas de frais d'accès ou d'abonnement : vous payez uniquement par transaction traitée. Stripe, Square et PayPal suivent le même modèle. Les API de paiement véritablement gratuites (sans frais de transaction) n't'existent pas pour le traitement commercial par carte, car les frais d'interchange doivent toujours être couverts par quelqu'un. Certaines API de virement bancaire ou d'open banking, comme GoCardless, peuvent proposer des tarifs très bas en alternative.

Qui est propriétaire de SumUp ?

SumUp est une société fintech privée soutenue par ses fondateurs et un consortium d'investisseurs institutionnels mondiaux.

Dans quel pays SumUp est-il basé ?

SumUp est une société de technologie financière britannique dont le siège social est à Londres, avec une forte présence en Europe et sur les marchés internationaux.

Quel pourcentage prend SumUp ?

Pour les paiements en personne, le taux de transaction standard de SumUp est de 1,69 %. Pour les paiements en ligne (liens de paiement, réservations, produits numériques), le taux est de 2,50 % par transaction. Avec l'abonnement Payments Plus (19 £/mois), le taux en personne descend à 0,99 % pour les cartes grand public domestiques (les cartes internationales, corporate et AMEX restent à 1,69 %). Il n'y a pas de frais d'installation, de frais mensuels sur le plan standard, ni de frais pour les transactions refusées. Consultez la page tarifaire de SumUp pour tous les détails.

Peut-on intégrer SumUp avec Shopify ?

Oui, mais pas nativement. Cela nécessite un connecteur tiers. SumUp et Shopify n'ont pas d'intégration native directe, donc la connexion des deux passe généralement par une couche middleware ou un connecteur tiers.

SumUp peut-il s'intégrer avec d'autres applications ?

Oui. SumUp permet aux tiers d'intégrer son infrastructure de paiement de bout en bout via son API développeur, permettant une grande variété d'intégrations avec des outils de comptabilité, ERP, CRM et fintech.

Quels logiciels de comptabilité fonctionnent avec SumUp ?

SumUp a un partenariat officiel avec Xero, permettant aux marchands de synchroniser leur historique de ventes sans frais supplémentaires (les abonnés SumUp One bénéficient également d'une réduction exclusive de 90 % sur leurs six premiers mois de Xero). SumUp POS s'intègre aussi avec QuickBooks, permettant aux utilisateurs de synchroniser les données de ventes pour les déclarations de TVA et les rapports financiers directement depuis leur tableau de bord. Pour une connectivité comptable plus large vers d'autres plateformes, l'API Paiements Unifiée de Chift peut faire le lien entre les données SumUp et d'autres outils comptables.

‍