Aller au contenu

Intégration paiement · preuve financière

Intégrateur API paiement : faire concorder transaction, commande et finance

Raccordez vos prestataires de paiement à la boutique, à l’ERP et à la comptabilité. Retrouvez la même transaction du checkout au règlement.

Nous cadrons une transaction témoin et vérifions les cas où une réponse tardive, un remboursement partiel ou un écart de montant bloque les équipes.

Domaine de Corps de LoupBoutique, panier, commande et paiement Monetico.
  • Stripe
  • PayPal
  • PrestaShop
  • Odoo

01 / Vos besoins métier

Quelle preuve manque quand un paiement se bloque ?

Le produit, le support et la finance ont chacun besoin d’un état différent. On relie ces états par des références et des montants vérifiables.

Checkout

La boutique confirme avant la capture.

On sépare l’autorisation, la capture et la confirmation commerciale. La boutique affiche le dernier état prouvé.

Remboursement

La finance ne retrouve pas la ligne remboursée.

Le remboursement garde la référence de transaction et les lignes. L’avoir et le versement peuvent être contrôlés indépendamment.

Reprise

Une réponse expire juste après la demande de débit.

On conserve la clé de tentative et vérifie l’effet distant avant toute nouvelle écriture.

Marketplace

Le versement vendeur ne suit pas la commande.

Le flux associe commande, commission et versement à leurs identifiants. Les écarts restent ouverts avec un motif.

Support

Le client et le conseiller voient deux statuts différents.

Le support lit la dernière étape confirmée et les références nécessaires, avec accès limité selon son rôle.

Secrets

Un événement falsifié déclenche une action.

L’interface vérifie la signature prévue par le prestataire et déduplique la notification avant d’appliquer un effet.

02 / Réalisations

Des paiements reliés aux opérations qui en dépendent.

Corps de Loup documente Monetico et Saybus documente Stripe. Les autres études illustrent les états de commande, de facture ou de souscription autour du paiement.

Réalisation / Domaine de Corps de Loup

Le paiement Monetico rejoint la commande de la boutique.

Dawap a développé la boutique Symfony et intégré Monetico au parcours de commande. Le back-office regroupe les opérations du site et la gestion des commandes.

  1. PanierLa boutique transforme la sélection de produits en commande.
  2. PaiementLe parcours de vente intègre Monetico Paiement.
  3. GestionLe back-office permet de retrouver les commandes du site.
Explorer le projet Domaine de Corps de Loup
Boutique, panier, commande et paiement Monetico.Étude du site e-commerce et de son socle d’exploitation.

1UP / Commandes B2B

La facture et l’avoir suivent le cycle de vente.

La commande conserve ses états de réservation, de préparation, d’expédition et de gestion dans Odoo.

Voir le cycle de commande

Opteven / Souscription

Le dossier signé remonte au CRM et à l’ERP.

La souscription automobile coordonne HubSpot, l’ERP et DocuSign autour d’un dossier identifiable.

Voir le parcours de souscription

Saybus / Stripe

Le devis se prolonge par une réservation et un paiement.

La plateforme relie le calcul d’itinéraire, le devis et la commande, puis orchestre le paiement avec Stripe.

Voir le parcours Saybus

03 / Architecture

Module PSP, intégration directe ou orchestration ?

On vérifie les moyens de paiement, le mode de capture, la preuve attendue et le rôle de la comptabilité avant de choisir.

Module du prestataire

Adapté à une boutique et des statuts standards si la couverture des remboursements et des événements suffit.

ExempleUn checkout hébergé avec confirmation de la commande après résultat PSP.

Cadrer ce raccordement

Raccordement direct

Un logiciel métier doit associer ses propres dossiers, montants et états à un prestataire précis.

ExempleCapturer après confirmation d’une réservation ou d’une préparation.

Cadrer ce raccordement

Middleware de paiement

Plusieurs systèmes et prestataires doivent partager des états sans écrire deux fois. Le middleware distingue la transaction et ses effets.

ExempleRapprocher captures et remboursements avec les versements et les écritures ERP.

Voir l’architecture middleware

Flux témoin / Scénario illustratif

Une transaction rapprochée du panier au versement.

  1. 01 / TentativeLa commande conserve une clé de tentative, le montant et la devise attendus.
  2. 02 / Confirmation PSPL’événement signé est vérifié et rapproché de la transaction. L’état distant est relu si nécessaire.
  3. 03 / Effet commercialLa boutique confirme la vente une fois, après la preuve convenue pour ce mode de capture.
  4. 04 / RèglementLa finance rapproche brut, frais, remboursement et versement, sans fermer un écart non résolu.

Payment truth ledger · scénario illustratif

