Bloquer une somme d'argent sur une carte bancaireAPI Charges
Ancienne API
The content of this section refers to a Legacy feature. Use the Payment Intents API instead.
L’API Charges ne prend pas en charge les fonctionnalités suivantes, dont beaucoup sont nécessaires à la conformité d’une carte bancaire :
Utilisez l’API Charges pour autoriser un paiement maintenant et capturer les fonds plus tard.
Stripe prend en charge les paiements par carte bancaire en deux temps : vous pouvez donc autoriser un paiement dans un premier temps, puis effectuer le règlement (la capture) dans un second temps. Une fois le paiement autorisé, les fonds sont garantis par l’émetteur de la carte et bloqués sur la carte du client pendant une période pouvant aller jusqu’à 7 jours, ou 2 jours pour les paiements par TPE effectués via Terminal. L’attribut payment_method_details.card.capture_before du paiement précise la date de fin de validité de l’autorisation.
Si le paiement n’est pas capturé passé ce délai, l’autorisation est annulée et les fonds sont libérés.
Autoriser un paiement
Pour autoriser un paiement sans le capturer, effectuez une demande de paiement incluant le paramètre capture avec la valeur : false. Ainsi, Stripe autorise simplement le montant sur la carte bancaire de votre client.
Mise en garde
Seuls certains moyens de paiement permettent de séparer l’autorisation et la capture. Par exemple, les paiements par carte, Afterpay et Klarna prennent en charge la séparation de ces étapes. Avec les moyens de paiement qui ne prennent pas en charge cette fonctionnalité, tels que les prélèvements ACH ou iDEAL, vous ne pouvez pas effectuer de capture manuelle. Pour en savoir plus, reportez-vous à la liste complète des moyens de paiement qui permettent d’effectuer une capture manuelle.
Pour annuler une autorisation, vous pouvez rembourser l’objet Charge correspondant.
Capturer les fonds
Pour régler un paiement autorisé, envoyez une requête de capture de paiement. Par défaut, le montant capturé sera le montant total autorisé, et il vous est impossible de capturer un montant supérieur. Pour capturer un montant inférieur (par exemple 8 USD sur une autorisation de 10 USD), transmettez un paramètre amount. Une capture partielle libérera automatiquement le montant restant.
Certains émetteurs de cartes ne font pas la distinction entre paiements autorisés et paiements capturés (réglés) sur leurs relevés de carte, ce qui peut parfois prêter à confusion pour vos clients. Par ailleurs, un paiement autorisé ne peut être capturé qu’une seule fois. Si vous effectuez une capture partielle, vous ne pourrez donc pas effectuer une seconde capture pour la différence. En fonction de vos besoins, il pourra être plus adapté d’enregistrer les informations de carte de votre client pour une utilisation ultérieure et de créer les paiements nécessaires ensuite.