Accéder directement au contenu
Créez un compte
ou
connectez-vous
Le logo de la documentation Stripe
/
Demander à l’IA
Créer un compte
Connectez-vous
Commencer
Paiements
Revenus
Plateformes et places de marché
Gestion des fonds
Outils de développement
Aperçu
À propos des paiements Stripe
Mettre votre intégration à niveau
Analyses des paiements
Paiements en ligne
AperçuTrouver votre cas d'usageManaged Payments
Utiliser Payment Links
Créer une page de paiement
Développer une intégration avancée
Développer une intégration dans l'application
Moyens de paiement
Ajout de moyens de paiement
Gérer les moyens de paiement
Payer plus rapidement avec Link
Interfaces de paiement
Payment Links
Paiement
Web Elements
    Aperçu
    Payment Element
    Express Checkout Element
      Migrer vers l'Express Checkout Element
      Comparaison d’Express Checkout Element
    Element Address
    Currency Selector Element
    Link Authentication Element
    Payment Method Messaging Element
Elements dans l'application
Scénarios de paiement
Flux de paiement personnalisés
Acquisition flexible
Orchestration
Paiements en personne
Terminal
Autres produits Stripe
Financial Connections
Cryptomonnaie
Climate
AccueilPaiementsWeb Elements

Express Checkout Element

Afficher plusieurs boutons de paiement en un clic avec un seul composant.

Copier la page
Expérience utilisateur du paiement affichant les boutons Apple Pay, Link et PayPal

The Express Checkout Element is an integration for accepting payments through click-to-pay payment methods buttons. Supported payment methods include Link, Apple Pay, Google Pay, PayPal, Klarna, and Amazon Pay.

Avec cette intégration, vous pouvez :

  • Triez dynamiquement les boutons de paiement en fonction de la région d’un client.
  • Ajoutez des boutons de paiement sans aucune modification à l’application frontale.
  • Intégrez facilement Elements en réutilisant une instance Elements existante pour gagner du temps.

Lancer la démo

Dans la démo suivante, vous pouvez basculer certaines des options prédéfinies pour modifier la couleur d’arrière-plan, la mise en page, la taille et la collection d’adresses d’expédition de l’interface de paiement. La démo affiche Google Pay et Apple Pay uniquement sur leurs plateformes disponibles. Les boutons de mode de paiement ne sont affichés que dans les pays pris en charge.

Si vous ne voyez pas la démo, essayez d’afficher cette page dans un navigateur pris en charge.

OptionDescription
Pays du marchandConfigurez ce paramètre à l’aide de la clé publiable que vous utilisez pour initialiser Stripe.js. Pour modifier le pays, vous devez démonter l’Express Checkout Element, mettre à jour la clé publique, puis remonter l’Express Checkout Element.
Couleur d’arrière-planDéfinissez les couleurs à l’aide de l’API Elements Appearance. Les thèmes des boutons sont hérités de l’API Appearance, mais vous pouvez aussi les définir directement lors de la création de l’Element.
Taille bureau et mobileUtilisez la liste déroulante pour définir la largeur maximale en pixels de l’élément parent auquel l’Express Checkout Element est monté. Vous pouvez la définir sur 750px (bureau) ou 320px (mobile).
Nombre max. de colonnes et de lignesDéfinissez ces valeurs à l’aide du paramètre layout lorsque vous créez l’Express Checkout Element.
Menu de débordementDéfinissez ce paramètre à l’aide du paramètre layout lorsque vous créez l’Express Checkout Element.
Collecter l’adresse de livraisonPour collecter les informations de livraison, vous devez transmettre les options lors de la création du composant Express Checkout Element. En savoir plus sur la collecte des informations des clients et l’affichage des postes de facture.

Commencer par un guide

Add click-to-pay wallets to your checkout page

Créez une intégration avec Express Checkout Element à l’aide de l’API Checkout Sessions.

Use click-to-pay wallets in advanced integrations

Créez une intégration avec Express Checkout Element à l’aide de l’API Payment Intents.

Migrer vers l'Express Checkout Element

Migrez de Payment Request Button Element vers l’Express Checkout Element Web.

Voir la référence Stripe.js

Moyens de paiement

The Express Checkout Element presents click-to-pay payment methods that are active, supported, and set up.

  • Certains moyens de paiement nécessitent l’activation dans le Dashboard.
  • Les moyens de paiement ne sont disponibles que si le client utilise un navigateur pris en charge et effectue son paiement dans une devise prise en charge.
  • Certains moyens de paiement nécessitent des actions de configuration de la part du client. Par exemple, un client ne verra pas de bouton Google Pay s’il n’a pas configuré Google Pay.
  • Enregistrez votre domaine à la fois dans votre environnement de test et en mode production.

L’élément trie les moyens de paiement en fonction de leur pertinence pour votre client.

Pour contrôler ces comportements, vous pouvez personnaliser les moyens de paiement.

Navigateurs pris en charge

Certains moyens de moyens de paiement fonctionnent avec des navigateurs spécifiques.