Un paiement n’est terminé que lorsque ses quatre vérités concordent.

Les références, montants et statuts ci-dessous sont fictifs. Le dossier montre la preuve attendue entre intention client, opération PSP, commande et rapprochement financier.

Dossier témoinPAY-2026-0911
Commande
CMD-4821
PSP
Sandbox A
Mode
Capture différée
1 écart à fermer
  1. 00 · intention 184,50 € demandés cart_4821 · EUR Reçue
  2. 01 · autorisation PSP-AUTH-7742 clé pay:cmd-4821:v1 Autorisée
  3. 02 · capture 184,50 € capturés event evt_cap_903 Relue
  4. 03 · refund partiel 34,50 € remboursés refund RF-118 · ligne 03 Propagé
  5. 04 · règlement 145,28 € attendus net 150,00 € · frais 4,72 € À rapprocher
Vérité clientCommande
  • Montant initial184,50 €
  • Retour accepté34,50 €
  • Solde acheté150,00 €

La commande explique ce que le client conserve ; elle ne remplace pas le statut financier.

Vérité opératoirePSP
  • Capture relue184,50 €
  • Refund confirmé34,50 €
  • Net transaction150,00 €

La référence PSP et l’événement reçu ferment chaque transition sans déduire l’état d’une simple réponse.

Vérité de clôtureFinance
  • Net transaction150,00 €
  • Frais illustratifs− 4,72 €
  • Règlement attendu145,28 €

L’écriture reste proposée tant que le règlement ou le rapport fournisseur ne justifie pas le solde.

Banc de contre-tests

Six incidents doivent conserver le même dossier et empêcher un second effet.

  • 01Timeout après demanderechercher avant de recréer
  • 02Double soumissionmême clé, même intention
  • 03Webhook dupliquéun événement, un effet
  • 04Ordre inversérelire l’objet courant
  • 05Refund partielmontants et lignes liés
  • 06Finance indisponibleretenir puis rejouer

Premier lot recommandé

Un parcours, un PSP, un mode de capture et une balance de preuve.

Le lot ne s’étend qu’après une capture, un refund, les six incidents et une reprise réellement jouée avec le produit, le support et la finance.

Cadrer ma transaction témoin

04 / Cadrage et projet

Faire signer le même contrat au produit et à la finance.

Le produit valide les états visibles, la finance les montants et le rapprochement, la DSI les accès. Dawap formalise les effets et réalise la recette avec chaque équipe.

  1. Cadrage

    Choisir un PSP, une devise et un parcours d’encaissement.

    LivrableCarte des états et responsabilités.

  2. Conception

    Relier tentative, capture, commande, avoir et versement.

    LivrableContrat de corrélation et règles de reprise.

  3. Développement

    Vérifier les événements et protéger les écritures répétées.

    LivrableConnecteur, tests et journal sans données de carte.

  4. Recette

    Exercer réponse tardive, doublon et remboursement partiel.

    LivrableBalance rapprochée et effets vérifiés.

  5. Bascule

    Ouvrir un parcours et relire les premières transactions.

    LivrableCritères d’arrêt et consignes de support.

Premier atelier

Cadrer une transaction témoin.

Indiquez votre PSP, le parcours et le dernier écart entre le paiement et la commande. Masquez les informations personnelles et bancaires.

Cadrer mon flux paiement

05 / Recette et bascule

Prouver le montant et l’effet réel dans chaque système.

La recette couvre un échec d’authentification, un délai de réponse, des événements dans le désordre et un remboursement partiel.

Ouvrir le premier flux

  • Une transaction est confirmée une seule fois par la commande.
  • Capture, remboursement et versement ont des références distinctes.
  • Le montant et la devise se rapprochent des pièces métier prévues.

Préparer le retour arrière

  • Suspendre les nouvelles tentatives du parcours pilote et conserver la réception des confirmations.
  • Rechercher les transactions déjà engagées avant toute nouvelle création.
  • Rapprocher les opérations ouvertes et obtenir l’accord de la finance avant la reprise.

Contre-tests / Scénarios illustratifs

Trois scénarios qui doivent produire une preuve financière vérifiable.

Ces scénarios sont des modèles de recette à rejouer avec votre PSP, votre contrat, vos pays et vos règles. Ils ne sont pas présentés comme des capacités identiques chez tous les fournisseurs.

Le PSP a peut-être accepté, mais la réponse n’est jamais revenue.

Scénario terrain
Le client peut rafraîchir et la commande semble encore impayée. Une seconde création aveugle transformerait une coupure réseau en double risque financier.
Architecture
Clé métier stable, journal de tentative, recherche PSP, état intermédiaire et verrou avant nouvel appel.
Livrable
Fixture de paiement, coupure simulée, table de corrélation, opération relue et règle de nouvelle tentative.
Décision
Rechercher puis rapprocher l’opération existante ; isoler si son résultat ne peut pas être prouvé.
Résultat vérifiable
Une seule intention financière et un statut explicable côté commande.

