Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Ask AI
Créez un compte
Connectez-vous
Démarrer
Paiements
Automatisation des opérations financières
Plateformes et places de marché
Gestion de fonds
Outils de développement
Démarrer
Paiements
Automatisation des opérations financières
Démarrer
Paiements
Automatisation des opérations financières
Plateformes et places de marché
Gestion de fonds
Aperçu
À propos des paiements Stripe
Mettre votre intégration à niveau
Analyses des paiements
Paiements en ligne
PrésentationTrouver 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
Ajouter des moyens de paiement
Gérer les moyens de paiement
Paiement accéléré avec Link
Interfaces de paiement
Payment Links
Checkout
Web Elements
    Présentation
    Payment Element
    Express Checkout Element
      Migrer vers l'Express Checkout Element
      Comparaison d’Express Checkout Element
    Address Element
    Currency Selector Element
    Link Authentication Element
    Payment Method Messaging Element
Elements intégrés à l'application
Scénarios de paiement
Tunnels de paiement personnalisés
Acquisition flexible
Orchestration
Paiements par TPE
Terminal
Autres produits Stripe
Financial Connections
Cryptomonnaies
Climate
AccueilPaiementsWeb Elements

Express Checkout Element

Affichez plusieurs boutons de paiement en un clic à l'aide d'un seul composant.

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

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

Avec cette intégration, vous pouvez :

  • Trier dynamiquement les boutons de paiement en fonction du pays du client.
  • Ajouter des boutons de paiement sans modifier le front-end.
  • Intégrer facilement des Elements en réutilisant une instance Elements existante pour gagner du temps.

Essayer la démonstration

Dans la démonstration suivante, vous pouvez modifier certaines des options préconfigurées pour changer la couleur du fond, la mise en page, la taille et la collecte des adresses de livraison de l’interface de paiement. Cette démonstration affiche Google Pay et Apple Pay uniquement sur les plateformes disponibles. Les boutons des moyens de paiement ne s’affichent que dans les pays où ils sont pris en charge.

Si la démo ne s’affiche pas, essayez d’ouvrir la page dans un navigateur pris en charge.

OptionDescription
Pays du marchandSet this using the publishable key that you use to initialize Stripe.js. To change the country, you must unmount the Express Checkout Element, update the publishable key, then re-mount the Express Checkout Element.
Background colorSet colors using the Elements Appearance API. Button themes are inherited from the Appearance API but you can also define them directly when you create the Element.
Desktop and mobile sizeUse the dropdown to set the max pixel width of the parent element that the Express Checkout Element is mounted to. You can set it to 750px (Desktop) or 320px (Mobile).
Max columns and max rowsSet these values using the layout parameter when you Create the Express Checkout Element.
Overflow menuSet this using the layout parameter when you Create the Express Checkout Element.
Collect shipping addressTo collect shipping information, you must pass options when creating the Express Checkout Element. Learn more about collecting customer details and displaying line items.

Commencer par un guide

Ajoutez des wallets en un clic à votre page de paiement

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

Utiliser les wallets en un clic avec des intégrations avancées

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

Migrer vers l'Express Checkout Element

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

Consulter la documentation Stripe.js

Moyens de paiement

L’Express Checkout Element présente les moyens de paiement en un clic actifs, pris en charge et configurés.

  • Certains moyens de paiement nécessitent une activation dans le Dashboard.
  • Les moyens de paiement ne sont disponibles que si le client utilise un navigateur compatible et effectue son règlement 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’Express Checkout Element 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 paiement ne fonctionnent qu’avec certains 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 Chromium peuvent être pris en charge. Pour en savoir plus, consultez la section navigateurs pris en charge.

2 Lors de l’utilisation d’un iframe, son origine doit correspondre à l’origine de niveau supérieur (sauf pour Safari 17 et les versions ultérieures lorsque vous spécifiez l’attribut allow="payment"). Deux pages ont la même origine si le protocole, l’hôte (nom de domaine complet) et le port (le cas échéant) sont les mêmes pour les deux pages.

Affichage

Par défaut, lorsque l’Element Express Checkout affiche plusieurs boutons, ils sont organisés en grille selon l’espace disponible et un menu déroulant s’affiche si nécessaire.

Vous pouvez remplacer cette valeur par défaut et définir vous-même une mise en page en grille avec l’option layout.

Texte

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

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

Nous essayons de détecter la langue de votre client et de l’utiliser pour localiser le texte du bouton. Vous pouvez également spécifier une langue.

Dans cet exemple de code, l’appel à l’action « Acheter » ou « Acheter maintenant » est inclus pour les boutons le prenant en charge. Ensuite, il spécifie la langue de pour obtenir ses équivalents en allemand.

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

Apparence

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

  • Hauteur des boutons
  • Angle des bordures à l’aide de variables avec l’API Appearance
  • Thèmes des boutons

Remarque

Le bouton Apple Pay est automatiquement redimensionné lorsque le rayon de la bordure dépasse un certain seuil. Si vous modifiez le rayon de la bordure par défaut, veillez à le tester avec tous les moyens de paiement actifs.

Cet exemple de code permet de configurer un groupe d’éléments avec un thème clair et un angle des bordures de 36 px, de créer des boutons de 50 px de hauteur et de remplacer 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 propose un seul thème de bouton, lisible sur un arrière-plan clair comme foncé.

Personnaliser les moyens de paiement

Vous ne pouvez pas spécifier 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.

Cela dit, vous pouvez personnaliser le comportement des moyens de paiement de différentes manières :

  • Vous pouvez activer ou désactiver des moyens de paiement depuis le Dashboard.
  • Vous pouvez remplacer la logique de tri par pertinence de Stripe, configurée par défaut. Utilisez l’option paymentMethodOrder pour définir votre ordre de préférence.
  • Si l’espace sur la page est insuffisant, les moyens de paiement les moins pertinents peuvent apparaître dans un menu déroulant. Personnalisez les paramètres de l’affichage du menu à l’aide de l’option layout.
  • Pour ne pas afficher Apple Pay ou Google Pay, définissez paymentMethods.applePay ou paymentMethods.googlePay sur never.
  • Pour autoriser l’affichage d’Apple Pay ou de Google Pay quand ils ne sont pas configurés, définissez paymentMethods.applePay ou paymentMethods.googlePay sur always. Cependant, cela ne permet pas de forcer leur affichage sur des plateformes non compatibles ou lorsque le paiement est effectué dans une devise non prise en charge.

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

En Finlande et en Suède, en cas de paiement, la réglementation impose la présentation de moyens de paiement par débit avant les moyens de paiement par crédit.

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