Aller au contenu

PayPal · commandes, captures et remboursements

Intégrateur PayPal API pour fiabiliser orders, captures et refunds

Un retour checkout ne suffit plus à prouver le cash. Dawap relie les commandes PayPal, les captures et les remboursements à vos factures et à votre support.

Vos équipes distinguent le paiement capturé du versement reçu et retrouvent la preuve utilisée pour chaque décision.

  • PayPal
  • Odoo
  • Symfony
  • RabbitMQ
  • OpenAPI

L’intégration

Une intégration API PayPal sur mesure relie le checkout à une preuve serveur et au cash.

Dawap conçoit le middleware qui corrèle commande, PayPal Order, autorisation ou capture, webhooks, refunds et disputes avec votre ERP et votre support. Le flux utilise des identifiants d’idempotence quand l’endpoint le permet, vérifie les événements et relit la ressource avant de déclencher une livraison, un avoir ou une reprise.

  • Distinguer création, approval, autorisation, capture et effet métier au lieu d’écraser le parcours dans “payé”.
  • Conserver Order ID, capture ID, event ID, PayPal-Request-Id et référence interne pour expliquer chaque transition.
  • Vérifier l’authenticité des webhooks, dédupliquer leur effet et répondre en 2xx après prise en charge durable.
  • Rapprocher refunds, disputes, frais et écritures sans promettre qu’une capture prouve déjà le versement bancaire.

Parcours PayPal

Retrouver la preuve du paiement dans le SI

E-commerce, capture différée, remboursement et plateforme peuvent partager PayPal sans partager le même statut libératoire ni la même équipe propriétaire.

  • E-commerce

    Libérer une commande sur la bonne preuve

    Le retour acheteur, l’Order, la capture et le webhook sont réconciliés avant préparation, facture ou notification.

    Moins de commandes “payées” uniquement dans un écran.

  • Capture différée

    Autoriser puis capturer au jalon métier

    Stock, risque, expédition ou réalisation commandent la capture ; expiration et void suivent une règle visible.

    Une décision de cash alignée avec l’engagement opérationnel.

  • Après-vente

    Rembourser sans perdre le restant ni l’avoir

    Le refund total ou partiel repart de la capture, conserve sa clé, met à jour le solde et attend la pièce métier prévue.

    Un support qui ne rembourse pas deux fois.

  • Marketplace

    Séparer checkout PayPal et modèle de plateforme

    Vendeur, commission, reversement, litige et responsabilité opérateur sont cadrés dans l’architecture marketplace appropriée.

    Aucune promesse de plateforme déduite du seul bouton PayPal.

Cash evidence desk · scénario illustratif

Le checkout est terminé. La commande reste bloquée tant que la capture n’est pas réconciliée.

Le marchand, l’acheteur, les montants et tous les identifiants ci-dessous sont fictifs. Ce pupitre matérialise les décisions d’un flux PayPal ; il ne reproduit ni un compte ni une transaction réelle.

DOSSIER PAY-2409Commande COM-7842 · EUR · environnement de recette

À RÉCONCILIER
Vue 01 · retour acheteur

Un retour réussi ne suffit pas à libérer la commande.

PP
PayPal checkout · témoinPaiement approuvé
Commande
COM-7842
Montant
248,00 EUR
Order ID
5O•••15T
Retour navigateur
10:14:06

APPROVED≠ CASH ACQUIS

Règle : le front confirme une étape du parcours. Seule la politique serveur décide si une autorisation ou une capture permet d’ouvrir préparation, facture ou service.

Vue 02 · chaîne d’identifiants

Quatre références doivent conduire au même dossier.

01SI métierCOM-7842COMMANDE
02Orders v25O•••15TORDER
03Payments v23Y•••303CAPTURE
04FinanceFAC-2026-184PIÈCE
Attendu
248,00 EUR
Brut capturé
248,00 EUR
Frais observés
à importer
Net rapproché
EN ATTENTE
Vue 03 · ordre de libération

Cinq preuves avant de promettre que la commande est payée.

  1. 01
    RéférenceOrder lié à COM-7842
    PASS
  2. 02
    IntentionCAPTURE attendue
    PASS
  3. 03
    Montant248,00 EUR concordants
    PASS
  4. 04
    IdempotenceRequest ID connu
    PASS
  5. 05
    Preuve serveurCapture à relire
    HOLD
Vue 04 · chronologie de preuve

La réception HTTP et l’effet financier ne partagent pas la même horloge.

  1. Order créérequest PAY-2409/CREATE · réponse 201
    API
  2. Acheteur revenustatut APPROVED · aucune libération
    FRONT
  3. Capture demandéetimeout client · même PayPal-Request-Id conservé
    UNKNOWN
  4. Webhook reçuPAYMENT.CAPTURE.COMPLETED · signature valide
    EVENT
  5. Capture relue3Y•••303 · statut COMPLETED
    PROOF
