# Utiliser les lients de paiement avec Managed Payments Vendez des produits numériques dans le monde entier tandis que Stripe gère pour vous la conformité fiscale indirecte, la protection contre la fraude, la gestion des litiges et le service de support aux transaction client. Activez Managed Payments, puis créez un [lien de paiement](https://docs.stripe.com/payment-links.md) pour collecter instantanément les paiements pour vos produits numériques. Vous pouvez créer des liens de paiement dans le [Dashboard](https://dashboard.stripe.com/payment-links) sans écrire de code, ou avec l’[API Payment Links](https://docs.stripe.com/api/payment-link.md). En savoir plus sur [le fonctionnement de Managed Payments](https://docs.stripe.com/payments/managed-payments/how-it-works.md). ## Before you begin - Assurez-vous que vos produits répondent aux [critères d’éligibilité](https://docs.stripe.com/payments/managed-payments/eligibility.md#product-eligibility) de Managed Payments. Vous ne pouvez créer un lien de paiement avec Managed Payments activé que si tous les produits que votre client souhaite acheter sont éligibles. - Activez Managed Payments dans votre [Dashboard](https://dashboard.stripe.com/settings/managed-payments) ## Créer un lien de paiement #### Dashboard 1. Dans le Dashboard, sur la page [Payment Links](https://dashboard.stripe.com/payment-links), cliquez sur **Nouveau** (ou cliquez sur le signe plus (**+**) et sélectionnez **Lien de paiement**). 1. Sélectionnez un produit existant, ajoutez un nouveau produit ou permettez aux clients de choisir le montant à payer. 1. Assurez-vous que les produits sélectionnés font partie d’une catégorie de produits éligible à Managed Payments. 1. Assurez-vous que **Activer Managed Payments** est sélectionné. 1. Cliquez sur **Créer un lien**. > Nous ne prenons pas en charge la création de liens de paiement avec Managed Payments activé via l’application Stripe sur iOS. Utilisez plutôt la version web du Dashboard. #### API Pour utiliser Managed Payments avec l’[API Payment Links](https://docs.stripe.com/api/payment-link.md), vous devez utiliser la version d’API `2025-03-31.basil` ou [ultérieure](https://docs.stripe.com/changelog.md). #### Produits ou abonnements ### Créer un produit Vous pouvez utiliser **Produits et tarifs** pour vendre des produits ponctuels ou des abonnements. Pour ce faire, créez un produit, puis attribuez un tarif. Vous devez inclure un code fiscal [éligible à Managed Payments](https://docs.stripe.com/payments/managed-payments/eligibility.md#eligible-tax-codes). ```curl curl https://api.stripe.com/v1/products \ -u "<>:" \ --data-urlencode "name=Hamlet (e-book)" \ -d "description=A Shakespearean tragedy" \ -d tax_code={{TAX_CODE}} \ -d "default_price_data[unit_amount]=1000" \ -d "default_price_data[currency]=usd" ``` ### Créer le lien de paiement Pour créer un lien de paiement avec Managed Payments activé, transmettez le paramètre `managed_payments[enabled]` à l’endpoint de l’[API Payment Links](https://docs.stripe.com/api/payment-link.md), ainsi que [line_items](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-line_items). Chaque poste contient un [price](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-line_items-price) et une [quantity](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-line_items-quantity). Vous pouvez ajouter jusqu’à 20 postes pour les tarifs forfaitaires. ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "managed_payments[enabled]=true" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" ``` Lors de la création du lien de paiement, vous pouvez utiliser [price_data](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-line_items-price_data) pour créer un produit et son tarif. Pour créer un abonnement à l’aide d’un lien de paiement, spécifiez un tarif avec [type=recurring](https://docs.stripe.com/api/prices/object.md#price_object-type) dans `line_items`. Utilisez [subscription_data](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-subscription_data) pour définir la configuration des abonnements créés via le lien de paiement, y compris les périodes d’essai. #### Le client choisit le tarif ### Créer un tarif variable Configurez des [tarifs variables](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#variable-pricing) pour permettre à vos clients de choisir le prix à payer pour votre produit. Votre produit doit être un produit numérique [éligible à Managed Payments](https://docs.stripe.com/payments/managed-payments/eligibility.md#product-eligibility). ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d "custom_unit_amount[enabled]=true" \ -d "product={{PRODUCT_ID}}" ``` ### Créer un lien de paiement Créez un lien de paiement en transmettant le paramètre `managed_payments[enabled`] à l’endpoint de l’[API Payment Links](https://docs.stripe.com/api/payment-link.md), ainsi que [line_items](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-line_items). Vous pouvez inclure un poste pour les tarifs définis par le client. ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "managed_payments[enabled]=true" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" ``` ### Partager le lien de paiement Chaque lien de paiement contient une URL que vous pouvez partager avec vos clients par e-mail, sur les réseaux sociaux, via un site web, dans une application ou via tout autre canal. ## Mettez à jour une intégration existante de l’API Payment Links pour utiliser Managed Payments Suivez les étapes ci-dessus pour créer de nouveaux liens de paiement avec Managed Payments activé. ### Supprimer les paramètres non pris en charge Pour agir en tant que marchand officiel, Stripe contrôle certaines parties de la session de paiement. Par conséquent, certains paramètres ne sont pas disponibles lorsque vous utilisez Managed Payments, et vous devez les supprimer lorsque vous créez des liens de paiement avec Managed Payments activé. | Catégorie | Paramètre | Motif | | ------------------------------------------------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Taxe | `automatic_tax` | Managed Payments s’occupe du calcul et de la collecte des taxes pour vous. | | `tax_id_collection` | | Moyens de paiement | `payment_method_types` | Managed Payments contrôle les moyens de paiement disponibles sur le lien de paiement à l’aide de [moyens de paiement dynamiques](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md) afin d’afficher les moyens de paiement les plus pertinents pour votre client. Reportez-vous à la section [Configurations des moyens de paiement](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments) pour apprendre à configurer les paramètres des moyens de paiement pour Managed Payments. | | Livraison | `shipping_address_collection` | Managed Payments prend uniquement en charge les produits numériques, de sorte que les informations de livraison ne sont jamais collectées. | | `shipping_options` | | Connect | `application_fee_amount` | Managed Payments ne prend pas en charge les intégrations Connect. | | `application_fee_percent` | | `on_behalf_of` | | `transfer_data` | | `payment_intent_data.transfer_group` | | Après-vente | `subscription_data.invoice_settings` | Managed Payments gère pour vous les actions après-vente, telles que la facturation et les e-mails de confirmation. | | `invoice_creation` | | Libellés de relevé bancaire | `payment_intent_data.statement_descriptor` | Managed Payments gère les libellés de relevé bancaire pour le compte de votre entreprise. | | `payment_intent_data.statement_descriptor_suffix` | | `consent_collection.payment_method_reuse_agreement.position` | | Options du bouton Envoyer (limité) | `submit_type='donate'` | Managed Payments ne prend pas en charge les dons ou la vente de services. Les autres options [submit_type](https://docs.stripe.com/api/payment-link/object.md#payment_link_object-submit_type) sont prises en charge. | | `submit_type='book'` | | Personnalisation | `custom_text` | Managed Payments fournit un paiement standardisé qui ne prend pas en charge le texte personnalisé. | ## Modifier les liens de paiement Après avoir créé un lien de paiement, vous ne pouvez plus modifier l’état de Managed Payments sur ce lien. - Vous ne pouvez pas activer Managed Payments sur des liens de paiement existants. Pour utiliser Managed Payments, vous devez créer un nouveau lien de paiement. - Une fois que vous avez créé le lien de paiement avec Managed Payments activé, vous ne pouvez pas désactiver Managed Payments sur ce lien. Vous devez créer un nouveau lien de paiement sans Managed Payments activé. ## Tests Testez si votre intégration fonctionne correctement pour vos clients. ### Checkout 1. Accédez à l’URL du lien de paiement pour charger votre page de paiement. 1. Sur la page de paiement, saisissez différentes adresses de facturation pour voir comment Managed Payments calcule les taxes pour les clients de différents pays ou territoires. 1. Pour traiter le paiement, utilisez le numéro de carte bancaire test `4242 4242 4242 4242` avec n’importe quel CVC et une date d’expiration ultérieure. Pour en savoir plus, consultez la section [Tests](https://docs.stripe.com/testing.md). ### Détails du paiement #### Item 1 1. Après avoir confirmé le paiement test, accédez au **Dashboard** > [Transactions](https://dashboard.stripe.com/test/payments). 1. Cliquez sur votre paiement test pour afficher les détails du paiement. Cette page affiche : - Produit acheté - [Abonnement](https://docs.stripe.com/api/subscriptions.md) créé - [Facture](https://docs.stripe.com/api/invoices.md) créée - Montant des taxes calculées et retenues via Managed Payments - Libellé de relevé bancaire qui s’affiche sur les relevés de votre client > #### Autorisation client > > Lorsqu’un client achète un abonnement via Managed Payments, il autorise uniquement son moyen de paiement à être débité par Managed Payments. Assurez-vous d’obtenir le consentement approprié de votre client pour débiter ce moyen de paiement pour toute transaction en dehors de Managed Payments. #### Item 2 1. Après avoir confirmé le paiement test, accédez au **Dashboard** > [Transactions](https://dashboard.stripe.com/test/payments). 1. Cliquez sur votre paiement test pour afficher les détails du paiement. Cette page affiche : - Produit acheté - [Abonnement](https://docs.stripe.com/api/subscriptions.md) créé (si acheté) - [Facture](https://docs.stripe.com/api/invoices.md) créée - Montant des taxes calculées et retenues via Managed Payments - Libellé de relevé bancaire qui s’affiche sur les relevés de votre client ### Aperçu du reçu 1. Sous **Historique des reçus**, cliquez sur **Afficher le reçu**. 1. Cliquez sur **Envoyer reçu** pour avoir un aperçu du reçu envoyé par e-mail à votre client. > En environnement de test, vous ne recevrez pas automatiquement les e-mails de reçu après un achat mais pourrez les envoyer manuellement en suivant les instructions ci-dessus. ### Tester Link [Link](https://docs.stripe.com/payments/link.md) agit en tant que marchand officiel lors du paiement et propose la gestion des abonnements ainsi qu’un support pour les transactions sur le site [Link](https://link.com). Vous pouvez tester le fonctionnement de Link au moment du paiement en créant un compte Link lors d’une Checkout Session initiale. Après avoir créé le compte Link, tentez une autre session en utilisant la même adresse e-mail. Pour vous identifier, utilisez le code d’accès de test `000000`. Les achats de test n’apparaîtront pas dans l’application Link. Vous pouvez tester les outils de gestion des commande dans l’application Link en créant un compte Link pendant une Checkout Session en mode production. ## Optional: Configurer le régime de taxe de vos tarifs Le champ [tax_behavior](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#tax-behavior) d’un tarif indique si la taxe est ajoutée en plus du tarif que vous définissez (`tax_behavior: exclusive`) ou si elle est déjà incluse dans le prix (`tax_behavior: inclusive`). Managed Payments utilise le [comportement fiscal défini sur votre tarif](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#set-tax-behavior-on-price). Si vous ne définissez pas le comportement fiscal du tarif, par défaut, Managed Payments ajoute la taxe en plus du tarif que vous définissez. Pour modifier la valeur par défaut, accédez à la page [Paramètres de Tax](https://dashboard.stripe.com/settings/tax) dans le Dashboard et mettez à jour le paramètre **Inclure la taxe dans les tarifs**.