Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageUtiliser Managed Payments
Moyens de paiement
Interfaces de paiement
Scénarios de paiement
Paiements par TPE
Au-delà des paiements

Utiliser l'API pour créer et gérer des liens de paiement

Créez et gérez les liens de paiement avec l'API.

Vous pouvez utiliser l’API Payment Links pour créer un lien de paiement que vous pouvez partager avec vos clients. Stripe redirige les clients qui ouvrent ce lien vers une page de paiement hébergée par Stripe.

Configurer votre catalogue de produits

Les liens de paiement utilisent Products and Prices pour modéliser ce que votre entreprise vend. Pour commencer à utiliser les liens de paiement, créer un produit, puis utilisez ce produit pour créer un prix. Sinon, si vous souhaitez créer un prix ou un produit ad hoc pour une utilisation unique, vous pouvez ignorer cette étape et utiliser price_data à l’étape 2.

Payment Links prend en charge les tarifs forfaitaires, les arifs échelonnés, les lots et les les tarifs au choix (ce qui permet à votre client d’indiquer lui-même un tarif). À l’heure actuelle, le tarif au choix ne prend pas en charge les paiements récurrents ni les dons.

Utilisez un Flat rate pour créer un produit ou un abonnement à un montant fixe.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=1000 \
  -d product=
"{{PRODUCT_ID}}"

Créer un lien de paiement

Pour créer un lien de paiement, transmettez line_items. Chaque élément de ligne contient un price (ou price_data) et quantity. Les liens de paiement peuvent contenir jusqu’à 20 éléments de campagne lors de l’utilisation d’un tarif forfaitaire et 1 élément de campagne lors de l’utilisation d’Le client choisit le prix.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1

Partager votre 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.

Suivre des paiements

Lorsqu’un client utilise un lien de paiement pour effectuer un paiement, Stripe envoie un webhook checkout.session.completed, que vous pouvez utiliser pour traiter la commande et rapprocher vos écritures.

Si vous activez des moyens de paiement comme les prélèvements bancaires ou les bons de réduction, pour lesquels la confirmation peut prendre entre 2 et 14 jours, veillez à écouter des webhooks supplémentaires. Pour en savoir plus, consultez notre guide sur la réalisation des commandes après le paiement du client.

Lorsque vos clients effectuent des achats, vous pouvez les rediriger vers une URL ou afficher un message personnalisé en définissant un paramètre after_completion sur le lien de paiement.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "after_completion[type]"=redirect \
  --data-urlencode "after_completion[redirect][url]"="https://example.com"

Désactiver un lien de paiement

Une fois que vous avez créé un lien de paiement, vous ne pouvez plus le supprimer. En revanche, vous pouvez le désactiver en définissant l’attribut active sur false.

Une fois le lien désactivé, vos clients ne pourront plus l’utiliser pour finaliser leurs achats. Ils seront alors redirigés vers une page indiquant que le lien a expiré. Si vous souhaitez réutiliser un lien de paiement désactivé, réactivez-le en définissant l’attribut active sur true.

Configurer des moyens de paiement

Stripe sélectionne par défaut les moyens de paiement pertinents parmi ceux qui sont activés dans votre Dashboard Stripe. Pour ajouter d’autres moyens de paiement pris en charge, activez-les dans vos paramètres des moyens de paiement.

FacultatifAutoriser les bons de réduction et codes promotionnels

Créez et configurez des bons de réduction et des codes promotionnels pour vos liens de paiement via votre Dashboard ou l’API Promotion Code :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d allow_promotion_codes=true

FacultatifPercevoir les taxes via votre lien de paiement

Payment Links est compatible avec Stripe Tax , ce qui vous permet de calculer et de collecter les taxes sur vos paiements. Stripe Tax est un produit payant qui calcule automatiquement les taxes applicables à vos transactions, sans que vous ayez à définir de taux ni de règles.

Pour commencer, activez Stripe Tax dans votre Dashboard. Une fois Stripe Tax configuré, vous pouvez l’activer sur un nouveau lien de paiement :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "automatic_tax[enabled]"=true

Pour découvrir comment configurer votre catalogue de produits afin qu’il fonctionne avec Stripe Tax, consultez la page Spécifier les codes de taxe et le régime de taxe des produits.

FacultatifRecueillir les adresses de facturation et de livraison

Les liens de paiement recueillent automatiquement l’adresse de facturation du client dès lors que celle-ci est requise pour finaliser l’achat. Vous pouvez cependant modifier votre lien de paiement de façon à recueillir systématiquement l’adresse de facturation à l’aide du paramètre billing_address_collection. Vous pouvez aussi recueillir l’adresse de livraison du client en spécifiant les pays pris en charge à l’aide du paramètre shipping_address_collection :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]"=US

Si vous collectez des adresses de livraison, vous pouvez aussi ajouter des frais de livraison à votre lien de paiement en transmettant un tableau de shipping_options.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]"=US \
  -d "shipping_options[0][shipping_rate]"=
"{{SHIPPING_RATE_ID}}"

FacultatifAutoriser les quantités modifiables

Pour offrir à vos clients la possibilité de modifier la quantité des articles achetés, spécifiez le paramètre adjustable_quantity du poste de facture. Vous pouvez également définir les quantités minimale et maximale que vos clients peuvent acheter :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

FacultatifCréer des abonnements

Pour créer un abonnement à l’aide d’un lien de paiement, spécifiez une valeur de tarif type=recurring pour le paramètre line_items. Vous pouvez utiliser le paramètre subscription_data pour spécifier la configuration des abonnements (y compris des périodes d’essai) créés à partir du lien de paiement.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "subscription_data[trial_period_days]"=7