Vue 05 · après la capture

Trois écarts qui ne doivent jamais devenir un simple statut “annulé”.

REF-17Refund partiel

Relire la capture, le restant remboursable, la ligne de commande et l’avoir avant toute nouvelle opération.

RAPPROCHER
DSP-04Dispute ouverte

Rattacher motif, échéance, montant et pièces au support et à la finance sans conclure automatiquement.

ASSIGNER
WEB-31Webhook rejoué

Vérifier signature, event ID et décision déjà appliquée ; répondre sans produire une seconde action métier.

DÉDUPLIQUER
01Double clicUne seule création
02Timeout captureRelire avant retry
03Signature invalideÉvénement refusé
04Refund partielSolde contrôlé
05Dispute tardiveDossier rouvert
Vue 06 · sources officielles relues le 9 septembre 2026

Ce que PayPal expose — et ce que votre SI doit encore décider.

Orders v2

Les statuts documentés distinguent notamment CREATED, APPROVED, VOIDED, COMPLETED et PAYER_ACTION_REQUIRED.

Idempotence

PayPal-Request-Id protège les appels compatibles contre une nouvelle exécution ; son support et sa durée de conservation se vérifient endpoint par endpoint.

Webhooks

Le listener HTTPS doit répondre en 2xx et vérifier l’authenticité du message. PayPal documente des reprises pouvant aller jusqu’à 25 livraisons sur trois jours.

Payments v2

Le remboursement total ou partiel part de l’identifiant de capture ; son propre identifiant et son statut restent à rapprocher du dossier métier.

Premier lot recommandé

Une commande, une capture, un refund partiel et cinq ruptures exercées.

Apportez le paiement qui oblige aujourd’hui support, finance et e-commerce à comparer PayPal avec le back-office. Le cadrage fixe les références, le statut libératoire, les écritures et la reprise avant d’élargir les moyens de paiement.

Cadrer mon paiement témoin

Premier lot

Suivre une commande PayPal jusqu’à la clôture

On qualifie la source de vérité, les objets, les droits, les volumes, les erreurs et la reprise attendue. Vous obtenez un premier lot décidable, proportionné au risque métier et au run réel.

Périmètre et livrables

  • Cartographie source, cible, objets, identifiants et responsabilités.
  • Vérification des accès, scopes, webhooks, quotas et contraintes fournisseur.
  • Choix du pattern : connecteur direct, middleware, file, batch ou API métier.
  • Critères de recette, logs, alertes, reprise et documentation attendue.
Ce que Dawap livre pour rendre le paiement exploitable après le succès du checkout.
  • Cartographie du compte, des applications REST, credentials, Orders v2, Payments v2, webhooks, environnements et systèmes propriétaires.
  • Contrats de données pour commande, Order, authorization, capture, refund, dispute, event, montant, devise et pièce finance.
  • Middleware avec OAuth, PayPal-Request-Id, relecture après timeout, vérification webhook, déduplication et transitions autorisées.
  • Journal expurgé, dashboard d’écarts, alertes actionnables, quarantaine et outils de reprise ciblée pour support et finance.
  • Recette nominale et dégradée, documentation d’exploitation, rotation des secrets, transfert de connaissances et runbook.

Méthode

Recouper les preuves du support et de la finance

Dawap réunit e-commerce, finance, support et IT autour d’un paiement réel anonymisé. On nomme le statut qui libère la commande, les identifiants indispensables, les opérations réversibles, les délais et le propriétaire de chaque écart. Le choix des endpoints et des événements vient ensuite.

Order et commande

Référence métier, montant, devise, purchase unit, intention et version du panier restent reliés à l’Order PayPal.

Autorisation ou capture

La règle indique si le métier attend une autorisation, une capture immédiate, une capture différée ou un void.

Idempotence bornée

Chaque mutation compatible reçoit un PayPal-Request-Id propre au type d’appel ; un doute déclenche une relecture avant reprise.

Webhook vérifié

Headers, corps brut, webhook ID et signature sont contrôlés ; event ID et décision appliquée restent traçables.

Refund et dispute

Montant, capture d’origine, avoir, motif, échéance et dossier support restent attachés au même historique.

Rapprochement cash

Brut, frais, net, devise, facture, avoir et période comptable sont comparés sans confondre paiement et versement.

