PayPal : rapprocher paiement et facture sans doublon
PayPal expose une interface de programmation (API) de facturation et des notifications automatiques de paiement (webhooks), mais une facture PayPal, un événement de paiement et une facture électronique française sont trois objets distincts. L'intégration doit relier leurs identifiants sans créer automatiquement une nouvelle facture réglementaire à chaque événement.
Pourquoi intégrer PayPal ?
- +Relier la capture PayPal à la facture existante avec un identifiant stable
- +Séparer montant brut, frais, montant net et devise dans le rapprochement
- +Transformer un remboursement en écriture ou avoir selon le cas métier, sans doublon
- +Vérifier la signature des webhooks avant de modifier un statut de paiement
- +Traiter chaque événement de manière idempotente lors des nouvelles tentatives de livraison
Les six événements à tester
Une intégration fiable ne se juge pas sur un paiement réussi unique. Elle doit traiter l'ordre des événements, les reprises et les écarts entre brut, frais et net sans confondre paiement et facture.
- 1Paiement complet puis réception répétée du même webhook
- 2Paiement partiel ou montant différent de la facture
- 3Paiement dans une autre devise avec frais PayPal
- 4Remboursement total puis remboursement partiel
- 5Webhook invalide ou signature non vérifiable
- 6Événement reçu avant que la facture locale soit disponible, puis reprise contrôlée
Contre-cas : Si PayPal sert seulement à quelques encaissements et que le rapprochement manuel est rapide et fiable, une intégration bidirectionnelle peut être disproportionnée. Un import contrôlé peut être préférable tant que le volume ne justifie pas le coût de maintenance des webhooks.
Comment fonctionne l'intégration ?
L'API Invoicing v2 permet de créer et gérer des factures PayPal. Les webhooks préviennent une application d'événements externes ; PayPal demande d'en vérifier l'authenticité et peut retenter une livraison. Votre système doit donc conserver l'identifiant d'événement, rapprocher les montants et ne mettre à jour que la facture canonique prévue.