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

Payment Links s’appuie sur les produits et les tarifs pour modéliser les produits ou les services commercialisés par votre entreprise. Pour commencer à utiliser Payment Links, créez un produit, puis utilisez ce produit pour créer un tarif.

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.

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=1000 \
  -d product=
{{PRODUCT_ID}}

Pour créer un lien de paiement, transmettez line_items. Chaque poste contient un tarif et une quantité. Les liens de paiement peuvent comprendre jusqu’à 20 postes avec des tarifs standard, et un seul poste avec l’option Le client choisit le tarif.

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

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.

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.

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"

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.

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.