Préciser les interfaces et les responsabilités
  • Relier PayPal au SI sans casser la chaîne de preuve

    Commande, Order, capture, refund, dispute et pièce comptable restent corrélés du checkout à la clôture.

  • Sécuriser les effets métier après le retour acheteur

    La livraison, l’activation ou la facture attendent le statut serveur prévu par le contrat, pas un simple retour navigateur.

  • Traiter les événements sans double action

    Signature, event ID, prise en charge durable, déduplication et relecture protègent la commande et les opérations finance.

  • Rendre l’après-vente et le cash explicables

    Refund partiel, litige, frais, avoir et reste remboursable sont suivis comme des transitions, jamais comme une annulation vague.

Résultats attendus
  • Des commandes reliées à une preuve PayPal serveur et à une décision métier lisible.
  • Des retries qui ne recréent ni capture ni refund quand le résultat initial est incertain.
  • Des litiges, remboursements et frais rattachés au bon dossier et à la bonne période.
  • Un support capable de reprendre un écart sans corriger le cash à l’aveugle.
Ce qu’on clarifie dès le premier échange
  • Le compte marchand, les applications REST, les environnements, les devises, les modes de capture et les outils connectés.
  • Le statut qui libère le métier, les identifiants conservés, les refunds, les disputes et les écarts les plus coûteux.
  • Le paiement témoin, ses contre-tests, la preuve de clôture et le mode d’exploitation attendu.

Quelle preuve serveur autorise réellement votre SI à livrer, facturer ou activer — et qui reprend le dossier si cette preuve arrive après un timeout ?

Preuves projet, portée explicite

Quatre réalisations pour juger paiement, commande, droits et reprise sans inventer une référence PayPal.

France Appro, Opteven, Ciama et 1UP montrent des flux sensibles, des statuts, des transactions et du run. PayPal doit encore être recetté sur votre compte, vos devises et vos règles.

Pilotage des synchronisations Aster et PrestaShop pour Art’Sacs Intégration API France Appro : pilotage Aster–PrestaShop Voir le projet
  • 28 janvier 2020
  • Lecture ~11 min

Dawap a structuré dix traitements Aster–PrestaShop avec fenêtres de données, verrouillage, historique d’exécution et suivi des erreurs pour rendre les synchronisations réellement pilotables.

Plateforme de souscription assurance Opteven connectée aux APIs métier Intégration API Opteven : souscription assurance connectée Voir le projet
  • 03 mai 2024
  • Lecture ~25 min

Dawap a construit pour Opteven deux applications complémentaires : une souscription automobile en six étapes connectée à HubSpot, à l’ERP et à DocuSign, puis un portail pour contrôler les fichiers partenaires et transmettre les contacts qualifiés avec une trace exploitable.

Pipeline API Shopify et Wix transformant commandes et variantes pour Ciama Intégration API Ciama : pipeline API Shopify et Wix Voir le projet
  • 17 mars 2026
  • Étude de cas · 20 min

Ciama sélectionne quatre lecteurs spécialisés pour collecter commandes et variantes Shopify ou Wix, puis les normalise dans deux modèles communs. Le pipeline protège le compte et le canal, décide entre ajout et mise à jour, distribue les écritures et sécurise la désactivation après un snapshot complet.

Architecture suspendue représentant le portail client B2B de 1UP Distribution Développement web 1UP Distribution : portail client, catalogue et tarifs B2B Voir le projet
  • 8 janvier 2026
  • Lecture ~32 min

Dawap a transformé la relation client de 1UP Distribution en portail B2B multi-compte : onboarding, catalogue contextualisé, tarifs issus d’Odoo, disponibilité vendable, paniers réservés, commandes, factures, avoirs et support. Une expérience autonome qui conserve les règles commerciales, les droits et les preuves nécessaires au run.

La documentation borne les objets PayPal ; les projets prouvent des mécanismes de paiement adjacents.
La documentation borne les objets PayPal ; les projets prouvent des mécanismes de paiement adjacents.
Les faits API viennent des documentations officielles PayPal relues le 9 septembre 2026. Aucun projet public sélectionné ne revendique une intégration PayPal : chaque carte démontre seulement une capacité utile au parcours.
Approval et completion restent distincts
PayPal documente plusieurs statuts d’Order. Le SI conserve sa propre règle pour décider quand une commande peut progresser.
PayPal-Request-Id se vérifie par endpoint
Le header peut empêcher une nouvelle exécution d’un appel compatible ; il ne remplace ni la corrélation métier ni la relecture après doute.
Réception et authenticité sont deux contrôles
Le listener prend durablement en charge le message, répond en 2xx et vérifie sa signature avant effet métier.
Capture ne signifie pas cash clôturé
Une capture complétée ne prouve ni versement bancaire, ni absence de refund ou de dispute, ni bonne écriture ERP.

Repères du projet

