# Personnaliser le processus de paiement avec Payment Links Collectez des informations supplémentaires, les taxes, ou mettez à jour votre marque. Lorsque vous créez un lien de paiement, vous pouvez personnaliser l’apparence d’une session de paiement pour vos utilisateurs. Vous pouvez également choisir quelles informations clients collecter et sauvegarder pour plus tard. Consultez la section [Après un paiement via un lien de paiement](https://docs.stripe.com/payment-links/post-payment.md) pour en savoir plus sur la personnalisation des sessions post paiement, notamment sur la redirection du client vers une page de confirmation avec le logo de votre marque, ou l’envoi d’un reçu par e-mail. ## Limiter le nombre de paiements qu’un lien de paiement peut être utilisé Vous pouvez limiter le nombre de paiements pouvant être effectués avec un lien de paiement. Par exemple, vous pouvez imposer une limite si votre stock est limité ou si vous souhaitez que les liens ne soient utilisés qu’une seule fois. Lorsque le lien de paiement atteint la limite, il est automatiquement désactivé et les clients ne peuvent plus l’utiliser pour effectuer un achat. Si un client tente d’ouvrir le lien une fois que la limite a été atteinte, le message par défaut pour les liens désactivés s’affiche ou [un message que vous pouvez personnaliser](https://docs.stripe.com/payment-links/customize.md#custom-deactivated-link-message). Un lien de paiement est considéré comme « payé » lorsqu’une session de paiement est terminée. Vous pouvez consulter les paiements des sessions complétées de deux manières différentes, selon le type de lien de paiement : - Pour les liens de paiement qui incluent des abonnements (c’est-à-dire tout lien qui présente un [tarif récurrent](https://docs.stripe.com/products-prices/pricing-models.md)), accédez à **Facturation** > **Abonnements**. - Pour tous les autres liens de paiement, rendez-vous sur la page des détails du lien de paiement, puis sur **Payments et analyses** > **Paiements récents**. #### Dashboard Pour limiter le nombre de paiements à l’aide du Dashboard : 1. [Créez](https://dashboard.stripe.com/payment-links/create) ou modifiez un lien de paiement. 2. Sélectionnez **Limiter le nombre de paiements** et saisissez le nombre de paiements que vous souhaitez autoriser avant la désactivation du lien. #### API Pour limiter le nombre de paiements via l’API, passez le paramètre `restrictions[completed_sessions][limit]` lors de la [création](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-restrictions-completed_sessions-limit) ou de la [mise à jour](https://docs.stripe.com/api/payment-link/update.md#update_payment_link-restrictions-completed_sessions-limit) d’un paiement. Un lien de paiement est considéré comme « payé » lorsque Stripe envoie l’événement *webhook {% /glossary % [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed).* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "restrictions[completed_sessions][limit]=1" ``` ## Définir un message personnalisé pour les liens désactivés Si un client tente d’ouvrir un lien de paiement désactivé, un message par défaut s’affiche. Vous pouvez personnaliser ce message dans le Dashboard ou via l’API. #### Dashboard Pour personnaliser le message d’un lien désactivé dans le Dashboard deux options s’offrent à vous : - Lorsque vous [créez](https://dashboard.stripe.com/payment-links/create) ou modifiez un lien de paiement, sélectionnez **Limiter le nombre de paiements**. Sélectionnez ensuite **Modifier le message de désactivation** et ajoutez votre message personnalisé. - Lorsque vous tentez de désactiver un lien de paiement, une fenêtre modale vous invitant à modifier le message de désactivation par défaut s’affiche. Utilisez-le pour mettre à jour le message. #### API Pour définir un message personnalisé pour un lien désactivé avec l’API, transmettez le paramètre `inactive_message` lorsque vous [créez](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-restrictions-completed_sessions-limit) ou [mettez à jour](https://docs.stripe.com/api/payment-link/update.md#update_payment_link-restrictions-completed_sessions-limit) un lien de paiement. ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ --data-urlencode "inactive_message=Sorry, we're out of stock for now!" ``` ## Collecter les adresses et les numéros de téléphone des clients Vous pouvez collecter des adresses et des numéros de téléphone à l’aide de liens de paiement en ajoutant ces champs à la `Checkout Session`. #### Dashboard ### Collecter une adresse Pour collecter les adresses de vos clients : 1. [Créez](https://dashboard.stripe.com/payment-links/create) ou modifiez un lien de paiement. Pour modifier un lien de paiement, accédez à sa page d’informations et cliquez sur le menu de débordement (⋯). 2. Sélectionnez **Collect customer addresses** (collecter les adresses des clients) dans la section **Options**. 3. Vous pouvez collecter les **adresses de facturation uniquement** ou les **adresses de facturation et de livraison**. Quel que soit votre choix, les clients devront obligatoirement remplir ces champs. 4. Si vous collecter des adresses de livraison : - Vous devez sélectionner les pays vers lesquels vous proposez des options de livraison. Ces pays apparaissent dans la liste déroulante **Pays** du **formulaire d’adresse de livraison ** de la session Checkout. - Si vous le souhaitez, vous pouvez ajouter des frais de livraison. ### Collecter le numéro de téléphone Si vous devez collecter des numéros de téléphone pour mener à bien la transaction : 1. [Créez](https://dashboard.stripe.com/payment-links/create) ou modifiez un lien de paiement. 2. Sélectionnez **Demander aux clients d’indiquer leur numéro de téléphone**. #### API ### Collecter une adresse Pour collecter l’adresse de facturation d’un client depuis un lien de paiement, transmettez le paramètre `billing_address_collection` lorsque vous [créez un lien de paiement](https://docs.stripe.com/api/payment-link/create.md). Vous devez préciser si l’adresse de facturation doit être systématiquement collectée (`obligatoire`) ou uniquement lorsque cela est nécessaire (par exemple, pour le calcul des taxes) (`auto`). Pour collecter l’adresse de livraison d’un client depuis un lien de paiement, transmettez le paramètre `shipping_address_collection` lorsque vous [créez un lien de paiement](https://docs.stripe.com/api/payment-link/create.md). Lorsque vous collectez une adresse de livraison, vous devez également préciser les pays pour lesquels vous autorisez la livraison. Configurez la propriété `allowed_countries` à l’aide du tableau des [codes pays ISO à deux lettres](https://www.nationsonline.org/oneworld/country_code_list.htm). Lorsque le client clôture sa session, l’objet [Session Checkout](https://docs.stripe.com/api/checkout/sessions/object.md) enregistre l’adresse de livraison collectée dans la propriété `shipping_details` et l’inclut dans les données utiles du *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `checkout.session.completed`. Vous pouvez aussi consulter les informations de livraison sur la page du Dashboard contenant les détails du paiement. ### Collecter le numéro de téléphone Pour collecter le numéro de téléphone d’un client depuis un lien de paiement, transmettez le paramètre `phone_number_collection` lorsque vous [créez un lien de paiement](https://docs.stripe.com/api/payment-link/create.md). Vous pouvez configurer Payment Links de façon à ce qu’il collecte toujours une adresse de facturation, ou pour qu’il collecte toujours à la fois une adresse de facturation et une adresse de livraison. Lorsque vous collectez les adresses de livraison, vous pouvez définir les valeurs autorisées pour les pays de livraison et créer un ou plusieurs tarifs de livraison à inclure dans votre lien. Vous pouvez configurer Payment Links de façon à ce qu’il collecte un numéro de téléphone à des fins d’expédition ou de facturation. Ne collectez les numéros de téléphone que si vous en avez besoin pour la transaction. Lorsque vous choisissez cette option, la page de paiement affiche un champ obligatoire pour capturer le numéro de téléphone de votre client. ## Collectez les noms d’entreprise et les noms complets des clients Collectez les noms d’entreprise et les noms complets des clients sous forme de champs dans vos Payment Links. #### Dashboard Pour collecter les noms de vos clients à l’aide du Dashboard : 1. [Créez](https://dashboard.stripe.com/payment-links/create) ou modifiez un lien de paiement 2. Sélectionnez **Collect customer names** (collecter les noms des clients) 3. Configurez si vous souhaitez collecter des noms d’entreprise, des noms d’entrepreneurs individuels ou les deux. 4. (Facultatif) Sélectionnez **Marquer comme facultatif** si vous souhaitez que les clients fournissent leur nom s’ils le souhaitent. Sinon, les champs du nom seront obligatoires avant le paiement. #### API Pour activer la collecte des noms avec l’API, transmettez le paramètre `name_collection` lors de la [création](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-name_collection) ou de la [mise à jour](https://docs.stripe.com/api/payment-link/update.md#update_payment_link-name_collection) d’un lien de paiement. ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "name_collection[business][enabled]=true" \ -d "name_collection[business][optional]=true" \ -d "name_collection[individual][enabled]=true" ``` Lorsqu’un client termine une session, l’objet [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md) enregistre les noms collectés dans les champs `business_name` et `individual_name` de la propriété `collected_information`. Si la Checkout Session [a créé un nouveau client](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_creation) ou [mis à jour un client existant](https://docs.stripe.com/api/checkout/sessions/update.md#update_checkout_session-customer_update), les noms collectés apparaissent aussi dans les propriétés `business_name` et `individual_name`. De plus, vous pouvez consulter vos clients dans le [Dashboard](https://dashboard.stripe.com/customers). ## Collecter les numéros fiscaux des clients professionnels Pour afficher le numéro fiscal et la dénomination sociale d’un client sur les factures, activez la collecte du numéro fiscal dans vos liens de paiement. Découvrez comment [collecter les numéros fiscaux des clients avec Checkout](https://docs.stripe.com/tax/checkout/tax-ids.md). ## Collecter des taxes #### Stripe Tax Payment Links fonctionne avec [Stripe Tax](https://stripe.com/tax) pour calculer et collecter les taxes sur vos paiements. Stripe Tax est un produit payant qui calcule automatiquement les taxes liées à vos transactions, sans que vous ayez à définir des taux et des règles. Les frais s’appliquent uniquement après l’ajout d’au moins un de vos lieux d’immatriculation pour calculer les taxes et les verser. Pour commencer, [activez Stripe Tax](https://dashboard.stripe.com/tax) dans le Dashboard. Découvrez comment utiliser [les produits, les tarifs, les codes de taxe et le comportement fiscal](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md) pour calculer automatiquement les taxes. #### Dashboard Pour activer la collecte automatique des taxes à l’aide du Dashboard : 1. [Créez](https://dashboard.stripe.com/payment-links/create) ou modifiez un lien de paiement. 2. Sélectionnez **Collecter les taxes automatiquement**. Pour déterminer avec précision la taxe, Stripe Tax collecte l’adresse de facturation du client (adresse complète pour les clients des États-Unis). #### API Pour activer le recouvrement automatique des taxes avec l’API, transmettez le paramètre `automatic_tax[enabled]=true` lors de la [création](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-automatic_tax-enabled) ou de la [mise à jour](https://docs.stripe.com/api/payment-link/update.md#update_payment_link-automatic_tax-enabled) d’un lien de paiement. ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "automatic_tax[enabled]=true" ``` #### Managed Payments Si vous vendez des produits numériques, Managed Payments vous permet de vous décharger de la responsabilité fiscale sur Stripe. Nous sommes donc directement responsables de l’enregistrement, de la collecte, de la déclaration et du versement des taxes sur les ventes et de la TVA ou de la TPS dans le monde entier. En tant que solution de marchand officiel, Managed Payments gère également la prévention de la fraude, la gestion des litiges et le service de support client sur toutes les transactions. Découvrez comment [utiliser les liens de paiement avec Managed Payments](https://docs.stripe.com/payments/managed-payments/use-payment-links.md). ## Collecter le consentement à vos conditions d’utilisation #### Dashboard Vous pouvez exiger que vos clients acceptent vos conditions d’utilisation avant de finaliser leur achat. Lorsque vous définissez une URL des conditions d’utilisation dans les [détails publics](https://dashboard.stripe.com/settings/public) de votre compte, vous pouvez choisir d’exiger l’acceptation des conditions lors de la création d’un lien de paiement dans le Dashboard. L’activation de cette option oblige vos clients à cocher une case pour accepter vos conditions sur la page de paiement. La page de paiement inclut également un lien vers votre politique de confidentialité si vous avez défini une URL de politique de confidentialité dans les [détails publics](https://dashboard.stripe.com/settings/public) de votre compte. #### API Demandez à vos clients d’accepter les conditions du contrat d’utilisation du service en définissant [consent_collection.terms_of_service](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-consent_collection-terms_of_service) sur `required`. Une case à cocher s’affiche alors pour permettre aux clients d’accepter les conditions d’utilisation, avec un lien vers l’URL des conditions d’utilisation définie dans la section [Informations publiques](https://dashboard.stripe.com/settings/public) de votre Dashboard Stripe. Si vous définissez [consent_collection.terms_of_service](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-consent_collection-terms_of_service) sur `none`, Checkout n’affichera pas la case à cocher et les clients ne seront pas tenus d’accepter vos conditions d’utilisation du service. Avant d’exiger l’acceptation de vos conditions, définissez l’URL de vos Conditions d’utilisation du service dans les [Informations publiques](https://dashboard.stripe.com/settings/public) de votre entreprise. L’URL de votre Politique de confidentialité est facultative. Lorsque celle-ci est renseignée dans les [Informations publiques](https://dashboard.stripe.com/settings/public), Checkout y renvoie automatiquement. ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "consent_collection[terms_of_service]=required" ``` ## Ajouter des champs personnalisés > N’utilisez pas de champs personnalisés pour collecter des données personnelles, protégées ou sensibles, ni des informations que la loi interdit de recueillir. #### Dashboard Vous pouvez ajouter des champs personnalisés sur le formulaire de paiement pour recueillir des informations supplémentaires auprès de vos clients. Les informations sont disponibles une fois le paiement effectué et sont utiles pour traiter l’achat. Vous pouvez ajouter les types de champs ci-après : | Type | Description | | --- | --- | | Texte | Collecte du texte libre, jusqu’à 255 caractères. | | Chiffres uniquement | Collecte uniquement des valeurs numériques, jusqu’à 255 chiffres. | | Liste déroulante | Présente à vos clients une liste d’options dans laquelle opérer une sélection. Les liens de paiement créés depuis le Dashboard peuvent prendre en charge jusqu’à dix options. Vous pouvez ajouter jusqu’à 200 options après avoir créé un lien via l’API. | 1. Cliquez sur **Ajouter des champs personnalisés** dans la section **Options**. 2. Sélectionnez un type de champ à ajouter. 3. Saisissez un libellé pour le champ. 4. (Facultatif) Marquez votre champ comme obligatoire. Les libellés des champs personnalisés ne sont pas traduits, mais vous pouvez utiliser le [paramètre d’URL](https://docs.stripe.com/payment-links/customize.md#customize-checkout-with-url-parameters) `locale` pour que la langue de votre lien de paiement corresponde à celle de vos libellés. ![](https://b.stripecdn.com/docs-statics-srv/assets/customize-payment-link.8d578e56ad9a6171b4763b46e027aa01.png) Une fois que votre client a effectué le paiement, vous pouvez consulter les champs de la page des détails du paiement dans le Dashboard. ![](https://b.stripecdn.com/docs-statics-srv/assets/payment.56e708902bb56215b40e523371418a6e.png) Les champs personnalisés sont également inclus dans le [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) une fois le paiement effectué… #### API Créez un lien de paiement en spécifiant un tableau de [champs personnalisés](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-custom_fields). Chaque champ doit avoir une `key` unique utilisée par votre intégration pour effectuer le rapprochement. Ajoutez également un libellé pour le champ, qui sera affiché au client. Les libellés des champs personnalisés ne sont pas traduits, mais vous pouvez utiliser le [paramètre d’URL](https://docs.stripe.com/payment-links/url-parameters.md) `locale` pour définir la langue du lien de paiement et l’harmoniser avec celle de vos libellés. ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "custom_fields[0][key]=engraving" \ -d "custom_fields[0][label][type]=custom" \ -d "custom_fields[0][label][custom]=Personalized engraving" \ -d "custom_fields[0][type]=text" ``` Une fois la Checkout Session terminée, les champs sont disponibles sur la page des détails du paiement dans le Dashboard. Vous pouvez également [récupérer les champs personnalisés complétés](https://docs.stripe.com/payments/checkout/custom-components.md#retrieve-fields). Les champs personnalisés sont également inclus dans le [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) une fois le paiement effectué… ## Convertir automatiquement les prix en devises locales Chaque lien de paiement que vous partagez permet automatiquement à vos clients d’effectuer le paiement dans leur devise locale grâce à [Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md). Vous pouvez également définir manuellement les prix pour chaque devise en utilisant les[prix manuels des devises ](https://docs.stripe.com/payments/checkout/localize-prices/manual-currency-prices.md). ## Enregistrer les informations de paiement pour une utilisation ultérieure > Consultez votre conseiller juridique ou votre équipe de conformité concernant la conservation et l’utilisation des informations de paiement. Par exemple, le Comité européen de la protection des données a publié des [recommandations](https://www.edpb.europa.eu/documents/recommendation/recommendations-022021-on-the-legal-basis-for-the-storage-of-credit-card) relatives à la conservation des informations de paiement afin d’accélérer les paiements futurs. > > Si vous souhaitez enregistrer des moyens de paiement afin d’offrir une expérience de paiement en un clic facultative à vos clients récurrents, nous vous recommandons d’utiliser [Link](https://docs.stripe.com/payments/link/checkout-link.md). Pour enregistrer les informations de paiement d’un client, sélectionnez **Enregistrer les informations de paiement pour une utilisation ultérieure** dans la section **Options avancées** lorsque vous [créez un lien de paiement](https://dashboard.stripe.com/test/payment-links/create). ## Appliquer l’image de marque Vous pouvez personnaliser [l’apparence de la page de paiement](https://docs.stripe.com/payments/checkout/customization/appearance.md#font-compatibility) dans le Dashboard Stripe. Accédez aux [paramètres d’adaptation à votre marque](https://dashboard.stripe.com/account/branding/checkout) pour : - Charger un logo ou une icône - Personnaliser la couleur de l’arrière-plan, la couleur des boutons, les polices et la forme de la page de paiement Vous pouvez également personnaliser l’adaptation à votre marque pour les Payment Links via [Checkout studio](https://docs.stripe.com/payments/checkout-studio/how-it-works.md#customize-launch-checkout-integration), qui fournit un éditeur visuel permettant de configurer votre intégration Payment Links aux côtés de vos autres intégrations Checkout. ## Utiliser votre propre domaine Si vous avez votre propre domaine personnalisé, vous pouvez l’ajouter dans le Dashboard de Stripe. Au lieu d’utiliser des liens de paiement Stripe (`buy.stripe.com/`), vous pouvez créer des liens via votre sous-domaine (`pay.example.com`). En savoir plus sur [les domaines personnalisés](https://docs.stripe.com/payments/checkout/custom-domains.md). ## Définir les politiques de la boutique et les coordonnées Outre les coordonnées de votre service de support, vous pouvez afficher vos politiques de retour, de remboursement et juridiques sur la page de paiement. Accédez aux [paramètres Checkout et Payment Links](https://dashboard.stripe.com/settings/checkout) pour configurer les informations que vous souhaitez afficher. La présentation de ces informations peut renforcer la confiance des clients et réduire les [abandons de panier](https://docs.stripe.com/payments/checkout/abandoned-carts.md). ## Personnaliser le processus de paiement à l’aide de paramètres d’URL Les paramètres d’URL vous permettent d’ajouter du contexte supplémentaire à votre page de paiement et de simplifier vos paiements. Spécifiez la langue à afficher lors du paiement, remplissez automatiquement les codes promotionnels ou les adresses e-mail de vos clients, suivez vos campagnes commerciales et facilitez le rapprochement. Vous pouvez configurer les paramètres d’URL directement depuis le Dashboard Stripe et les utiliser dans la chaîne de requête de l’URL de votre lien de paiement. Sur la [page des liens de paiement](https://dashboard.stripe.com/payment-links), cliquez sur un lien de paiement spécifique, puis sur le bouton **Copier** dans le menu déroulant pour ajouter des paramètres d’URL. Voici un exemple de lien avec un e-mail prérempli, un code promotionnel et des paramètres régionaux. ```missinglanguage https://buy.stripe.com/test_eVa3do41l4Ye6KkcMN?prefilled_email=jenny%40example.com&prefilled_promo_code=20off&locale=de ``` | Paramètre | Description | Syntaxe | | --- | --- | --- | | `prefilled_email` | Utilisez `prefilled_email` pour saisir automatiquement une adresse e-mail sur la page de paiement. Votre client final pouvant modifier ce champ, il est possible que l’adresse e-mail indiquée pour `prefilled_email` ne soit pas celle utilisée par votre client pour effectuer le paiement. | `prefilled_email` doit être une adresse email valide. Les valeurs invalides ne sont pas prises en compte et votre page de paiement continue à fonctionner comme prévu. Nous vous recommandons de [chiffrer](https://en.wikipedia.org/wiki/Percent-encoding) les adresses e-mail que vous joignez en tant que paramètres d’URL afin d’éviter qu’elles ne soient pas transmises à votre page de paiement. | | `locked_prefilled_email` | Utilisez `locked_prefilled_email` pour entrer automatiquement une adresse email non modifiable sur la page de paiement. | `locked_prefilled_email` doit être une adresse email valide. Les valeurs invalides ne sont pas prises en compte et votre page de paiement continue à fonctionner comme prévu. Si `prefilled_email` et `locked_prefilled_email` sont tous deux passés, `locked_prefilled_email` est prioritaire. Nous vous recommandons de [chiffrer](https://en.wikipedia.org/wiki/Percent-encoding) les adresses e-mail que vous joignez en tant que paramètres d’URL afin d’éviter qu’elles ne soient pas transmises à votre page de paiement. | | `prefilled_promo_code` | Utilisez `prefilled_promo_code` pour saisir automatiquement un [code promotionnel](https://docs.stripe.com/api/promotion_codes.md) sur la page de paiement. Votre client peut toutefois modifier ce champ. Le code promotionnel que vous indiquez pour `prefilled_promo_code` peut donc ne pas être le même que celui utilisé par votre client pour effectuer le paiement. Vous devez également [activer les codes promotionnels](https://docs.stripe.com/payment-links/promotions.md) sur votre lien de paiement, sans quoi ce paramètre n’a aucun effet. | `prefilled_promo_code` doit être composé de caractères alphanumériques et ne peut pas utiliser de caractères spéciaux. Les codes promotionnels ne sont pas sensibles à la casse. Les valeurs invalides ne sont pas prises en compte et votre page de paiement continue à fonctionner comme prévu. | | `prefilled_amount` | Utilisez `prefilled_amount` pour définir le montant initial sur un lien de paiement à prix libre. Votre client peut toujours modifier ce montant avant de finaliser le paiement. Ce paramètre n’a aucun effet sur les liens de paiement à prix fixe. | `prefilled_amount` doit être un entier positif exprimé dans la plus petite unité de la devise du prix personnalisé. Par exemple, pour prédéfinir 20,00 USD, transmettez `prefilled_amount=2000`. La valeur doit également respecter les montants minimum et maximum configurés pour le prix personnalisé. Les valeurs non valides sont ignorées. Checkout utilise le montant prédéfini sauvegardé du lien de paiement comme solution de repli, ou affiche l’état vide par défaut si le lien ne contient aucun montant prédéfini sauvegardé. `prefilled_amount` limite la fonctionnalité des [prix multidevises](https://docs.stripe.com/products-prices/manage-prices.md#use-multi-currency-prices). Le montant est toujours dans la devise par défaut du prix, ce qui empêche Checkout d’utiliser automatiquement la devise locale du client et génère une erreur lorsque le lien de paiement est créé avec le paramètre [currency](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-currency) défini sur une devise autre que celle par défaut. | | `locale` | Utilisez le paramètre `locale` pour afficher votre lien de paiement dans une langue spécifique, quelle que soit la localisation de vos clients. | Consultez la liste complète des [langues prises en charge](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-locale) | Vous pouvez également utiliser des paramètres d’URL pour [suivre les liens de paiement et les campagnes associées](https://docs.stripe.com/payment-links/url-parameters.md). ## Limiter les clients à un seul abonnement Vous pouvez rediriger les clients ayant déjà un abonnement vers le *portail client* (The customer portal is a secure, Stripe-hosted page that lets your customers manage their subscriptions and billing details) ou vers votre site Web pour gérer leur abonnement. En savoir plus sur la [limitation des clients à un seul abonnement](https://docs.stripe.com/payments/checkout/limit-subscriptions.md). ## Prendre en charge les essais gratuits sans recueillir les détails du moyen de paiement En ce qui concerne les Payment Links que vous créez avec un produit incluant un essai gratuit, vous pouvez autoriser les clients à souscrire à un abonnement sans avoir à fournir les informations de leur moyen de paiement. #### Dashboard Pour configurer des essais en l’absence de moyen de paiement pour Payment Links dans le Dashboard : - Lorsque vous [créez](https://dashboard.stripe.com/payment-links/create) ou modifiez un lien de paiement avec des produits d’abonnement, sélectionnez **Inclure un essai gratuit**. Sélectionnez ensuite **Autoriser les clients à démarrer une période d’essai sans moyen de paiement**. - Configurez des [e-mails de rappel incitant vos clients à s’abonner](https://docs.stripe.com/payments/checkout/free-trials.md#collect-payment) afin que Stripe puisse leur demander d’ajouter leurs informations de paiement avant la fin de la période d’essai. À défaut, l’abonnement sera suspendu. #### API Pour configurer des essais en l’absence de moyen de paiement pour Payment Links dans l’API : - Configurez la durée de la période d’essai en utilisant [subscription_data.trial_period_days](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-subscription_data-trial_period_days). - Déterminez ce qui se passe à la fin de la période d’essai en utilisant [subscription_data.trial_settings.end_behavior.missing_payment_method](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-subscription_data-trial_settings-end_behavior-missing_payment_method). - Définissez [payment_method_collection](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-payment_method_collection) sur `if_required`. Cette opération ne peut être effectuée que pour Payment Links avec des produits d’abonnement. Découvrez comment [collecter les informations](https://docs.stripe.com/payments/checkout/free-trials.md#collect-payment) du moyen de paiement en dehors de Checkout avant la fin de la période d’essai d’un client. Dans le cas contraire, Stripe envoie une facture à votre client. ## Autoriser les quantités modifiables Vous pouvez configurer des liens de paiement afin de permettre à vos clients de modifier la quantité des articles achetés. #### Dashboard Pour autoriser la modification des quantités, [créez un lien de paiement](https://docs.stripe.com/payment-links/create.md) et ajoutez un produit. Dans l’éditeur du lien, accédez à **Page de paiement** > **Produit**, puis sélectionnez **Autoriser les clients à ajuster la quantité** dans la description du produit. Vous pouvez définir des quantités minimale et maximale. #### API Pour permettre à vos clients de modifier la quantité des articles qu’ils achètent, indiquez la valeur [adjustable_quantity](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-line_items-adjustable_quantity) pour le poste concerné. Vous pouvez également définir les quantités minimale et maximale autorisées : ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "line_items[0][adjustable_quantity][enabled]=true" \ -d "line_items[0][adjustable_quantity][minimum]=1" \ -d "line_items[0][adjustable_quantity][maximum]=10" ``` ## Percevoir des majorations Les majorations automatiques ajoutent une majoration à vos paiements Payment Links établis sur la base des informations de carte bancaire du client, notamment la marque de la carte bancaire, le type de financement et le pays émetteur. Stripe permet d’utiliser de manière transparente un fournisseur tiers de majoration afin de calculer de façon conforme le montant de la majoration. Cette fonctionnalité est en version bêta privée. [Demandez l’accès.](https://docs.stripe.com/payment-links/customize.md#checkout_beta_preview) ### Majoration automatique Enter your email to request access. ```bash curl https://docs.stripe.com/preview/register \ -X POST \ -H "Content-Type: application/json" \ -H "Referer: https://docs.stripe.com/payment-links/customize" \ -d '{"email": "EMAIL", "preview": "checkout_beta_preview"}' ``` > Les lois sur la majoration varient selon la juridiction. Avant d’utiliser cette fonctionnalité, vérifiez les [exigences de conformité](https://docs.stripe.com/payments/checkout/surcharge/automatic-surcharge.md#compliance) pour comprendre vos obligations. ### Installer une application de fournisseur de majoration Avant de pouvoir utiliser Automatic surcharge, installez l’application Stripe d’un prestataire de supplément depuis le [Dashboard App Marketplace](https://marketplace.stripe.com/) et effectuez le processus d’onboarding. Stripe prend en charge [Yeeld](https://marketplace.stripe.com/apps/yeeld) et [InterPayments](https://marketplace.stripe.com/apps/interpayments) pour la fourniture de suppléments. > Vous êtes responsable de vérifier que votre fournisseur calcule les majorations conformément aux lois applicables et aux règles des réseaux de cartes dans chaque juridiction où vous opérez. ### Créez un lien de paiement avec majoration automatique > #### Version de l’API > > Cette fonctionnalité nécessite une version bêta de l’API. Définissez l’en-tête `Stripe-Version` sur une version bêta de l’API lors de la création du lien de paiement. La majoration automatique pour Payment Links est uniquement disponible via l’API. Elle fonctionne avec des produits ponctuels et la tarification [customer-chooses-what-to-pay](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#variable-pricing), mais ne prend pas en charge les liens de paiement qui incluent les abonnements (c’est-à-dire tout lien qui a un [tarif récurrent](https://docs.stripe.com/products-prices/pricing-models.md)). Elle n’est pas non plus compatible avec [Adaptive Pricing](https://docs.stripe.com/payments/checkout/localize-prices/adaptive-pricing.md). Définissez [automatic_surcharge[enabled]](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-automatic_surcharge-enabled) sur `true` lors de la création d’un lien de paiement, ainsi qu’un `automatic_surcharge[calculation_basis]`. ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.preview" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "automatic_surcharge[enabled]=true" \ -d "automatic_surcharge[calculation_basis]=total_before_tax" ``` ### Base de calcul Le paramètre [automatic_surcharge[calculation_basis]](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-automatic_surcharge-calculation_basis) détermine le montant qui sert de base au calcul de la majoration. | Valeur | Description | Applications | | --- | --- | --- | | `total_before_tax` | Calcule la majoration sur le sous-total avant les taxes. Par exemple, une majoration de 3 % sur une commande de 100 USD soumise à une taxe de 10 USD = 3,00 USD de majoration. | Les réglementations ou les politiques d’entreprise exigent une majoration uniquement sur le montant avant les taxes. | | `total_after_tax` | Calcule la majoration sur le total après les taxes. Par exemple, une majoration de 3 % sur une commande de 100 USD soumise à une taxe de 10 USD = 3,30 USD de majoration (calculée sur 110 USD). | Vous souhaitez que la majoration couvre les frais de traitement des paiements sur l’intégralité du montant facturé. | ### Compatibilité fiscale La majoration automatique est compatible avec [Stripe Tax](https://docs.stripe.com/tax.md) en utilisant la taxation automatiquement. Utilisez [automatic_surcharge[taxer_behavior]](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-automatic_surcharge-tax_behavior) pour contrôler si la majoration est calculée TTC ou hors taxes. > Pendant cette phase d’aperçu privé, la majoration automatique n’est prise en charge qu’aux États-Unis. Les moyens de paiement pris en charge sont les cartes bancaires et Apple Pay. Les transactions effectuées avec un moyen de paiement non pris en charge ne sont pas soumises à une majoration applicable.