FacultatifIndiquez les moyens de paiement que vous souhaitez accepter

Pour spécifier un autre ensemble de moyens de paiement, définissez le paramètre payment_method_types lors de la création du lien de paiement.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=klarna

Pour certains moyens de paiement, comme les prélèvements bancaires ou les bons de réduction, la confirmation du paiement peut prendre entre 2 et 14 jours. Configurez des webhooks pour recevoir une notification une fois le paiement effectué, afin de pouvoir commencer à traiter la commande,

Vos clients verront les options Apple Pay et Google Pay s’ils les ont activées sur leur appareil. Les moyens de paiement que vos clients voient dépendent également du navigateur qu’ils utilisent.

FacultatifRecueillir le consentement aux Conditions d'utilisation du service

Recueillez le consentement des clients à vos Conditions d’utilisation du service en assignant à consent_collection.terms_of_service la valeur required. Cela permet d’afficher une case à cocher afin de recueillir le consentement du client aux Conditions d’utilisation du service et de fournir au client un lien vers l’URL des Conditions d’utilisation du service définie dans les Informations publiques de votre Dashboard Stripe.

Si vous assignez à consent_collection.terms_of_service la valeur none, Checkout n’affichera pas de case à cocher et n’exigera pas que les clients acceptent vos Conditions d’utilisation du service.

Avant d’exiger le consentement du client, définissez l’URL de vos Conditions d’utilisation du service dans les Informations publiques de votre entreprise. Il n’est pas indispensable de définir une URL de Politique de confidentialité (Checkout renvoie également vers votre Politique de confidentialité si une URL de Politique de confidentialité est définie dans vos Informations publiques).

Command Line
curl
Ruby
Python
PHP
Node.js
No results
curl https://api.stripe.com/v1/payment_links \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[0]"=card \
  -d "line_items[0][price]"=
'{{PRICE_ID}}'
 \
  -d "line_items[0][quantity]"=2 \
  -d "consent_collection[terms_of_service]"="required"

FacultatifAjouter des champs personnalisés

Mise en garde

N’utilisez pas de champs personnalisés pour collecter des données protégées ou sensibles, ni des informations limitées par la loi.

Créez un lien de paiement en spécifiant un tableau de champs personnalisés. Chaque champ doit être associé à une key unique que votre intégration utilise pour rapprocher le champ. Indiquez également le libellé du champ, qui sera affiché pour votre client. Les libellés de champs personnalisés ne sont pas traduits, mais vous pouvez utiliser le paramètre d’URL locale pour que la langue de votre lien de paiement corresponde à celle de vos libellés.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 que votre client a terminé la session Checkout, les champs sont disponibles dans le Dashboard sur la page des informations relatives au paiement. Vous pouvez également récupérer les champs personnalisés renseignés.

FacultatifPercevoir des commissions de plateforme avec Connect

Vous pouvez percevoir des commissions de plateforme pour chaque paiement effectué avec un lien de paiement. Reportez-vous à notre guide pour savoir comment percevoir des commissions de plateforme avec l’API Payment Links.

FacultatifEnvoyer des factures après paiement

Vous pouvez configurer Payment Links de façon qu’il envoie des factures détaillées à vos clients en cas de paiement ponctuel réussi. La création de factures pour les paiements ponctuels dans Payment Links est une fonctionnalité d’Invoicing et fait l’objet d’un tarif distinct.

Remarque

Payment Links crée automatiquement des factures pour les abonnements, sans configuration supplémentaire.

Pour activer la création de factures pour un lien de paiement, définissez le paramètre invoice_creation[enabled] sur true :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "invoice_creation[enabled]"=true

Vous pouvez personnaliser la facture à l’aide du hachage invoice_data dans invoice_creation :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "invoice_creation[enabled]"=true \
  -d "invoice_creation[invoice_data][description]"="Invoice for Product X" \
  -d "invoice_creation[invoice_data][metadata][order]"=order-xyz \
  -d "invoice_creation[invoice_data][account_tax_ids][0]"=DE123456789 \
  -d "invoice_creation[invoice_data][custom_fields][0][name]"="Purchase Order" \
  -d "invoice_creation[invoice_data][custom_fields][0][value]"=PO-XYZ \
  -d "invoice_creation[invoice_data][rendering_options][amount_tax_display]"=include_inclusive_tax \
  -d "invoice_creation[invoice_data][footer]"="B2B Inc."

À la fin de la session, Stripe envoie un récapitulatif de la facture à l’adresse e-mail fournie par votre client lors du paiement. Le récapitulatif contient des liens permettant de télécharger le reçu et la facture au format PDF.

Les reçus des paiements créés à l’aide de vos clés API de test ne sont pas envoyés automatiquement. Affichez ou envoyez un reçu manuellement à l’aide du Dashboard.

Capture d'écran du PDF de la facture que les clients peuvent télécharger à partir de l'e-mail récapitulatif de la facture

Autoriser vos clients à télécharger la facture au format PDF

Capture d'écran du reçu de la facture que les clients peuvent télécharger à partir de l'e-mail récapitulatif de la facture

Autoriser vos clients à télécharger le reçu de la facture

Capture d'écran de l'e-mail récapitulatif de facture envoyé par Stripe

Envoyer des liens par e-mail pour télécharger la facture au format PDF ou le reçu

Cette page vous a-t-elle été utile ?
OuiNon