# Incrémenter une autorisation Augmentez une autorisation existante sur un PaymentIntent confirmé avant de le capturer. # Page hébergée par Stripe > This is a Page hébergée par Stripe for when platform is web and ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/incremental-authorization?platform=web&ui=stripe-hosted. 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, veuillez prêter attention aux restrictions suivantes : - Il n’est disponible qu’avec Visa, Mastercard, American Express ou Discover. - Certaines marques de cartes bancaires imposent des restrictions sur des catégories de marchand (voir ci-dessous). - [mode](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-mode) est défini sur `payment` et [capture_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-capture_method) est défini sur `manual` pour la [CheckoutSession](https://docs.stripe.com/api/checkout/sessions/.md). Pour en savoir plus sur les autorisations complémentaires et les paiements par TPE effectués à l’aide de Terminal, consultez [Autorisations complémentaires](https://docs.stripe.com/terminal/features/incremental-authorizations.md). > #### Fonctionnalité IC+ > > Les autorisations complémentaires font partie des fonctionnalités que nous proposons aux clients qui utilisent la tarification *IC+* (A pricing plan where businesses pay the variable network cost for each transaction plus the Stripe fee rather than a flat rate for all transactions. This pricing model provides more visibility into payments costs). Si vous bénéficiez de la tarification standard de Stripe et souhaitez accéder à cette fonctionnalité, veuillez nous contacter via le formulaire du [service de support Stripe](https://support.stripe.com). ### 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](https://dashboard.stripe.com/settings/update/company/update). 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 | | **American Express** | International | Tous les types de paiement par carte** | 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 | Exclut les utilisateurs au Mexique et les transactions en JPY pour les utilisateurs au Japon \** Some American Express issuers don’t support incremental authorizations. When the feature is requested for these cards, the returned [status](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-incremental_authorization_supported) is `unavailable`. ### Réseaux avec prise en charge limitée (bêta) Les réseaux de cartes bancaires suivants offrent une prise en charge limitée de l’autorisation complémentaire : | Marque de la carte | Pays du marchand | Type de paiement | Catégorie de marchand | | ------------------ | ---------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Diners Club** | États-Unis, Canada, Royaume-Uni (via Discover) | Carte présente | 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) | | **Diners Club** | Monde (via Discover) | Carte non présente | Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, taxis/limousines, lignes d’autobus - charters, 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) | | **UnionPay** | Monde (via Discover) | Carte non présente | Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, taxis/limousines, lignes d’autobus - charters, 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) | | **JCB** | Monde (via Discover) | Carte non présente | Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, taxis/limousines, lignes d’autobus - charters, 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) | ### Autorisations complémentaires avec authentification forte du client (SCA) Si vous et le titulaire de la carte vous trouvez dans un [pays soumis aux exigences de la réglementation SCA](https://support.stripe.com/questions/countries-in-the-european-economic-area-\(eea\)-impacted-by-strong-customer-authentication-\(sca\)-regulation), des éléments essentiels sont à prendre en compte certains lors de l’utilisation de l’autorisation complémentaire. Lorsque vous demandez la fonctionnalité d’autorisation complémentaire lors de l’autorisation initiale, Stripe configure automatiquement le moyen de paiement pour une utilisation ultérieure hors session. Bien que l’autorisation initiale nécessite l’authentification 3D Secure (3DS), les autorisations complémentaires ultérieures sur ce paiement sont considérées comme initiées par les marchands, ce qui peut exempter toute SCA supplémentaire. Indiquez clairement à votre client, lors de la transaction initiale, que son paiement sera enregistré pour une utilisation ultérieure hors session avec les autorisations complémentaires. Avec certaines transactions 3DS, la [responsabilité des contestations de paiement frauduleuses (cartes volées ou contrefaites) est transférée à l’émetteur de la carte](https://docs.stripe.com/payments/3d-secure/authentication-flow.md#disputed-payments). Vous ne bénéficiez pas d’un transfert de responsabilité lorsque vous soumettez des transactions initiées par les marchands. > #### Conformité > > Lorsque vous enregistrez les informations de paiement d’un client, vous êtes responsable du respect de l’ensemble des lois, réglementations et règles du réseau en vigueur. C’est notamment le cas si vous souhaitez enregistrer le moyen de paiement d’un client en vue d’une utilisation ultérieure, par exemple pour le débiter à un moment où il n’utilise pas activement votre site Web ou votre application. Ajoutez des conditions d’utilisation à votre site Web ou à votre application pour indiquer comment vous prévoyez d’enregistrer des informations relatives aux moyens de paiement et qui permettent aux clients d’y adhérer. > > Si vous prévoyez de débiter votre client lorsqu’il est hors ligne, veillez à inclure à vos conditions les éléments suivants : > > - Le consentement du client vous autorisant à déclencher un paiement ou une série de paiements en son nom pour les transactions spécifiées. - Le calendrier et la fréquence prévus des paiements (par exemple, si les paiements se font par versements échelonnés, par recharges non programmées, ou s’il s’agit d’abonnements). - La façon dont vous déterminez le montant à payer. - Vos conditions de résiliation, si le moyen de paiement est utilisé dans le cadre d’un abonnement. > > Veillez à conserver une trace écrite de l’acceptation de ces conditions par votre client. ## 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 ces montants. 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. Vous pouvez utiliser le champ [custom_text](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_text) lorsque vous créez une nouvelle [CheckoutSession](https://docs.stripe.com/api/checkout_sessions.md) pour afficher du texte supplémentaire sur la page de paiement afin de respecter les exigences de conformité. > #### Conformité > > Lorsque vous utilisez l’autorisation complémentaire, vous êtes responsable du respect de l’ensemble des lois, réglementations et règles de réseau en vigueur. Consultez les règles de réseau des réseaux de cartes avec lesquels vous prévoyez d’utiliser cette fonctionnalité pour vous assurer que vos ventes sont conformes aux règles applicables, qui varient d’un réseau à l’autre. 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 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](https://docs.stripe.com/api/checkout/sessions/create.md). ```html Buy cool new product
``` 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items) à facturer - Les devises à utiliser Vous devez renseigner la valeur `success_url` avec l’URL d’une page de votre site web vers laquelle Checkout redirige votre client une fois le paiement effectué. > 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](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-url) renvoyée dans la réponse. Enfin, définissez [request_incremental_authorization](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_options-card-request_incremental_authorization) sur `if_available` pour activer la fonctionnalité d’autorisation complémentaire. #### Ruby ```ruby # This example sets up an endpoint using the Sinatra framework. require 'json' require 'sinatra' require 'stripe' # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') post '/create-checkout-session' do session = client.v1.checkout.sessions.create({ line_items: [{ price_data: { currency: 'usd', product_data: { name: 'T-shirt' }, unit_amount: 2000 }, quantity: 1 }],payment_method_options: { card: { request_incremental_authorization: 'if_available' } }, mode: 'payment', # These placeholder URLs will be replaced in a following step. success_url: 'https://example.com/success' }) redirect session.url, 303 end ``` Une fois que le client a terminé son paiement, le champ [payment_method_details](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details) de l’objet [latest_charge](https://docs.stripe.com/api/charges/object.md) du [PaymentIntent](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-payment_intent) contient `available` ou `unavailable` en fonction du moyen de paiement du client et des [critères de disponibilité mentionnés ci-dessus](https://docs.stripe.com/payments/incremental-authorization.md#availability), qui détermine si un PaymentIntent est admissible pour une autorisation complémentaire. (Si vous n’avez pas demandé d’autorisation complémentaire lors de la création de la session CheckoutSession, celle-ci sera définie sur `unavailable`.) ```json { "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" } } } ... } } } ``` ## Monter Checkout #### HTML + JS Checkout est disponible dans [Stripe.js](https://docs.stripe.com/js.md). Intégrez le script Stripe.js à votre page en l’ajoutant à l’en-tête de votre fichier HTML. Ensuite, créez un nœud DOM vide (conteneur) à utiliser pour le montage. ```html
``` Initialisez Stripe.js avec votre clé API publique. Créez une fonction `fetchClientSecret` asynchrone qui demande à votre serveur de créer la session Checkout et de récupérer la clé secrète du client. Transmettez cette fonction dans la propriété `options` lorsque vous créez l’instance Checkout : ```javascript // Initialize Stripe.js const stripe = Stripe('<>'); initialize(); // Fetch Checkout Session and retrieve the client secret async function initialize() { const fetchClientSecret = async () => { const response = await fetch("/create-checkout-session", { method: "POST", }); const { clientSecret } = await response.json(); return clientSecret; }; // Initialize Checkout const checkout = await stripe.createEmbeddedCheckoutPage({ fetchClientSecret, }); // Mount Checkout checkout.mount('#checkout'); } ``` #### React Installez [react-stripe-js](https://docs.stripe.com/sdks/stripejs-react.md) et le chargeur Stripe.js à partir de npm : ```bash npm install --save @stripe/react-stripe-js @stripe/stripe-js ``` Pour utiliser le composant Checkout intégré, créez un `EmbeddedCheckoutProvider`. Appelez `loadStripe` avec votre clé API publique et transmettez la valeur `Promise` au prestataire. Créez une fonction `fetchClientSecret` asynchrone qui demande à votre serveur de créer la session Checkout et de récupérer la clé secrète du client. Transmettez cette fonction dans la propriété `options` acceptée par le prestataire. ```jsx import * as React from 'react'; import {loadStripe} from '@stripe/stripe-js'; import { EmbeddedCheckoutProvider, EmbeddedCheckout } from '@stripe/react-stripe-js'; // Make sure to call `loadStripe` outside of a component’s render to avoid // recreating the `Stripe` object on every render. const stripePromise = loadStripe('pk_test_123'); const App = () => { const fetchClientSecret = React.useCallback(() => { // Create a Checkout Session return fetch("/create-checkout-session", { method: "POST", }) .then((res) => res.json()) .then((data) => data.clientSecret); }, []); const options = {fetchClientSecret}; return (
) } ``` Checkout s’affiche dans un iframe qui envoie de manière sécurisée les informations de paiement à Stripe via une connexion HTTPS. > Évitez de placer Checkout dans un autre iframe, car certains moyens de paiement nécessitent une redirection vers une autre page pour la confirmation du paiement. ### Personnaliser l’apparence Personnalisez Checkout pour qu’il corresponde au design de votre site en définissant la couleur d’arrière-plan, la couleur des boutons, le rayon de la bordure et les polices dans les [paramètres de marque](https://dashboard.stripe.com/settings/branding) de votre compte. Par défaut, Checkout s’affiche sans espacement externe ni marge. Nous vous recommandons d’utiliser un élément de conteneur tel qu’un espace div pour appliquer la marge souhaitée (par exemple, 16 px sur tous les côtés). ## Afficher une page de retour Après la tentative de paiement de votre client, Stripe le redirige vers une page de retour que vous hébergez sur votre site. Lors de la création de la session Checkout, vous avez spécifié l’URL de la page de retour dans le paramètre [return_url](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-return_url). En savoir plus sur les autres options de [personnalisation du comportement de redirection](https://docs.stripe.com/payments/checkout/custom-success-page.md?payment-ui=embedded-page). Lors de l’affichage de votre page de retour, récupérez l’état de la session Checkout à l’aide de l’ID de session Checkout dans l’URL. Traitez le résultat en fonction de l’état de la session comme suit : - `complete` : Le paiement a abouti. Utilisez les informations de la session Checkout pour afficher une page de confirmation. - `open` : Le paiement a échoué ou a été annulé. Montez à nouveau Checkout pour que votre client puisse effectuer une nouvelle tentative. #### Ruby ```ruby get '/session-status' do session = client.v1.checkout.sessions.retrieve(params[:session_id]) {status: session.status, customer_email: session.customer_details.email}.to_json end ``` ```javascript const session = await fetch(`/session_status?session_id=${session_id}`) if (session.status == 'open') { // Remount embedded Checkout } else if (session.status == 'complete') { // Show success page // Optionally use session.payment_status or session.customer_email // to customize the success page } ``` #### Moyens de paiement avec redirection Lors du paiement, certains moyens de paiement redirigent le client vers une page intermédiaire, comme la page d’autorisation de sa banque. Une fois qu’il a renseigné cette page, Stripe le redirige vers votre page de retour. En savoir plus sur [les moyens de paiement avec redirection et le comportement de redirection](https://docs.stripe.com/payments/checkout/custom-success-page.md?payment-ui=embedded-page#redirect-based-payment-methods). ## Exécuter une autorisation complémentaire Pour augmenter le montant autorisé sur un PaymentIntent, utilisez l’endpoint [increment_authorization](https://docs.stripe.com/api/payment_intents/increment_authorization.md) et fournissez le total mis à jour du [montant d’autorisation](https://docs.stripe.com/api/payment_intents/increment_authorization.md#increment_authorization-amount) à ajouter. Ce montant doit être supérieur au montant initialement autorisé. Vous tentez ainsi d’autoriser un montant plus élevé sur la carte de votre client. Un même PaymentIntent peut appeler cet endpoint plusieurs fois pour augmenter à nouveau le montant autorisé. Vous disposez au maximum de 10 tentatives d’autorisation complémentaire par PaymentIntent. #### curl ```bash curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/increment_authorization \ -u <>: \ -d "amount"=1500 ``` Si l’autorisation complémentaire aboutit, elle renvoie l’objet PaymentIntent avec le montant mis à jour. Si l’autorisation échoue, une erreur [card_declined](https://docs.stripe.com/error-codes.md#card-declined) est alors renvoyée. L’objet PaymentIntent peut toujours être capturé pour le montant précédemment autorisé. Toute modification éventuelle d’autres champs du PaymentIntent (par exemple, [application_fee_amount](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-application_fee_amount), [transfer_data](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-transfer_data), [metadata](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-metadata), [description](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-description) et [statement_descriptor](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-statement_descriptor)) ne sera pas enregistrée en cas d’échec de l’autorisation complémentaire. L’autorisation complémentaire est plafonnée à 500 USD (ou la somme équivalente dans la devise locale) au-dessus ou à 500 % du montant précédemment autorisé (selon le montant le plus élevé) pour chaque complément. ## 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é](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md). Pour capturer le montant autorisé sur un PaymentIntent avec des autorisations complémentaires antérieures, utilisez l’[endpoint capture](https://docs.stripe.com/api/payment_intents/capture.md) de la manière habituelle. #### curl ```bash curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \ -u <>: ``` Si l’autorisation complémentaire aboutit, elle renvoie l’objet PaymentIntent capturé avec le montant mis à jour. Si l’autorisation échoue, une [erreur card_declined](https://docs.stripe.com/error-codes.md#card-declined) est alors renvoyée. Le PaymentIntent n’est pas capturé, mais il peut toujours être capturé pour le montant précédemment autorisé. Toute modification éventuelle d’autres champs du PaymentIntent (par exemple, [application_fee_amount](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-application_fee_amount), [transfer_data](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-transfer_data), [metadata](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-metadata), [description](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-description) et [statement_descriptor](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-statement_descriptor)) ne sera pas enregistrée en cas d’échec de l’autorisation complémentaire. ## Tester votre intégration Utilisez une carte bancaire de test Stripe avec n’importe quel CVC, code postal et date d’expiration future pour déclencher des autorisations complémentaires pendant les tests : 1. Créez la CheckoutSession à l’aide de la carte bancaire de test à l’étape [créer une session Checkout](https://docs.stripe.com/payments/incremental-authorization.md#create-and-confirm). 1. Effectuez l’autorisation complémentaire avec les paramètres spécifiés dans l’étape [effectuez l’étape d’autorisation complémentaire](https://docs.stripe.com/payments/incremental-authorization.md#increment-authorization). Utilisez les cartes bancaires suivantes pour simuler le succès ou l’échec de l’autorisation complémentaire. | Numéro | Moyen de paiement | Description | | ---------------- | ---------------------------------------------- | ------------------------------------------------------------------------ | | 4000058400000063 | `pm_card_debit_incrementalAuthAuthorized` | Augmente le montant de l’autorisation au montant fourni dans la requête. | | 4000008400000076 | `pm_card_credit_disableEnterpriseCardFeatures` | Refuse la requête d’autorisation accrue. | # Page entièrement intégrée > This is a Page entièrement intégrée for when platform is web and ui is embedded-page. View the full page at https://docs.stripe.com/payments/incremental-authorization?platform=web&ui=embedded-page. 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, veuillez prêter attention aux restrictions suivantes : - Il n’est disponible qu’avec Visa, Mastercard, American Express ou Discover. - Certaines marques de cartes bancaires imposent des restrictions sur des catégories de marchand (voir ci-dessous). - [mode](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-mode) est défini sur `payment` et [capture_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-capture_method) est défini sur `manual` pour la [CheckoutSession](https://docs.stripe.com/api/checkout/sessions/.md). Pour en savoir plus sur les autorisations complémentaires et les paiements par TPE effectués à l’aide de Terminal, consultez [Autorisations complémentaires](https://docs.stripe.com/terminal/features/incremental-authorizations.md). > #### Fonctionnalité IC+ > > Les autorisations complémentaires font partie des fonctionnalités que nous proposons aux clients qui utilisent la tarification *IC+* (A pricing plan where businesses pay the variable network cost for each transaction plus the Stripe fee rather than a flat rate for all transactions. This pricing model provides more visibility into payments costs). Si vous bénéficiez de la tarification standard de Stripe et souhaitez accéder à cette fonctionnalité, veuillez nous contacter via le formulaire du [service de support Stripe](https://support.stripe.com). ### 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](https://dashboard.stripe.com/settings/update/company/update). 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 | | **American Express** | International | Tous les types de paiement par carte** | 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 | Exclut les utilisateurs au Mexique et les transactions en JPY pour les utilisateurs au Japon \** Some American Express issuers don’t support incremental authorizations. When the feature is requested for these cards, the returned [status](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-incremental_authorization_supported) is `unavailable`. ### Réseaux avec prise en charge limitée (bêta) Les réseaux de cartes bancaires suivants offrent une prise en charge limitée de l’autorisation complémentaire : | Marque de la carte | Pays du marchand | Type de paiement | Catégorie de marchand | | ------------------ | ---------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Diners Club** | États-Unis, Canada, Royaume-Uni (via Discover) | Carte présente | 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) | | **Diners Club** | Monde (via Discover) | Carte non présente | Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, taxis/limousines, lignes d’autobus - charters, 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) | | **UnionPay** | Monde (via Discover) | Carte non présente | Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, taxis/limousines, lignes d’autobus - charters, 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) | | **JCB** | Monde (via Discover) | Carte non présente | Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, taxis/limousines, lignes d’autobus - charters, 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) | ### Autorisations complémentaires avec authentification forte du client (SCA) Si vous et le titulaire de la carte vous trouvez dans un [pays soumis aux exigences de la réglementation SCA](https://support.stripe.com/questions/countries-in-the-european-economic-area-\(eea\)-impacted-by-strong-customer-authentication-\(sca\)-regulation), des éléments essentiels sont à prendre en compte certains lors de l’utilisation de l’autorisation complémentaire. Lorsque vous demandez la fonctionnalité d’autorisation complémentaire lors de l’autorisation initiale, Stripe configure automatiquement le moyen de paiement pour une utilisation ultérieure hors session. Bien que l’autorisation initiale nécessite l’authentification 3D Secure (3DS), les autorisations complémentaires ultérieures sur ce paiement sont considérées comme initiées par les marchands, ce qui peut exempter toute SCA supplémentaire. Indiquez clairement à votre client, lors de la transaction initiale, que son paiement sera enregistré pour une utilisation ultérieure hors session avec les autorisations complémentaires. Avec certaines transactions 3DS, la [responsabilité des contestations de paiement frauduleuses (cartes volées ou contrefaites) est transférée à l’émetteur de la carte](https://docs.stripe.com/payments/3d-secure/authentication-flow.md#disputed-payments). Vous ne bénéficiez pas d’un transfert de responsabilité lorsque vous soumettez des transactions initiées par les marchands. > #### Conformité > > Lorsque vous enregistrez les informations de paiement d’un client, vous êtes responsable du respect de l’ensemble des lois, réglementations et règles du réseau en vigueur. C’est notamment le cas si vous souhaitez enregistrer le moyen de paiement d’un client en vue d’une utilisation ultérieure, par exemple pour le débiter à un moment où il n’utilise pas activement votre site Web ou votre application. Ajoutez des conditions d’utilisation à votre site Web ou à votre application pour indiquer comment vous prévoyez d’enregistrer des informations relatives aux moyens de paiement et qui permettent aux clients d’y adhérer. > > Si vous prévoyez de débiter votre client lorsqu’il est hors ligne, veillez à inclure à vos conditions les éléments suivants : > > - Le consentement du client vous autorisant à déclencher un paiement ou une série de paiements en son nom pour les transactions spécifiées. - Le calendrier et la fréquence prévus des paiements (par exemple, si les paiements se font par versements échelonnés, par recharges non programmées, ou s’il s’agit d’abonnements). - La façon dont vous déterminez le montant à payer. - Vos conditions de résiliation, si le moyen de paiement est utilisé dans le cadre d’un abonnement. > > Veillez à conserver une trace écrite de l’acceptation de ces conditions par votre client. ## 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 ces montants. 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. Vous pouvez utiliser le champ [custom_text](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_text) lorsque vous créez une nouvelle [CheckoutSession](https://docs.stripe.com/api/checkout_sessions.md) pour afficher du texte supplémentaire sur la page de paiement afin de respecter les exigences de conformité. > #### Conformité > > Lorsque vous utilisez l’autorisation complémentaire, vous êtes responsable du respect de l’ensemble des lois, réglementations et règles de réseau en vigueur. Consultez les règles de réseau des réseaux de cartes avec lesquels vous prévoyez d’utiliser cette fonctionnalité pour vous assurer que vos ventes sont conformes aux règles applicables, qui varient d’un réseau à l’autre. 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 ne savez pas quelles obligations vous devez respecter, consultez un professionnel. ## Créer une session Checkout Depuis votre serveur, créez une *Checkout Session* (A Checkout Session represents your customer's session as they pay for one-time purchases or subscriptions through Checkout. After a successful payment, the Checkout Session contains a reference to the Customer, and either the successful PaymentIntent or an active Subscription) et définissez l’[ui_mode](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-ui_mode) sur `embedded_page`. Vous pouvez configurer la [Checkout Session](https://docs.stripe.com/api/checkout/sessions/create.md) avec des [postes](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items) à inclure et des options telles qu’une [devise](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-currency). Pour rediriger vos clients vers une page personnalisée hébergée sur votre site Web, spécifiez l’URL de cette page dans le paramètre [return_url](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-return_url). Incluez la variable de modèle `{CHECKOUT_SESSION_ID}` dans l’URL pour récupérer l’état de la session sur la page de retour. Checkout remplace automatiquement la variable par l’ID de session Checkout avant la redirection. En savoir plus sur la [configuration de la page de retour](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=embedded-page#return-page) et d’autres options pour [personnaliser le comportement de redirection](https://docs.stripe.com/payments/checkout/custom-success-page.md?payment-ui=embedded-page). Après avoir créé la session Checkout, utilisez la `client_secret` renvoyée dans la réponse pour [monter Checkout](https://docs.stripe.com/payments/incremental-authorization.md#mount-checkout). Pour activer la fonctionnalité d’autorisation complémentaire, définissez [request_incremental_authorization](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_options-card-request_incremental_authorization) sur `if_available`. #### Ruby ```ruby # This example sets up an endpoint using the Sinatra framework. require 'json' require 'sinatra' require 'stripe' # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') post '/create-checkout-session' do session = client.v1.checkout.sessions.create({ line_items: [{ price_data: { currency: 'usd', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], mode: 'payment', ui_mode: 'embedded_page',payment_method_options: { card: { request_incremental_authorization: 'if_available', }, }, return_url: 'https://example.com/checkout/return?session_id={CHECKOUT_SESSION_ID}' }) {clientSecret: session.client_secret}.to_json end ``` Une fois que le client a terminé son paiement, le champ [payment_method_details](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details) de l’objet [latest_charge](https://docs.stripe.com/api/charges/object.md) du [PaymentIntent](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-payment_intent) contient `available` ou `unavailable` en fonction du moyen de paiement du client et des [critères de disponibilité mentionnés ci-dessus](https://docs.stripe.com/payments/incremental-authorization.md#availability), qui détermine si un PaymentIntent est admissible pour une autorisation complémentaire. (Si vous n’avez pas demandé d’autorisation complémentaire lors de la création de la session CheckoutSession, celle-ci sera définie sur `unavailable`.) ```json { "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](https://docs.stripe.com/api/payment_intents/increment_authorization.md) et fournissez le total mis à jour du [montant d’autorisation](https://docs.stripe.com/api/payment_intents/increment_authorization.md#increment_authorization-amount) à ajouter. Ce montant doit être supérieur au montant initialement autorisé. Vous tentez ainsi d’autoriser un montant plus élevé sur la carte de votre client. Un même PaymentIntent peut appeler cet endpoint plusieurs fois pour augmenter à nouveau le montant autorisé. Vous disposez au maximum de 10 tentatives d’autorisation complémentaire par PaymentIntent. #### curl ```bash curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/increment_authorization \ -u <>: \ -d "amount"=1500 ``` Si l’autorisation complémentaire aboutit, elle renvoie l’objet PaymentIntent avec le montant mis à jour. Si l’autorisation échoue, une erreur [card_declined](https://docs.stripe.com/error-codes.md#card-declined) est alors renvoyée. L’objet PaymentIntent peut toujours être capturé pour le montant précédemment autorisé. Toute modification éventuelle d’autres champs du PaymentIntent (par exemple, [application_fee_amount](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-application_fee_amount), [transfer_data](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-transfer_data), [metadata](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-metadata), [description](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-description) et [statement_descriptor](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-statement_descriptor)) ne sera pas enregistrée en cas d’échec de l’autorisation complémentaire. L’autorisation complémentaire est plafonnée à 500 USD (ou la somme équivalente dans la devise locale) au-dessus ou à 500 % du montant précédemment autorisé (selon le montant le plus élevé) pour chaque complément. ## 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é](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md). Pour capturer le montant autorisé sur un PaymentIntent avec des autorisations complémentaires antérieures, utilisez l’[endpoint capture](https://docs.stripe.com/api/payment_intents/capture.md) de la manière habituelle. #### curl ```bash curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \ -u <>: ``` Si l’autorisation complémentaire aboutit, elle renvoie l’objet PaymentIntent capturé avec le montant mis à jour. Si l’autorisation échoue, une [erreur card_declined](https://docs.stripe.com/error-codes.md#card-declined) est alors renvoyée. Le PaymentIntent n’est pas capturé, mais il peut toujours être capturé pour le montant précédemment autorisé. Toute modification éventuelle d’autres champs du PaymentIntent (par exemple, [application_fee_amount](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-application_fee_amount), [transfer_data](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-transfer_data), [metadata](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-metadata), [description](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-description) et [statement_descriptor](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-statement_descriptor)) ne sera pas enregistrée en cas d’échec de l’autorisation complémentaire. ## Tester votre intégration Utilisez une carte bancaire de test Stripe avec n’importe quel CVC, code postal et date d’expiration future pour déclencher des autorisations complémentaires pendant les tests : 1. Créez la CheckoutSession à l’aide de la carte bancaire de test à l’étape [créer une session Checkout](https://docs.stripe.com/payments/incremental-authorization.md#create-and-confirm). 1. Effectuez l’autorisation complémentaire avec les paramètres spécifiés dans l’étape [effectuez l’étape d’autorisation complémentaire](https://docs.stripe.com/payments/incremental-authorization.md#increment-authorization). Utilisez les cartes bancaires suivantes pour simuler le succès ou l’échec de l’autorisation complémentaire. | Numéro | Moyen de paiement | Description | | ---------------- | ---------------------------------------------- | ------------------------------------------------------------------------ | | 4000058400000063 | `pm_card_debit_incrementalAuthAuthorized` | Augmente le montant de l’autorisation au montant fourni dans la requête. | | 4000008400000076 | `pm_card_credit_disableEnterpriseCardFeatures` | Refuse la requête d’autorisation accrue. | # Intégration avancée > This is a Intégration avancée for when platform is web and ui is elements. View the full page at https://docs.stripe.com/payments/incremental-authorization?platform=web&ui=elements. 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, veuillez prêter attention aux restrictions suivantes : - Il n’est disponible qu’avec Visa, Mastercard, American Express ou 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 effectués à l’aide de Terminal, consultez [Autorisations complémentaires](https://docs.stripe.com/terminal/features/incremental-authorizations.md). > #### Fonctionnalité IC+ > > Les autorisations complémentaires font partie des fonctionnalités que nous proposons aux clients qui utilisent la tarification *IC+* (A pricing plan where businesses pay the variable network cost for each transaction plus the Stripe fee rather than a flat rate for all transactions. This pricing model provides more visibility into payments costs). Si vous bénéficiez de la tarification standard de Stripe et souhaitez accéder à cette fonctionnalité, veuillez nous contacter via le formulaire du [service de support Stripe](https://support.stripe.com). ### 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](https://dashboard.stripe.com/settings/update/company/update). 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 | | **American Express** | International | Tous les types de paiement par carte** | 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 | Exclut les utilisateurs au Mexique et les transactions en JPY pour les utilisateurs au Japon \** Some American Express issuers don’t support incremental authorizations. When the feature is requested for these cards, the returned [status](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-incremental_authorization_supported) is `unavailable`. ### Réseaux avec prise en charge limitée (bêta) Les réseaux de cartes bancaires suivants offrent une prise en charge limitée de l’autorisation complémentaire : | Marque de la carte | Pays du marchand | Type de paiement | Catégorie de marchand | | ------------------ | ---------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Diners Club** | États-Unis, Canada, Royaume-Uni (via Discover) | Carte présente | 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) | | **Diners Club** | Monde (via Discover) | Carte non présente | Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, taxis/limousines, lignes d’autobus - charters, 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) | | **UnionPay** | Monde (via Discover) | Carte non présente | Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, taxis/limousines, lignes d’autobus - charters, 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) | | **JCB** | Monde (via Discover) | Carte non présente | Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, taxis/limousines, lignes d’autobus - charters, 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) | ### Autorisations complémentaires avec authentification forte du client (SCA) Si vous et le titulaire de la carte vous trouvez dans un [pays soumis aux exigences de la réglementation SCA](https://support.stripe.com/questions/countries-in-the-european-economic-area-\(eea\)-impacted-by-strong-customer-authentication-\(sca\)-regulation), des éléments essentiels sont à prendre en compte certains lors de l’utilisation de l’autorisation complémentaire. Lorsque vous demandez la fonctionnalité d’autorisation complémentaire lors de l’autorisation initiale, Stripe configure automatiquement le moyen de paiement pour une utilisation ultérieure hors session. Bien que l’autorisation initiale nécessite l’authentification 3D Secure (3DS), les autorisations complémentaires ultérieures sur ce paiement sont considérées comme initiées par les marchands, ce qui peut exempter toute SCA supplémentaire. Indiquez clairement à votre client, lors de la transaction initiale, que son paiement sera enregistré pour une utilisation ultérieure hors session avec les autorisations complémentaires. Avec certaines transactions 3DS, la [responsabilité des contestations de paiement frauduleuses (cartes volées ou contrefaites) est transférée à l’émetteur de la carte](https://docs.stripe.com/payments/3d-secure/authentication-flow.md#disputed-payments). Vous ne bénéficiez pas d’un transfert de responsabilité lorsque vous soumettez des transactions initiées par les marchands. > #### Conformité > > Lorsque vous enregistrez les informations de paiement d’un client, vous êtes responsable du respect de l’ensemble des lois, réglementations et règles du réseau en vigueur. C’est notamment le cas si vous souhaitez enregistrer le moyen de paiement d’un client en vue d’une utilisation ultérieure, par exemple pour le débiter à un moment où il n’utilise pas activement votre site Web ou votre application. Ajoutez des conditions d’utilisation à votre site Web ou à votre application pour indiquer comment vous prévoyez d’enregistrer des informations relatives aux moyens de paiement et qui permettent aux clients d’y adhérer. > > Si vous prévoyez de débiter votre client lorsqu’il est hors ligne, veillez à inclure à vos conditions les éléments suivants : > > - Le consentement du client vous autorisant à déclencher un paiement ou une série de paiements en son nom pour les transactions spécifiées. - Le calendrier et la fréquence prévus des paiements (par exemple, si les paiements se font par versements échelonnés, par recharges non programmées, ou s’il s’agit d’abonnements). - La façon dont vous déterminez le montant à payer. - Vos conditions de résiliation, si le moyen de paiement est utilisé dans le cadre d’un abonnement. > > Veillez à conserver une trace écrite de l’acceptation de ces conditions par votre client. ## 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 ces montants. 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. > #### Conformité > > Lorsque vous utilisez l’autorisation complémentaire, vous êtes responsable du respect de l’ensemble des lois, réglementations et règles de réseau en vigueur. Consultez les règles de réseau des réseaux de cartes avec lesquels vous prévoyez d’utiliser cette fonctionnalité pour vous assurer que vos ventes sont conformes aux règles applicables, qui varient d’un réseau à l’autre. 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 ne savez pas quelles obligations vous devez 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. 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](https://docs.stripe.com/payments/incremental-authorization.md#availability). - `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](https://docs.stripe.com/api/payment_intents/confirm.md). Pour ajuster le montant d’un paiement avant confirmation, utilisez plutôt la [méthode de mise à jour](https://docs.stripe.com/api/payment_intents/update.md). ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=usd \ -d "payment_method_types[]=card" \ -d payment_method=pm_card_debit_incrementalAuthAuthorized \ -d confirm=true \ -d capture_method=manual \ -d "expand[]=latest_charge" \ -d "payment_method_options[card][request_incremental_authorization]=if_available" ``` Dans la réponse de confirmation de PaymentIntent, le champ [payment_method_details](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details) dans [latest_charge](https://docs.stripe.com/api/charges/object.md) contient les valeurs `available` ou `unavailable` en fonction du moyen de paiement du client et des [critères de disponibilité mentionnés ci-dessus](https://docs.stripe.com/payments/incremental-authorization.md#availability), qui déterminent si un PaymentIntent est éligible 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`. ```json // 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](https://docs.stripe.com/api/payment_intents/increment_authorization.md) et fournissez le total mis à jour du [montant d’autorisation](https://docs.stripe.com/api/payment_intents/increment_authorization.md#increment_authorization-amount) à ajouter. Ce montant doit être supérieur au montant initialement autorisé. Vous tentez ainsi d’autoriser un montant plus élevé sur la carte de votre client. Un même PaymentIntent peut appeler cet endpoint plusieurs fois pour augmenter à nouveau le montant autorisé. Vous disposez au maximum de 10 tentatives d’autorisation complémentaire par PaymentIntent. #### curl ```bash curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/increment_authorization \ -u <>: \ -d "amount"=1500 ``` Si l’autorisation complémentaire aboutit, elle renvoie l’objet PaymentIntent avec le montant mis à jour. Si l’autorisation échoue, une erreur [card_declined](https://docs.stripe.com/error-codes.md#card-declined) est alors renvoyée. L’objet PaymentIntent peut toujours être capturé pour le montant précédemment autorisé. Toute modification éventuelle d’autres champs du PaymentIntent (par exemple, [application_fee_amount](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-application_fee_amount), [transfer_data](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-transfer_data), [metadata](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-metadata), [description](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-description) et [statement_descriptor](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-statement_descriptor)) ne sera pas enregistrée en cas d’échec de l’autorisation complémentaire. L’autorisation complémentaire est plafonnée à 500 USD (ou la somme équivalente dans la devise locale) au-dessus ou à 500 % du montant précédemment autorisé (selon le montant le plus élevé) pour chaque complément. ## 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é](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md). Pour capturer le montant autorisé sur un PaymentIntent avec des autorisations complémentaires antérieures, utilisez l’[endpoint capture](https://docs.stripe.com/api/payment_intents/capture.md) de la manière habituelle. #### curl ```bash curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \ -u <>: ``` Si l’autorisation complémentaire aboutit, elle renvoie l’objet PaymentIntent capturé avec le montant mis à jour. Si l’autorisation échoue, une [erreur card_declined](https://docs.stripe.com/error-codes.md#card-declined) est alors renvoyée. Le PaymentIntent n’est pas capturé, mais il peut toujours être capturé pour le montant précédemment autorisé. Toute modification éventuelle d’autres champs du PaymentIntent (par exemple, [application_fee_amount](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-application_fee_amount), [transfer_data](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-transfer_data), [metadata](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-metadata), [description](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-description) et [statement_descriptor](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-statement_descriptor)) ne sera pas enregistrée en cas d’échec de l’autorisation complémentaire. ## Tester votre intégration Utilisez une carte bancaire de test Stripe avec n’importe quel CVC, code postal et date d’expiration future pour déclencher des autorisations complémentaires pendant les tests : 1. Créez le PaymentIntent à l’aide de la carte bancaire de test à l’étape [créer et confirmer le PaymentIntent](https://docs.stripe.com/payments/incremental-authorization.md#create-and-confirm). 1. Effectuez l’autorisation complémentaire avec les paramètres spécifiés dans l’étape [effectuez l’étape d’autorisation complémentaire](https://docs.stripe.com/payments/incremental-authorization.md#increment-authorization). Utilisez les cartes bancaires suivantes pour simuler le succès ou l’échec de l’autorisation complémentaire. | Numéro | Moyen de paiement | Description | | ---------------- | ---------------------------------------------- | ------------------------------------------------------------------------ | | 4000058400000063 | `pm_card_debit_incrementalAuthAuthorized` | Augmente le montant de l’autorisation au montant fourni dans la requête. | | 4000008400000076 | `pm_card_credit_disableEnterpriseCardFeatures` | Refuse la requête d’autorisation accrue. |