DocumentationCommercePayment Services

Surcapturer

Dernière mise à jour : 23 octobre 2026

Créé pour :

  • Intermediate
  • Admin
  • User

La surcapture permet aux commerçants éligibles ayant un accord de surcapture PayPal de capturer plus que le montant autorisé à l’origine lors de la facturation d’une commande. Par exemple, le montant final pourrait augmenter en raison de rajustements en fonction du poids ou de changements dans les coûts des matières entre l’autorisation et l’exécution.

PayPal détermine la limite de surcapture pour chaque compte marchand. L’activation de la surcapture dans Payment Services n’établit pas d’accord ni n’augmente la limite approuvée par PayPal.

NOTE
Cette rubrique décrit la surcapture dans l’extension Payment Services. Pour Adobe Commerce as a Cloud Service d’informations, voir Quantités de capture personnalisées pour connaître les différentes exigences en matière de disponibilité et d’activation.

Conditions préalables

Avant d’activer la surcapture :

  • La surcapture n’est disponible que dans Payment Services 2.17.0 ou une version ultérieure.
  • La surcapture n’est possible que pour les entreprises américaines. Les exigences de surcapture de PayPal (PSD2) s’appliquent également aux commerçants basés aux États-Unis qui vendent aux acheteurs PayPal dans l’Espace économique européen (EEE).
  • La surcapture n’est pas disponible pour les modes de paiement alternatifs (APM).
  • Obtenez un accord de surcapture avec PayPal et confirmez la limite approuvée pour votre compte marchand avec votre gestionnaire de compte PayPal.
  • Définissez la Payment Action du mode de paiement sur Authorize. La surcapture s’applique aux commandes autorisées capturées ultérieurement lors de la facturation, et non aux commandes automatiquement capturées avec Authorize and Capture. Voir Définir Payment Services comme mode de paiement.

Activer la surcapture

  1. Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.
  2. Dans le panneau de gauche, développez Sales et choisissez Payment Methods.
  3. Sélectionnez le site web à configurer à l’aide du sélecteur de portée du magasin.
  4. Développez la section FEATURED ADOBE PAYMENT SOLUTION.
  5. Dans la section Payment Services, développez la section​General Configuration .
  6. Définissez Over Capture Enabled sur Yes.
  7. Cliquez sur Save Config pour enregistrer vos modifications.
  8. Accédez à System > Cache Management, puis cliquez sur Flush Cache pour actualiser tous les caches non valides.

Capturer un paiement autorisé

La surcapture a lieu lors de la facturation dans l’administrateur. Le montant de la capture demandée doit être compris dans la limite approuvée par PayPal pour votre compte marchand. Voir Créer une facture pour le workflow de facturation standard.

  1. Dans la barre latérale Admin, accédez à Sales > Orders.
  2. Ouvrez une commande avec un paiement autorisé qui n’a pas encore été saisi.
  3. Cliquez sur Invoice.
  4. Dans le champ Montant de capture personnalisé, saisissez le montant total à capturer. Par exemple, si le montant autorisé est USD 100 et que les frais définitifs convenus sont USD 110, saisissez 110, et non 10. Le montant demandé doit être compris dans votre limite approuvée par PayPal.
  5. Sélectionnez la capture en ligne de la facture pour demander le paiement via le fournisseur de paiement.
  6. Vérifiez la facture et cliquez sur Submit Invoice.

Capture à l’aide de l’API Invoice

Utilisez le point d’entrée standard Créer une facture :

POST /rest/<store_code>/V1/order/<orderId>/invoice

Utilisez le code magasin pour la commande et l’identifiant interne de la commande. Authentifiez-vous avec un jeton d’administration ou d’intégration autorisé et définissez Content-Type: application/json.

L’exemple de payload suivant demande une facture complète avec capture en ligne d’USD 110 pour une commande autorisée pour USD 100, à condition que le contrat PayPal du commerçant autorise ce montant :

{
  "capture": true,
  "notify": false,
  "arguments": {
    "extension_attributes": {
      "custom_capture_amount": 110
    }
  }
}

Dans cet exemple :

  1. capture demande une capture en ligne.
  2. notify contrôle si Commerce envoie l’e-mail de notification de facture.
  3. custom_capture_amount est le montant final à saisir, et non l’augmentation par rapport au montant autorisé.

Résolution des problèmes liés à une capture rejetée

Si PayPal rejette une demande de surcapture :

  • Vérifiez qu’un accord de surcapture est actif pour le compte marchand PayPal utilisé pour le paiement.
  • Vérifiez que le montant demandé est dans la limite approuvée. S’il dépasse la limite, demandez un montant inférieur ou contactez votre gestionnaire de compte PayPal pour discuter d’une augmentation.
recommendation-more-help
commerce-help-payment-services