Un ancien événement arrive après une transition plus récente.

Scénario terrain
Une notification répétée ou retardée ne doit ni réexpédier la commande, ni rouvrir un accès, ni écraser un refund déjà confirmé.
Architecture
Signature, persistance brute, identifiant d’événement, inbox, version d’objet et machine d’états métier.
Livrable
Séquence inversée, doublon volontaire, journal d’arbitrage, lecture de contrôle et preuve de l’effet unique.
Décision
Ignorer l’événement déjà consommé ou relire l’objet avant toute transition encore autorisée.
Résultat vérifiable
Un seul effet métier malgré plusieurs notifications.

Le remboursement est demandé, mais le règlement finance reste à fermer.

Scénario terrain
Le support voit une demande, le client attend le résultat et la finance doit distinguer brut, correction, frais et versement réel.
Architecture
Référence de refund, lignes de commande, statut asynchrone, avoir, balance d’écart et rapprochement du règlement.
Livrable
Jeu de montants, résultat PSP, notification client, écriture proposée et écart ouvert avec son owner.
Décision
Ne fermer le refund qu’après résultat confirmé ; garder le règlement séparé jusqu’à sa pièce de rapprochement.
Résultat vérifiable
Un remboursement traçable et une clôture qui n’efface pas l’écart.

06 / Sécurité et infrastructure

Où exploiter votre intégration ?

La DSI valide les secrets du PSP, les droits de remboursement, les séparations de test et de production et l’exclusion des données de carte des journaux.

Vos systèmesSolution chez Dawap

Option 01

Hébergement par Dawap

Convenir du périmètre d’exploitation, de la rotation des secrets et de l’accès aux traces de transaction pour le support autorisé.

Vos systèmesSolution dans votre SI

Option 02

Déploiement dans votre SI

Valider le point d’entrée des notifications, les sorties PSP, le coffre de secrets et les alertes dans les outils de la DSI.

07 / Suivi en production

Détecter un écart financier sans déclencher de second débit.

On surveille les captures sans commande, les remboursements en attente et les écarts de règlement. L’alerte distingue décision produit et correction comptable.

Support / Identifier l’opération

Rassembler la référence et l’état visible, puis suspendre toute nouvelle tentative sur le dossier.

Finance / Confirmer les montants

Vérifier devise, capture et versement dans les sources financières.

Intégrateur / Reprendre l’effet manquant

Relire le PSP et la commande avant d’autoriser une écriture unique.

Journal illustratifTransaction PAY-307 : capture signalée après expiration.
  1. Reçue

    La tentative et le montant sont enregistrés avec la référence de commande.

  2. Incertaine

    La réponse expire. Le dossier reste en attente et aucun nouveau débit n’est demandé.

  3. Rapprochée

    La lecture PSP confirme la capture. La commande reprend sur la transaction existante.

09 / Guides et exemples

Approfondir le contrat, l’idempotence, les refunds et le modèle plateforme.

Ces guides détaillent le contrat de paiement, la prévention des doublons, les remboursements et les flux d’une plateforme.

Paiement API : intégrer un PSP sans casser le run Intégration API Paiement API : intégrer un PSP sans casser le run Lire l'article
  • 19 août 2024
  • Lecture ~25 min

Le paiement via API ne se résume pas à encaisser. Il faut cadrer PaymentIntents, captures, refunds, webhooks, idempotence, wallets, KYC et réconciliation sans transformer le support en table de reprise manuelle. Ce cadrage protège marge, trésorerie et taux d’acceptation avec une preuve de reprise exploitable.

Idempotence API : éviter les doublons métier Intégration API Idempotence API : éviter les doublons métier Lire l'article
  • 25 mai 2025
  • Lecture ~46 min

Une intégration API peut sembler fonctionner correctement pendant des semaines, puis générer soudainement des doublons de commandes, de paiements ou d’écritures comptables. Ce type d’incident coûte rarement seulement du temps technique. Il mobilise aussi le support, la finance et le commerce dans le run métier.

Stripe API paiements refunds frais factures Intégration API Stripe API : rapprochement finance Lire l'article
  • 17 mai 2024
  • Lecture ~12 min

Stripe doit expliquer le cash, pas seulement encaisser. PaymentIntent, refunds, frais, balance transactions, factures, litiges et payouts doivent être rapprochés avec les commandes et la compta. L'article montre comment éviter les écarts finance et les réponses support impossibles à prouver vite en B2B.