Une intégration PayPal pensée pour la commande, le cash et la preuve de reprise.

Avant l’effet métier

Order, intention, montant et idempotence sont relus.

Pendant la transaction

Capture, webhook et décision restent corrélés.

Après le paiement

Refund, dispute, frais et écritures gardent leur trace.

Guides de cadrage

Approfondir PayPal, les litiges et le choix de l’architecture PSP.

Ces quatre guides séparent le fonctionnement PayPal, l’après-vente, la cohabitation des fournisseurs et leur comparaison stratégique.

API PayPal : Orders et captures Intégration API API PayPal : Orders et captures Lire l'article
  • 18 décembre 2025
  • Lecture ~23 min

PayPal devient fiable quand Orders, approval, captures, refunds, disputes, webhooks signés et request ids restent reliés aux commandes, avoirs et écritures finance. Le connecteur doit éviter les validations trop rapides, les doubles remboursements, les litiges invisibles et les rapprochements impossibles.

PayPal API litiges remboursements rapprochement comptable Intégration API PayPal API : litiges et cash Lire l'article
  • 6 juin 2024
  • Lecture ~12 min

PayPal doit relier captures, refunds, litiges, payouts, frais et factures pour éviter les écarts de rapprochement et les réponses support fragiles. L'article aide à cadrer les statuts, preuves et scénarios de reprise qui permettent d'expliquer le cash sans reconstruire l'historique à la main chaque semaine.

PayPal Stripe double PSP back-office support Intégration API PayPal + Stripe : double PSP Lire l'article
  • 7 juin 2024
  • Lecture ~12 min

PayPal et Stripe peuvent cohabiter si le back-office unifie checkout, refunds, litiges, frais, versements, support et continuité. Le guide montre comment éviter deux vérités de paiement, deux logiques de remboursement et une finance obligée de rapprocher les écarts après coup, souvent côté PSP et support.

API paiement choisir Stripe PayPal Adyen Mangopay Intégration API API paiement : choisir le PSP Lire l'article
  • 10 juin 2024
  • Lecture ~12 min

Stripe, PayPal, Adyen ou Mangopay ne se choisissent pas au logo. Le bon PSP dépend du modèle e-commerce, marketplace ou B2B, des reversements, litiges, pays, support et exigences finance. L'article aide à comparer coût de run, preuve de paiement et dette d'intégration sur la durée, pas seulement au lancement.

Vos questions

Questions fréquentes sur une intégration API PayPal

Les réponses utiles avant de connecter Orders v2, Payments v2 et les webhooks PayPal à votre commande, votre support et votre finance.

Quand faire appel à un intégrateur API PayPal ?

Quand PayPal doit être relié à vos commandes, ERP, comptabilité, support ou marketplace avec des règles précises de capture, refund, dispute, sécurité, supervision et reprise.

Un Order PayPal APPROVED signifie-t-il que la commande est encaissée ?

Pas à lui seul. APPROVED décrit une étape de l’Order. Votre parcours doit encore attendre l’autorisation ou la capture prévue, puis appliquer la décision métier définie et vérifiable côté serveur.

Comment éviter une double capture ou un double remboursement ?

On attribue un PayPal-Request-Id aux appels compatibles, conserve une clé métier stable et relit la ressource après timeout avant toute reprise. Les opérations simultanées et les limites propres à chaque endpoint restent testées.

Comment sécuriser les webhooks PayPal ?

On conserve le corps reçu et les headers nécessaires, vérifie l’authenticité par validation cryptographique ou endpoint PayPal, déduplique l’event ID, journalise la décision puis répond en 2xx après prise en charge durable.

Peut-on gérer refunds partiels et disputes dans le même flux ?

Oui, à condition de garder capture d’origine, montant restant, refund ID, avoir, dispute ID, échéance, pièces et owner. Ces transitions peuvent rouvrir un dossier sans annuler toute la commande.

Peut-on connecter PayPal à un ERP ou à une marketplace ?

Oui. L’ERP conserve factures, avoirs, règlements et périodes ; la marketplace conserve vendeurs, commissions, reversements et responsabilités. PayPal reste le fournisseur de paiement, pas l’owner de ces modèles métier.

Frontières de responsabilité

Nous définissons les échanges entre PayPal et votre SI. Les commandes, les pièces comptables et les règles de la plateforme restent gérées dans les applications responsables de ces données.

Les profils derrière votre projet

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

Votre sujet : Intégration API PayPal sur mesure : Orders, captures et webhooks

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

Apportez une commande ou un écart PayPal à éclaircir

En 15 minutes, on peut qualifier la commande, le statut qui crée le doute et le premier parcours PayPal à sécuriser.

Cadrer mon flux PayPal