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
-
-
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ÉCONCILIERUn retour réussi ne suffit pas à libérer la commande.
- 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.
Quatre références doivent conduire au même dossier.
- Attendu
- 248,00 EUR
- Brut capturé
- 248,00 EUR
- Frais observés
- à importer
- Net rapproché
- EN ATTENTE
Cinq preuves avant de promettre que la commande est payée.
- 01RéférenceOrder lié à COM-7842PASS
- 02IntentionCAPTURE attenduePASS
- 03Montant248,00 EUR concordantsPASS
- 04IdempotenceRequest ID connuPASS
- 05Preuve serveurCapture à relireHOLD
La réception HTTP et l’effet financier ne partagent pas la même horloge.
- Order créérequest PAY-2409/CREATE · réponse 201API
- Acheteur revenustatut APPROVED · aucune libérationFRONT
- Capture demandéetimeout client · même PayPal-Request-Id conservéUNKNOWN
- Webhook reçuPAYMENT.CAPTURE.COMPLETED · signature valideEVENT
- Capture relue3Y•••303 · statut COMPLETEDPROOF
Trois écarts qui ne doivent jamais devenir un simple statut “annulé”.
Relire la capture, le restant remboursable, la ligne de commande et l’avoir avant toute nouvelle opération.
RAPPROCHERRattacher motif, échéance, montant et pièces au support et à la finance sans conclure automatiquement.
ASSIGNERVérifier signature, event ID et décision déjà appliquée ; répondre sans produire une seconde action métier.
DÉDUPLIQUERCe que PayPal expose — et ce que votre SI doit encore décider.
Les statuts documentés distinguent notamment CREATED, APPROVED, VOIDED, COMPLETED et PAYER_ACTION_REQUIRED.
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.
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.
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.
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.
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.
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.
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 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 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.
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é
Relier PayPal aux commandes, à l’ERP et aux autres moyens de paiement
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
Direction · architecture
Jérémy Chomel
Conception des API et middlewares, mapping, reprise sur erreur, observabilité et mise en production.
Direction · produit
Arnault Frier
Analyse des processus métier, choix du premier flux utile et accompagnement des utilisateurs.
Product Owner / Scrum Master
Loïc Orue
Product Owner / Scrum Master : backlog d’intégration, dépendances SI, recette et coordination des parties prenantes.
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