PSP marketplace Stripe Connect Mangopay Lemonway Intégration API PSP marketplace : Stripe, Mangopay ou Lemonway Lire l'article
  • 8 juillet 2026
  • Lecture ~13 min

Stripe Connect, Mangopay et Lemonway ne se choisissent pas au logo. L'article aide à arbitrer selon wallets, KYC/KYB, payouts, commissions, refunds, litiges, finance, support, preuve comptable et capacité de run marketplace. Il donne une grille claire pour choisir le PSP opérable avant de figer l'architecture.

Vos questions / FAQ

Questions fréquentes sur l’intégration API paiement

Encaissement, remboursement, rapprochement et mise en service.

Périmètre et événements PSP

Qu’est-ce qu’un intégrateur API paiement ?

Il conçoit le contrat et le middleware entre le PSP et les systèmes qui dépendent de la transaction : commande, support, ERP ou finance. Il corrèle identités, statuts, événements, refunds, preuves et reprises.

Pourquoi passer par une agence API paiement plutôt qu’un module PSP ?

Un module peut suffire pour un checkout standard. L’intégration sur mesure devient utile quand l’état doit rester cohérent entre PSP, commande, remboursements, support et finance, avec des règles et une reprise propres à votre SI.

Comment gérez-vous les webhooks de paiement ?

Le contrat dépend du fournisseur. En général, nous vérifions l’authenticité selon sa méthode officielle, conservons le payload utile, dédupliquons l’événement, traitons l’effet en asynchrone et relisons l’objet lorsque l’ordre compte.

Exceptions et reprise

Comment éviter un double débit après un timeout ?

Le connecteur conserve une clé stable, journalise la tentative et recherche ou relit l’opération avant tout nouvel appel. Une réponse absente reste un état inconnu à rapprocher, jamais une preuve que le PSP n’a rien fait.

Comment rapprocher un refund partiel ?

La demande, le résultat PSP, les lignes concernées, l’avoir éventuel et le règlement restent séparés mais corrélés. Le dossier ne se ferme que lorsque le montant remboursé et son effet financier sont prouvés.

Comment reprendre une intégration paiement existante sans risquer la production ?

Dawap commence en lecture et cartographie statuts, identités, événements, secrets, erreurs et reprises. Une transaction témoin, un environnement de test, des contre-tests et une bascule progressive précèdent toute extension.

Choix et exploitation

Comment comparer deux prestataires de paiement ?

On compare modes de capture, devises, pays, abonnements, remboursements et données de rapprochement sur votre parcours réel. La recette inclut les erreurs que le support doit savoir traiter.

Comment préparer une migration de PSP ?

On sépare les nouvelles transactions des paiements déjà engagés. Les remboursements et les rapprochements historiques gardent les références et accès nécessaires jusqu’à leur clôture.

Quel système déclenche le remboursement ?

Le cadrage désigne l’outil et le rôle autorisés à le demander. Le prestataire confirme l’effet financier et le dossier commercial se met à jour après le résultat convenu.

Quels sont les critères pour chiffrer une intégration ?

Le coût dépend des moyens de paiement, du nombre de parcours et prestataires, des effets ERP, des contre-tests et du niveau d’exploitation prévu. Un flux représentatif donne une base de chiffrage.

Les profils derrière votre projet

Des interlocuteurs qui comprennent vos flux et votre métier.

Votre sujet : Intégration API paiement : connecteur PSP et ERP

Relier un ERP, un CRM ou une application métier demande de trancher les responsabilités autant que les contrats de données. Nous rapprochons architecture, usages et priorités pour livrer des échanges testables et maintenables.

Découvrir l’agence
Portrait de Jérémy Chomel

Direction · architecture

Jérémy Chomel

Conception des API et middlewares, mapping, reprise sur erreur, observabilité et mise en production.

  • API
  • Architecture
  • DevOps
Portrait d’Arnault Frier

Direction · produit

Arnault Frier

Analyse des processus métier, choix du premier flux utile et accompagnement des utilisateurs.

  • Produit
  • Cadrage
  • Formation
Portrait de Loïc Orue

Product Owner / Scrum Master

Loïc Orue

Product Owner / Scrum Master : backlog d’intégration, dépendances SI, recette et coordination des parties prenantes.

  • PO
  • Scrum
  • Backlog

Consultant senior mobilisable

La composition de l’équipe et sa disponibilité sont confirmées selon votre périmètre, les accès nécessaires et le niveau de service attendu.

Votre premier échange

Votre connecteur peut-il prouver ce que le PSP, la commande et la finance ont réellement accepté ?

Dawap cadre une transaction, ses identités, ses statuts, ses six contre-tests, sa balance de preuve et sa reprise avant d’ouvrir le reste des parcours.