Bloquer une somme sur une carte de paiement en ligne pour une période prolongée
Comment utiliser les autorisations prolongées pour capturer les paiements par carte en ligne jusqu'à 30 jours après l'autorisation.
Les autorisations prolongées ont une période de validité plus longue, ce qui vous permet de bloquer les fonds du client plus longtemps que les délais de validité d’autorisation standard. Pour la plupart des réseaux de cartes, la période de validité de l’autorisation par défaut est de 7 jours pour les paiements en ligne et de 2 jours pour les paiements par TPE via le Terminal, tandis que les périodes de validité prolongées peuvent aller jusqu’à 30 jours en fonction du réseau de cartes. Pour plus d’informations sur les délais de validité de l’autorisation, consultez cette page.
Disponibilité
Lorsque vous utilisez des autorisations étendues, il n’y a pas de restrictions régionales. Cependant, gardez à l’esprit les limitations suivantes :
- Elles ne sont disponibles que sur Visa, Mastercard, American Express et Discover.
- Certaines marques de cartes bancaires appliquent des restrictions quant aux catégories de marchands qu’elles acceptent. Reportez-vous au tableau de disponibilité des réseaux ci-dessous.
- Cette page décrit le fonctionnement des autorisations prolongées pour les paiements par carte en ligne. Pour les paiements par carte effectués à partir d’un TPE avec des autorisations prolongées, consultez la documentation relative à Terminal.
- mode est défini sur
payment
et capture_method est défini surmanual
pour la CheckoutSession.
Fonctionnalité IC+
Nous proposons des autorisations prolongées aux utilisateurs utilisant la tarification IC+. Si vous bénéficiez de la tarification Stripe mixte et souhaitez accéder à cette fonctionnalité, contactez-nous à l’adresse support.stripe.com.
Disponibilité par réseau de cartes et catégorie de marchand
Chaque réseau de cartes applique des règles différentes concernant l’admissibilité des paiements aux autorisations prolongées ainsi que la durée de validité de ces dernières. Le tableau suivant précise ces durées de validité ainsi que les types de transactions pour lesquels ces autorisations sont disponibles pour les réseaux Visa, Mastercard, American Express et Discover. En tout état de cause, dans la mesure où ces règles peuvent changer sans préavis, nous vous recommandons de toujours utiliser le champ capture_before pour confirmer la période de validité applicable pour un paiement donné.
Marque de la carte bancaire | Catégorie de marchand | Durée de validité de l’autorisation prolongée |
---|---|---|
Visa | Hôtel, hébergement, location de véhicule et croisiériste Toutes les autres catégories de marchand* | 30 jours** |
Mastercard (à l’exclusion des cartes Maestro et Cirrus) | Toutes les catégories de marchands | Réduction de 30 jours |
American Express | Hébergement et location de véhicules | 30 jours*** |
Discover | Compagnies aériennes, affrètement d’autocars/transport en autobus, location de voiture, croisiériste, navetteurs locaux/de banlieue, transport de passagers, y compris les ferries, hôtellerie, hébergement et train de passagers | Réduction de 30 jours |
Réseaux avec prise en charge limitée (bêta)
Modifications récentes de la disponibilité
Bonnes pratiques
Lorsque vous utilisez des autorisations prolongées, les fonds de vos clients sont bloqués plus longtemps. Utilisez des libellés de relevé bancaire clairs pour éviter une augmentation des litiges due à des paiements non reconnus.
Vous pouvez utiliser le champ custom_text lorsque vous créez une nouvelle CheckoutSession pour afficher du texte supplémentaire sur la page de paiement afin de respecter les exigences de conformité.
Conformité
Lorsque vous utilisez l’autorisation prolongée, vous êtes responsable du respect de l’ensemble des lois, réglementations et règles de réseau en vigueur. Consultez les spécifications des réseaux de cartes par l’intermédiaire desquels vous prévoyez d’accepter cette fonctionnalité, afin de vous assurer que vos ventes sont conformes aux réglementations applicables, qui varient selon les réseaux. Par exemple, pour de nombreux réseaux, les périodes de validité prolongée sont réservées aux cas où vous ne connaissez pas le montant final que vous capturerez au moment de l’autorisation.
Les informations fournies sur cette page traitant de votre conformité à ces exigences le sont uniquement à titre indicatif, et ne constituent en rien des conseils juridiques, fiscaux, comptables ou autres. Si vous ne savez pas quelles obligations vous devez respecter, consultez un professionnel.
Créer une session Checkout
Ajoutez sur votre site Web un bouton de paiement qui appelle un endpoint côté serveur afin de créer une session Checkout.
<html> <head> <title>Buy cool new product</title> </head> <body> <!-- Use action="/create-checkout-session.php" if your server is PHP based. --> <form action="/create-checkout-session" method="POST"> <button type="submit">Checkout</button> </form> </body> </html>
Une session Checkout est la représentation programmatique de ce que votre client voit lorsqu’il est redirigé vers le formulaire de paiement. Vous pouvez la configurer à l’aide d’options telles que :
- Les postes à facturer
- Les devises à utiliser
Vous devez indiquer dans success_
l’URL d’une page de votre site Web sur laquelle Checkout renvoie votre client une fois son paiement réalisé. Vous pouvez également indiquer dans cancel_
l’URL de la page de votre site Web vers laquelle Checkout renvoie votre client s’il met fin au processus de paiement avant de finaliser l’achat.
Remarque
Par défaut, les sessions Checkout expirent 24 heures après leur création.
Après avoir créé une session Checkout, redirigez votre client vers l’URL renvoyée dans la réponse.
Pour activer la fonctionnalité d’autorisation prolongée, définissez request_extended_authorization sur if_
.
Utilisez le champ capture_before pour confirmer la période de validité d’un paiement donné. La période de validité ne change pas une fois la session Checkout terminée. Pour déterminer si l’autorisation est prolongée une fois la session Checkout terminée, examinez le champ extended_authorization.status sur le paiement associé.
{ "id": "pi_xxx", "object": "payment_intent", "amount": 1000, "amount_capturable": 1000, "amount_received": 0, "status": "requires_capture", ... // if latest_charge is expanded "latest_charge": { "id": "ch_xxx", "object": "charge", "payment_method_details": { "card": { "amount_authorized": 1000, "capture_before": 1696524701, "extended_authorization": { "status": "enabled", // or "disabled" } } } ... } ... }
Tester votre intégration
Utilisez les cartes de test Stripe ci-dessous avec n’importe quel CVC et une date d’expiration postérieure à la date du jour test pour demander des autorisations prolongées pendant le test. Si les autorisations prolongées sont disponibles pour les paiements d’un réseau donné pendant les tests, elles sont également disponibles pour les paiements réels.
Marque de la carte | Numéro | Moyen de paiement |
---|---|---|
Visa | pm_ | |
Mastercard | pm_ | |
Amex | pm_ | |
Discover | pm_ |