Apple PayGoogle PayLinkPayPalAmazon PayKlarna
Chrome1
Edge
Firefox
Opera
Safari2
Chrome sur iOS 16+
Firefox sur iOS 16+
Edge sur iOS 16+

1 D’autres navigateurs Chrome peuvent être pris en charge. Pour en savoir plus, consultez la rubrique Navigateurs pris en charge.

2Lors de l’utilisation d’un iframe, son origine doit correspondre à l’origine de premier niveau (à l’exception de Safari 17+ lors de la spécification de l’attribut allow="payment"). Deux pages ont la même origine si le protocole, l’hôte (nom de domaine complet) et le port (si spécifié) sont les mêmes pour les deux pages.

Mise en page

Par défaut, lorsque l’Express Checkout Element affiche plusieurs boutons, il les organise dans une grille en fonction de l’espace disponible et affiche un menu déroulant si nécessaire.

Vous pouvez remplacer cette disposition par défaut et préciser vous-même une mise en page de grille avec l’option disposition.

Texte

Vous pouvez contrôler le texte d’un bouton en sélectionnant un type de bouton. Chaque portefeuille numérique propose ses propres types de boutons.

Link n’offre qu’un seul type de bouton, qui présente l’appel à l’action « Payer avec Link » et le logo Link.

Nous essayons de détecter les paramètres régionaux de votre client et de les utiliser pour localiser le texte du bouton. Vous pouvez également préciser des paramètres régionaux.

Cet exemple de code comprend l’appel à l’action « Acheter » ou « Acheter maintenant » pour les boutons qui le prennent en charge. Ensuite, il précise les paramètres régionaux de pour obtenir les équivalents en allemand.

const expressCheckoutOptions = { buttonType: { applePay: 'buy', googlePay: 'buy', paypal: 'buynow', klarna: 'pay', } } const elements = stripe.elements({ locale: 'de',

Appearance

Vous ne pouvez pas entièrement personnaliser l’apparence des boutons Express Checkout Element, car chaque moyen de paiement a son propre logo et les couleurs de sa marque définis. Vous pouvez personnaliser les options suivantes :

  • Hauteur des boutons
  • Rayon de la bordure à l’aide de variables avec l’API Appearance
  • Thèmes des boutons

Remarques

Le bouton Apple Pay se redimensionne automatiquement lorsque le rayon de la bordure augmente au-delà d’un certain seuil. Si vous modifiez le rayon de la bordure par défaut, assurez-vous de le tester avec tous les moyens de paiement actifs.

Cet exemple de code configure un groupe d’éléments avec un thème clair et un rayon de bordure de 36 px, crée des boutons d’une hauteur de 50 px et remplace le thème pour utiliser la version à contour blanc du bouton Apple Pay.

const appearance = { theme: 'stripe', variables: { borderRadius: '36px', } } const expressCheckoutOptions = { buttonHeight: 50, buttonTheme: {

Nous prenons en charge les thèmes suivants :

Link a un thème à bouton unique, lisible sur un arrière-plan clair ou foncé.

Personnaliser les moyens de paiement

Vous ne pouvez pas préciser les moyens de paiement à afficher. Par exemple, vous ne pouvez pas forcer l’affichage d’un bouton Google Pay si l’appareil de votre client ne prend pas en charge Google Pay.

Mais vous pouvez personnaliser le comportement du moyen de paiement de différentes manières, notamment :

  • Vous pouvez activer ou désactiver les moyens de paiement à partir du Dashboard.
  • Vous pouvez remplacer la logique par défaut de Stripe qui consiste à trier les moyens de paiement par ordre de pertinence. Utilisez l’option paymentMethodOrder pour définir votre ordre préféré.
  • S’il n’y a pas assez d’espace dans la mise en page, les moyens de paiement peu pertinents peuvent figurer dans un menu de débordement. Personnalisez le moment où le menu est affiché à l’aide de l’option diposition.
  • Pour empêcher qu’Apple Pay ou que Google Pay soient affichés, définissez paymentMethods.applePay ou paymentMethods.googlePay à never.
  • Pour permettre à Apple Pay ou Google Pay d’être affichés alors qu’ils ne sont pas configurés, définissez paymentMethods.applePay ou paymentMethods.googlePay à always. Cela ne les forcera pas à être affichés sur les plateformes non prises en charge, ou lorsque le paiement est effectué dans une devise non prise en charge.

Spécificités régionales
Finlande
Suède

La réglementation en vigueur en Finlande et en Suède exige que vous présentiez d’abord les moyens de paiement par débit avant d’indiquer les moyens de paiement par crédit lors du paiement effectué dans ces pays.

Cette page vous a-t-elle été utile?
OuiNon
Besoin d'aide? Contactez le service d'assistance.
Rejoignez notre programme d'accès anticipé.
Consultez notre journal des modifications.
Des questions? Contactez l'équipe commerciale.
GML? Lire llms.txt.
Optimisé par Markdoc