Autorisation et Capture est une méthode de paiement permettant d’autoriser le prélèvement des fonds lors de la création d’une commande afin de capturer ces fonds une fois la commande traitée.
Le principe est simple : quand votre client passe sa commande, une autorisation de prélèvement est créée qui valide le transfert de ses fonds pendant 29 jours. Durant ces 29 jours, une “période de validité” des fonds est garantie pendant les 3 premiers jours. À l’expiration des 3 jours, vous pouvez renouveler la validité des fonds tous les 3 jours pendant ces 29 jours.
Une fois que la période des 29 jours est dépassée, l’autorisation est expirée et la commande est annulée.
| Retrouvez en fin de chapitre un lexique des termes les plus utilisés pour cette méthode de paiement. |
Pourquoi activer ce flux de paiement ?
Autorisation et capture vous permet :
- de sécuriser la transaction (l’autorisation garantit la disponibilité des fonds).
- d’éviter les frais sur des ventes qui n’ont pas lieu (pas de frais d’annulation).
- de supprimer les remboursements en cas de commande non expédiée.
- de maîtriser vos stocks en ne vendant que les articles disponibles.
Compatibilité des paiements
Autorisation et Capture est compatible seulement avec ces méthodes de paiement :
- PayPal
- Carte de crédit
- Apple Pay
- Google Pay.
À noter : L’activation d’Autorisation et Capture désactive automatiquement les autres modes de paiement.
Comment configurer Autorisation et Capture ?
Activez ce mode depuis le menu de votre back office : Paiement > Moyens de paiement puis dans la rubrique Modules de paiement actifs, cliquez sur le “CTA configurer” du module PrestaShop Checkout. Terminez votre configuration dans l’onglet Paramètres avancés.
À noter : l’activation désactive automatiquement les autres méthodes de paiement locales.
Dans l’onglet Paramètres avancés, activez “Autoriser et Capture” puis sélectionnez votre méthode de capture :
- Capture instantanée (par défaut) : vous capturez automatiquement les fonds au moment du paiement. Les fonds seront collectés automatiquement lorsque la commande est enregistrée.
- Capture automatique par statut : vous pouvez choisir le(s) statut(s) de la commande qui déclenchera(ront) la capture automatique des fonds.
- Exemple : si je choisis le statut “Expédié” les fonds seront capturés lorsque le statut de la commande est en “Expédié”.
Important : Si aucun statut n’est sélectionné, la commande sera capturée sur tous les statuts par défaut.
Comment gérer les autorisations sur les commandes ?
À partir de votre back-office rubrique “commandes”, repérez la commande que vous souhaitez capturer. Descendez dans l’encart dédié au paiement (voir ci-dessous) pour trouver la liste des transactions.
Lorsque vous déroulez chaque transaction, vous trouverez les détails de chacune avec leur montant :
- Autorisation en attente
- Vous trouverez la période d’autorisation qui vous permet de voir les dates de la création d’autorisation, de la validité de la capture et ainsi de l’expiration.
- Paiement
- Remboursé partiellement
- Remboursé
Vous avez 3 actions ; vous pouvez :
- autoriser à nouveau la période de validité des 3 jours,
- capturer les fonds immédiatement dans la commande
- bien annuler la capture.
Pour cela, vous pouvez aller dans la commande sur laquelle vous souhaitez faire une action puis descendre dans la liste des transactions et faire dérouler les détails de la transaction.
Cliquer sur Ré-autoriser vous permet d’étendre la période de validité des 3 jours durant laquelle PayPal garantit la disponibilité des fonds. Une fenêtre PayPal s’ouvrira afin de confirmer la demande de ré-autorisation.
Cliquer sur Capturer vous permet de capturer les fonds immédiatement. Le paiement sera alors prélevé/effectué dans l’immédiat. Une fenêtre PayPal s’ouvrira afin de confirmer la demande de capture.
Cliquer sur Annuler vous permet d’annuler l’autorisation de la capture et remettra donc les fonds sur le compte du client. Une fenêtre PayPal s’ouvrira afin de confirmer l’annulation.
À noter : une fois l’annulation confirmée, vous ne pouvez plus capturer le montant. La commande est définitivement annulée.
Coming soon : Vous pourrez bientôt capturer seulement une partie du montant d’une commande. Pour être informé dès la sortie de cette fonctionnalité, contactez-nous à l’adresse : pscheckout@prestashop.com
Que faire si la capture échoue ?
Un message d’erreur sera affiché sur votre back-office. Si votre message concerne :
- Une erreur technique : réessayez la capture ultérieurement. Si l’erreur persiste, vous pouvez contacter notre help center via ce formulaire.
- Un échec de paiement (dû à un moyen de paiement refusé) : la capture est impossible et la commande est annulée. Pour réclamer le paiement auprès du client, créer un lien de paiement depuis le dashboard PayPal via Request Money.
Comment effectuer un remboursement ?
Depuis la commande concernée, rendez-vous en bas de page dans la liste des transactions, puis cliquez sur “Remboursement”. Une fenêtre PayPal s’ouvre. Saisissez le montant à rembourser et confirmez. Un message de confirmation s’affiche sur votre écran.
À noter : le remboursement n’est possible que si la transaction est en statut “complété” ou “remboursement partiel”.
Quelques bonnes pratiques
Gestion de la période de garantie
- Pour bénéficier de la période de garantie, pensez à capturer vos fonds dans les 3 premiers jours.
- Vous n’avez pas capturé vos fonds dans les 3 premiers jours ? Renouvelez l’autorisation pour 3 jours supplémentaires.
- Surveillez les dates d'expiration (29 jours max) pour éviter la perte d'autorisation.
Gestion des statuts “en attente” (pending) ?
- Une autorisation PENDING/EN ATTENTE se résout généralement sous 24 à 72 heures.
- Après 72h, considérez l’autorisation comme refusée et contactez le client.
- N'attendez pas 29 jours pour résoudre un statut PENDING/EN ATTENTE.
Communication avec le client
- Informez vos clients que le paiement sera débité uniquement à l'expédition, pas au moment de la commande. (lien vers la config des mails ou au moins le signaler).
- Expliquez qu'ils verront une "retenue" sur leur compte mais pas de débit immédiat.
- Prévenez-les en cas de modification du montant avant la capture finale.
Détails des différents statuts
Les différents tableaux vous donnent les informations nécessaires sur les statuts pour comprendre et suivre l’avancement d’un paiement étape par étape.
Détails des statuts concernant une commande
| Valeur (Enum) | Description |
|---|---|
| CREATED | La commande a été créée avec le contexte spécifié. |
| APPROVED | Le client a approuvé le paiement via son portefeuille PayPal ou une autre forme de paiement (carte, compte bancaire, etc.). |
| VOIDED | Toutes les unités d'achat de la commande ont été annulées. |
| COMPLETED | L'intention de la commande a été finalisée et une ressource de paiement a été créée. Important : Vérifiez le statut du paiement dans purchase_units[].payments.captures[].status avant d'honorer la commande. |
Détails des statuts concernant une autorisation
| Valeur (Enum) | Description |
|---|---|
| CREATED | L'autorisation est en attente de révision manuelle. |
| CAPTURED | Le paiement a été capturé avec succès. |
| DENIED | PayPal ne peut pas autoriser les fonds pour ce paiement. |
| PARTIALLY_CAPTURED | Un paiement partiel a été effectué pour un montant inférieur à l'autorisation initiale. |
| VOIDED | L'autorisation a été annulée. Plus aucune capture ne peut être effectuée sur cette autorisation. |
| PENDING | L'autorisation est en attente. Voir status.details pour plus d'informations. |
Détails des statuts concernant une capture
| Valeur (Enum) | Description |
|---|---|
| COMPLETED | Les fonds ont été crédités sur le compte PayPal du bénéficiaire. |
| DECLINED | Les fonds n'ont pas pu être capturés. |
| PARTIALLY_REFUNDED | Un montant inférieur au montant total de la capture a été remboursé au payeur. |
| PENDING | Les fonds n'ont pas encore été crédités. Consultez status.details pour plus de détails. |
| REFUNDED | Un montant égal ou supérieur au montant capturé a été remboursé au payeur. |
| FAILED | Une erreur est survenue lors de la capture du paiement. |
Détails des statuts concernant les remboursements
| Valeur (Enum) | Description |
|---|---|
| CANCELLED | Le remboursement a été annulé. |
| FAILED | Le remboursement n'a pas pu être traité. |
| PENDING | Le remboursement est en attente. Voir status_details.reason. |
| COMPLETED | Les fonds ont été débités et retournés au client. |
Gestion des erreurs lors d’opérations automatiques
En cas de problème sur une transaction, un message d’erreur s'affiche en haut de votre écran et le statut de la commande est automatiquement mis à jour :
- Erreur de paiement : ce statut est appliqué si l'autorisation ou la capture est impossible. Si le refus survient lors de la capture, nous vous conseillons de contacte le client (vérification des fonds ou de la validité de la carte).
- Autorisation expirée : ce statut indique que le délai de validité de l'autorisation est dépassé et que les fonds ne sont plus réservés.
Gestion des erreurs lors des opérations manuelles
Si une action manuelle échoue, un message d'erreur détaillé s’affiche à l’écran pour vous guider directement sur votre écran pour vous guider. Cela peut se produire lors des opérations suivantes :
- Capture : Impossible de valider l'encaissement.
- Ré-autorisation : Échec du renouvellement de la validité du paiement.
- Annulation : Impossible d'annuler l'autorisation en cours.
- Remboursement : Échec de la restitution des fonds au client.
Cette fonctionnalité vous offre une gestion de paiement flexible et adaptée aux contraintes logistiques et commerciales de votre activité, tout en sécurisant les transactions pour vous et vos clients.
La gestion des webhooks
Afin de gérer efficacement les différents webhooks liés à PayPal, voici un tableau récapitulatif des différents évènements :
| Événements Webhooks | Description |
|---|---|
PAYMENT.AUTHORIZATION.CREATED |
L'autorisation est créée. Les fonds sont bloqués sur le compte du client. |
PAYMENT.CAPTURE.COMPLETED |
La capture est réussie. L'argent est transféré sur votre compte PayPal. |
PAYMENT.CAPTURE.DENIED |
La capture a été refusée (ex: fonds insuffisants au moment final). |
PAYMENT.AUTHORIZATION.VOIDED |
L'autorisation est annulée ou a expiré (délai dépassé). |
PAYMENT.CAPTURE.REFUNDED |
Un remboursement a été effectué sur cette transaction. |
PAYMENT.CAPTURE.REVERSED |
PayPal a inversé la capture (souvent dû à un litige ou fraude). |
Pour plus de détails concernant les webhooks, consultez la documentation PayPal ci-dessous :
- https://developer.paypal.com/docs/checkout/standard/customize/authorization/#how-it-works
- https://developer.paypal.com/api/rest/webhooks/event-names/#link-paymentsv
Lexique
- Autorisation : L’autorisation permet de “bloquer” les fonds sur le compte de votre client pendant 3 jours.
- Capture : La capture permet de récupérer les fonds sur votre compte.
- Expiré : Le délai de 29 jours est expiré, la commande est annulée.
- Annulé : La commande est annulée.
- Ré-autorisation : La ré-autorise permet de “bloquer” à nouveau les fonds sur le compte de votre client pendant 3 jours.