Incrémenter une autorisation
Les autorisations complémentaires vous permettent d’augmenter le montant autorisé d’un PaymentIntent confirmé avant de le capturer. Avant la capture, chaque autorisation complémentaire apparaît sur le relevé de carte bancaire comme une entrée en attente supplémentaire (par exemple, une autorisation de 10 USD augmentée à 15 USD apparaît sous la forme d’écritures en attente distinctes de 10 USD et de 5 USD). Après la capture, les autorisations en attente sont supprimées et le montant total capturé apparaît sous la forme d’une écriture finale.
Disponibilité
Lorsque vous utilisez des autorisations complémentaires, gardez à l’esprit les restrictions suivantes :
- Non disponible actuellement si vous et le titulaire de la carte êtes établis dans un pays imposant l’authentification forte du client ou des exigences d’authentification similaires.
- Uniquement disponible avec Visa, Mastercard et Discover.
- Certaines marques de cartes bancaires imposent des restrictions sur des catégories de marchand (voir ci-dessous).
Pour en savoir plus sur les autorisations complémentaires et les paiements par TPE avec Terminal, consultez la section dédiée aux autorisations complémentaires.
Fonctionnalité IC+
Les autorisations complémentaires font partie des fonctionnalités que nous proposons aux clients qui utilisent la tarification IC+. Si vous bénéficiez de la tarification standard de Stripe et souhaitez accéder à cette fonctionnalité, rendez-vous sur support.stripe.com pour en savoir plus.
Disponibilité par réseau de cartes et catégorie de marchand
Utilisez les autorisations complémentaires sur les paiements qui répondent aux critères ci-dessous. Vous trouverez votre catégorie d’utilisateur dans le Dashboard.
Toute tentative d’autorisation complémentaire sur un paiement qui ne remplit pas les critères ci-dessous génère une erreur.
Marque de la carte | Pays du marchand | Type de paiement | Catégorie de marchand |
---|---|---|---|
Visa | International | Tous les types de paiement par carte bancaire | Toutes les catégories d’utilisateurs |
Mastercard | International* | Tous les types de paiement par carte bancaire | Toutes les catégories d’utilisateurs |
Discover | International | Tous les types de paiement par carte bancaire | Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, lignes d’autocar, cars touristiques, compagnies de bateaux à vapeur/de croisières, services de location et de crédit-bail de bateaux, magasins d’alimentation et supermarchés, chargement de véhicules électriques, lieux de restauration et restaurants, lieux servant des boissons (alcoolisées), hôtels, motels, complexes touristiques, parcs pour caravanes et campings, services de location et de crédit-bail d’équipements, d’outils, de meubles et d’appareils électroménagers, agence de location de voitures, location de camions et de remorques utilitaires, location de camping-cars, parkings, parcmètres et garages, parcs d’attractions, cirques, voyance et cartomancie, services de loisirs (non classés) |
Discover | International | Carte non présente | Taxis et limousines |
Réseaux avec prise en charge limitée (bêta)
Bonnes pratiques
Lorsque vous avez recours à une autorisation complémentaire, informez votre client final en amont en lui fournissant les détails relatifs à toute autorisation correspondant à un montant estimé, laquelle est susceptible d’être suivie d’autorisations complémentaires qui augmenteraient ce montant. Voici quelques bonnes pratiques à cet égard :
- Indiquez que l’autorisation porte sur un montant estimé et que des demandes d’autorisation ultérieures pourraient survenir au moment du paiement, avant l’achat.
- Calculez les montants estimés sur la base d’une estimation réelle du montant total de la transaction.
Ces bonnes pratiques peuvent être exigées par les règles de réseau en vigueur, selon le réseau concerné.
Conformité
Vous êtes responsable du respect de l’ensemble des lois, réglementations et règles du réseau en vigueur lorsque vous avez recours à une autorisation complémentaire. Consultez les règles relatives aux réseaux de cartes avec lesquels vous prévoyez d’utiliser cette fonctionnalité pour vous assurer que vos ventes respectent les règles en vigueur, lesquelles varient selon le réseau. Par exemple, la plupart des réseaux de cartes imposent des restrictions sur la manière de calculer les montants estimés inclus dans l’autorisation initiale et interdisent le recours aux autorisations complémentaires pour les transactions dont le montant doit être connu au moment de l’autorisation (par exemple, pour les paiements d’abonnements récurrents).
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 avez des doutes concernant les obligations à respecter, consultez un professionnel.
Créer et confirmer un PaymentIntent non capturé
Vous pouvez utiliser le paramètre request_incremental_authorization
pour spécifier les PaymentIntents que vous prévoyez d’augmenter.
Par défaut, tous les PaymentIntents peuvent être augmentés. Utilisez les paramètres if_available
ou never
pour déterminer quand commencer à augmenter un PaymentIntent :
if_available
: le PaymentIntent créé autorise des incréments ultérieurs basés sur la disponibilité incrémentielle de la prise en charge des autorisations.never
: le PaymentIntent créé n’autorise pas les incréments ultérieurs.
Vous ne pouvez effectuer des autorisations complémentaires sur des paiements non capturés qu’après confirmation du PaymentIntent. Pour ajuster le montant d’un paiement avant confirmation, utilisez plutôt la méthode de mise à jour.
Dans la réponse de confirmation de PaymentIntent, le champ payment_method_details dans latest_charge contient les valeurs available
ou unavailable
en fonction du moyen de paiement du client et des critères de disponibilité mentionnés ci-dessus, qui déterminent si un PaymentIntent est admissible ou non à une autorisation complémentaire. (Si vous n’avez pas demandé d’autorisation complémentaire dans votre demande de confirmation de PaymentIntent, celle-ci sera définie sur unavailable
.)
// PaymentIntent Response { "id": "pi_ANipwO3zNfjeWODtRPIg", "object": "payment_intent", "amount": 1000, "amount_capturable": 1000, "amount_received": 0, ... // if latest_charge is expanded { "latest_charge": { "amount": 1000, "payment_method_details": { "card": { "incremental_authorization": { "status": "available" // or "unavailable" } } } ... } } }
Exécuter une autorisation complémentaire
Pour augmenter le montant autorisé sur un PaymentIntent, utilisez l’endpoint increment_authorization et fournissez le total mis à jour du montant d’autorisation à ajouter. Ce montant doit être supérieur au montant initialement autorisé. Cela constitue une tentative d’autorisation d’augmentation d’un montant sur la carte de votre client. Un même PaymentIntent peut appeler cet endpoint à plusieurs reprises pour augmenter davantage le montant autorisé.
Vous disposez au maximum de 10 tentatives d’autorisation complémentaire par PaymentIntent.
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/increment_authorization \ -u
: \ -d "amount"=1500sk_test_4eC39HqLyjWDarjtT1zdp7dc
Si l’autorisation complémentaire aboutit, elle renvoie l’objet PaymentIntent avec le montant modifié. Si l’autorisation échoue, elle renvoie une erreur card_declined à la place. L’objet PaymentIntent reste capturable à hauteur du montant précédemment autorisé. Toute modification éventuelle d’autres champs du PaymentIntent (par exemple, application_fee_amount, transfer_data, metadata, description, et statement_descriptor) ne sera pas enregistrée en cas d’échec de l’autorisation complémentaire.
L’objet Charge sous-jacent pour le PaymentIntent contient un champ de tableau amount_updates qui est ajouté aux résultats de l’autorisation complémentaire. Il indique si l’autorisation a réussi ou échoué, ainsi que tous les détails associés au résultat.
L’autorisation complémentaire est plafonnée à +50 USD (ou la somme équivalente dans la devise locale) ou +50 % du montant précédemment autorisé (selon le montant le plus élevé) pour chaque incrément. Si vous souhaitez fixer des limites plus élevées, vous pouvez contacter le service d’assistance.
Capturer le PaymentIntent
Vous devez capturer les fonds avant que l’autorisation initiale n’expire, que vous augmentiez ou non le montant autorisé d’un PaymentIntent avec une autorisation complémentaire. Les autorisations complémentaires ne prolongent pas la période de validité. Pour capturer le montant autorisé sur un PaymentIntent avec des autorisations complémentaires antérieures, utilisez l’endpoint de capture de la manière habituelle.
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \ -u
:sk_test_4eC39HqLyjWDarjtT1zdp7dc
Si l’autorisation complémentaire aboutit, elle renvoie l’objet PaymentIntent capturé avec le montant modifié. Si l’autorisation échoue, elle renvoie une erreur card_declined. Le PaymentIntent n’est pas capturé, mais il reste capturable à hauteur du montant précédemment autorisé. Toute modification éventuelle d’autres champs du PaymentIntent (par exemple, application_fee_amount, transfer_data, metadata, description et statement_descriptor) ne sera pas enregistrée en cas d’échec de l’autorisation complémentaire.
Tester votre intégration
Utilisez la carte de test Stripe d’autorisation complémentaire avec n’importe quel CVC, code postal et date d’expiration future pour déclencher une autorisation complémentaire en mode test :
Commencez par créer le PaymentIntent à l’aide de la carte de test utilisée à l’étape Créer et confirmer le PaymentIntent ci-dessus.
Exécutez l’autorisation complémentaire avec les paramètres spécifiés dans l’étape Exécuter l’autorisation complémentaire, puis utilisez la carte de test pour déclencher l’autorisation complémentaire.
Nombre | Moyen de paiement | Description |
---|---|---|
pm_card_debit_incrementalAuthAuthorized | Cela augmente le montant de l’autorisation pour atteindre le montant indiqué dans la requête. |