Intégrer la gestion des cartes Issuing à votre site WebBêta
Utilisez des composants d'interface utilisateur préconfigurés pour intégrer la gestion des cartes Issuing à votre site Web.
Bêta
Les composants Issuing intégrés sont en version bêta privée. Pour demander un accès, contactez-nous à l’adresse baas-embedded-components@stripe.com.
Donnez à vos comptes connectés l’accès à la fonctionnalité de gestion des cartes Issuing sur votre site Web à l’aide des composants intégrés Connect. Les composants intégrés Connect vous permettent de créer des intégrations complexes avec des produits Stripe qui ne nécessitent que peu de code et de configuration.
Stripe propose deux composants différents pour la gestion des cartes Issuing :
- Composant Issuing Card
- Composant Issuing Cards List
Conseil en matière de sécurité
Ces composants sont destinés aux administrateurs des comptes connectés, qui peuvent accéder aux données sensibles des cartes et des titulaires de cartes de l’ensemble du compte connecté. Ces composants ne doivent en aucun cas être utilisés pour afficher l’interface utilisateur de titulaires de cartes individuels.
Démarrage rapide![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Les composants intégrés Issuing Connect nécessitent un accès à Issuing et Connect.
Pour en savoir plus sur le fonctionnement des composants intégrés, consultez le guide sur les composants intégrés Connect. Le Quickstart des composants intégrés correspondant peut vous aider à configurer votre environnement.
Pour intégrer la gestion des cartes Issuing à votre site Web :
- Suivez les étapes permettant de créer un compte connecté avec des fonctionnalités Issuing.
- Créez un titulaire de carte et des cartes pour ce compte connecté.
- Créez une AccountSession avec
issuing_
oucard: {enabled: true} issuing_
.cards_ list: {enabled: true} - Ajoutez le composant
issuing-card
ouissuing-cards-list
au DOM.
Composant Issuing Card![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Le composant Issuing Card permet aux administrateurs d’afficher les détails de chaque carte. Depuis cette vue, ils peuvent activer, désactiver (bloquer) ou annuler des cartes. Si vous implémentez l’affichage des données sensibles, ils peuvent également afficher les numéros de carte (PAN) et les CVV ou CVC des cartes virtuelles.
Configuration du composant Issuing Card![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Ce composant intégré prend en charge le paramètre suivant :
Composant Issuing Cards List![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Le composant Issuing Cards List permet aux administrateurs d’afficher toutes les cartes d’un compte connecté. Ils peuvent filtrer les cartes par titulaire, date de création et type de carte.
Lorsque l’administrateur clique sur une ligne du tableau, une vue de la carte sélectionnée lui permet d’activer, de désactiver (bloquer) ou d’annuler la carte. Si vous implémentez l’affichage des données sensibles, il peut également afficher les numéros de carte (PAN) et le CVC ou les CVV (pour les cartes virtuelles).
Configuration du composant Issuing Cards List![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Ce composant intégré prend en charge les paramètres suivants :
Sensitive data display![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Issuing Connect embedded components integrate with Issuing Elements to provide a PCI-compliant way for you to allow your admins to view card numbers (PANs) and CVV or CVCs for virtual cards. The sensitive data renders inside Stripe-hosted iframes and never touches your servers.
The components can use an ephemeral key to securely retrieve card information from the Stripe API without publicly exposing your secret keys.
To enable this functionality you must:
- Set up an ephemeral key exchange on your server.
- Pass an asynchronous callback to the components.
Stripe generates a nonce
from the Card ID in the Issuing Card or Issuing Cards List component when a card is selected or loaded. Stripe then calls your callback function which returns an ephemeral key, and then renders a Show numbers
button if the ephemeral key is valid.
Ephemeral key exchange![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Your server-side endpoint needs to accept a Card ID and a nonce
. It can then create an ephemeral key using Stripe.
Here’s how you might implement an ephemeral key creation endpoint in web application frameworks across various languages:
Asynchronous callback![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You must define an asynchronous function that accepts a named argument with property issuingCard
which is a Card ID and additionally, a nonce
property. This function must return an Object
with properties issuingCard
, nonce
, and ephemeralKeySecret
which are retrieved from the endpoint you set up in the previous step.
Here’s how you might implement this callback:
Configuration supplémentaire![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Vous pouvez personnaliser et configurer vos composants intégrés Connect de façon à ce qu’ils s’adaptent à votre site Web. Vous pouvez définir cette configuration lorsque vous initialisez StripeConnectInstance
. Consultez la page Personnaliser l’apparence des composants intégrés Connect pour en savoir plus.