Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
AperçuAccepter un paiementMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usagePaiements récurrents
Paiements par TPE
Disponibilité
Moyens de paiement
Opérations de paiement
Soldes et délai de règlementReçusRemboursements et annulations
Intégrations avancées
Au-delà des paiements

Créer un bouton d'achat intégrable

Utilisez Payment Links pour créer un bouton d'achat intégrable sur votre site Web.

Créez un bouton d’achat intégrable pour vendre un produit ou un abonnement, ou accepter un paiement sur votre site Web. Commencez par sélectionner un lien existant dans la liste des liens de paiement ou par créer un lien, ce qui vous permettra de décider des produits à vendre et de personnaliser l’interface utilisateur de paiement. Une fois votre lien créé, cliquez sur le bouton Acheter pour configurer le style du bouton d’achat et générer un code que vous pourrez copier et coller sur votre site Web.

Personnaliser le bouton

Par défaut, votre bouton d’achat utilise les mêmes attributs de marque et le même appel à l’action que ceux configurés pour votre lien de paiement. Vous pouvez :

  • Choisissez entre un bouton simple et un widget de carte.
  • Définissez des couleurs, formes et polices de caractères adaptées à votre site Web.
  • Définissez la langue du bouton et de la page de paiement pour qu’elle corresponde à celle de votre site Web.
  • Personnalisez l’appel à l’action de votre bouton.
Personnaliser le bouton d'achat

Personnaliser le bouton d’achat

Intégrer le bouton

Stripe fournit un code intégré composé d’une balise <script> et d’un composant Web <stripe-buy-button> web component. Cliquez sur Copier le code pour copier le code et le coller dans votre site Web.

Si vous utilisez du HTML, collez le code d’intégration dans le HTML. Si vous utilisez React, incluez la balise script dans votre page index.html pour monter le composant <stripe-buy-button>.

Mise en garde

Le bouton d’achat utilise la clé API publiable de votre compte. Si vous révoquez la clé API, vous devez mettre à jour le code d’intégration avec votre nouvelle clé API publiable.

index.html
HTML
React
No results
<body>
  <h1>Purchase your new kit</h1>
  <!-- Paste your embed code script here. -->
  <script
    async
    src="https://js.stripe.com/v3/buy-button.js">
  </script>
  <stripe-buy-button
    buy-button-id=
"{{BUY_BUTTON_ID}}"

    publishable-key=
"pk_test_oKhSR5nslBRnBZpjO6KuzZeX"

  >
  </stripe-buy-button>
</body>

Attributs pour personnaliser le paiement

ParamètreDescriptionSyntaxe
client-reference-idUtilisez client-reference-id pour associer une chaîne unique de votre choix à la CheckoutSession. La chaîne peut être un ID de client ou un ID de panier (ou similaire) que vous utilisez pour rapprocher la CheckoutSession de vos systèmes internes. Si vous transmettez ce paramètre à votre <stripe-buy-button>, il sera envoyé dans le webhook checkout.session.completed une fois le paiement exécuté.client-reference-id peut comprendre des caractères alphanumériques, des tirets et des traits de soulignement, et prendre n’importe quelle valeur jusqu’à 200 caractères. Les valeurs non valides sont ignorées et votre page de paiement continue à fonctionner comme prévu.
customer-emailUtilisez customer-email pour pré-remplir l’adresse e-mail sur la page de paiement. Lorsque la propriété est définie, le bouton d’achat la transmet à l’attribut customer_email de la CheckoutSession. Le client ne peut pas modifier l’adresse e-mail sur la page de paiement.customer-email doit être une adresse e-mail valide. Les valeurs non valides sont ignorées et vos pages de paiement continuent de fonctionner comme prévu.
customer-session-client-secretUtilisez la clé secrète du client pour transmettre un client existant.La valeur customer-session-client-secret doit être générée à partir de la clé secrète du client client_secret.

Transmettre un client existant

Utiliser l’API Accounts v2 pour représenter les clients

L’API Accounts v2 est généralement disponible pour les utilisateurs de Connect et en aperçu public pour les autres utilisateurs de Stripe. Si vous avez accès à l’aperçu Accounts v2, vous devez spécifier une version d’aperçu dans votre code.

Pour accéder à l’aperçu Accounts v2, rendez-vous sur aperçus et fonctionnalités de Account dans votre Dashboard et activez Moyens de paiement réutilisables pour les virements internationaux.

Dans la plupart des cas d’usage, nous vous recommandons de modéliser vos clients en tant qu’objets Account configurés par le client, plutôt que d’utiliser des objets Customer.

Vous pouvez fournir un objet customer-configured Account existant aux CheckoutSessions créées à partir du bouton d’achat. Authentifiez le client sur le serveur, puis créez sa CustomerSession et renvoyez-lui le client_secret.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/customer_sessions \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d "customer_account=
{{CUSTOMER_ACCOUNT_ID}}
" \
  -d "components[buy_button][enabled]=true"

Définissez l’attribut customer-session-client-secret du composant web <stripe-buy-button> sur le paramètre client_secret de la CustomerSession.

Vous devez fournir le client_secret dans un délai de 30 minutes. Après avoir fourni la clé secrète du client, vous disposez de 30 minutes supplémentaires jusqu’à l’expiration de la CustomerSession. Après son expiration, le bouton d’achat ne peut créer aucune CheckoutSessions.

Ne mettez pas en cache la clé secrète du client. Générez-en plutôt une nouvelle chaque fois que vous affichez un bouton d’achat.

index.html
HTML
React
No results
<body>
  <script
    async
    src="https://js.stripe.com/v3/buy-button.js">
  </script>
  <stripe-buy-button
    buy-button-id=
"{{BUY_BUTTON_ID}}"

    publishable-key=
"pk_test_oKhSR5nslBRnBZpjO6KuzZeX"

    customer-session-client-secret="{{CLIENT_SECRET}}"
  >
  </stripe-buy-button>
</body>

Politique de sécurité du contenu

Si vous avez établi une politique de sécurité du contenu, les obligations associées au bouton d’achat sont les suivantes :

  • frame-src, https://js.stripe.com
  • script-src, https://js.stripe.com

Limitations

L’affichage du bouton d’achat nécessite un domaine de site Web. Pour tester le bouton d’achat en local, exécutez un serveur HTTP local pour héberger le fichier index.html de votre site Web sur le domaine localhost. Pour exécuter un serveur HTTP local, utilisez le SimpleHTTPServer de Python ou le module npm http-server.

Suivre les paiements

Une fois que votre client a effectué un paiement à l’aide d’un lien de paiement, il s’affiche dans l’aperçu des paiements dans le Dashboard.

Si vous débutez sur Stripe, vous recevrez un e-mail suite à votre premier paiement. Pour recevoir des e-mails pour tous les paiements aboutis, mettez à jour vos préférences de notification dans vos paramètres d’informations personnelles.

Lorsque vous proposez un abonnement ou enregistrez un moyen de paiement pour un usage futur sans spécifier de client existant, la Checkout Session crée automatiquement un nouveau client. Pour les paiements ponctuels, la session utilise un client invité.

En savoir plus sur la gestion des liens de paiement après le paiement, comme la configuration du comportement des boutons d’achat ou des liens de paiement après le paiement.

Sur cette page