# Link dans le Payment Element

Permettez à vos clients de payer plus rapidement avec Link dans le Payment Element.

Permettez à vos clients de payer plus rapidement en utilisant [Link](https://docs.stripe.com/payments/link.md) dans le [composant Element Payment](https://docs.stripe.com/payments/payment-element.md). Vous pouvez remplir automatiquement les informations pour tout client connecté utilisant déjà Link, même s’il a initialement enregistré ses informations avec Link auprès d’une autre entreprise. L’intégration par défaut du composant Element Payment inclut une invite Link dans le formulaire de carte bancaire. Pour gérer Link dans le composant Element Payment, accédez à vos [paramètres de moyens de paiement](https://dashboard.stripe.com/settings/payment_methods).
![S'identifier ou s'inscrire auprès de Link directement dans le composant Payment Element au moment du paiement](https://b.stripecdn.com/docs-statics-srv/assets/link-in-pe.2efb5138a4708b781b8a913ebddd9aba.png)

Collectez l’adresse e-mail d’un client pour l’authentification ou l’inscription Link

## Options d’intégration

L’intégration de Link au composant Element Payment peut se faire de deux façons. Parmi celles-ci, Stripe recommande de transmettre l’adresse e-mail d’un client au composant Element Payment, le cas échéant. N’oubliez pas de tenir compte du fonctionnement de votre tunnel de paiement lorsque vous choisissez l’une des options suivantes :

| Option d’intégration                                                      | Tunnel de paiement                                                                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                              |
| ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Transmettre l’adresse e-mail d’un client au Payment Element (Recommended) | - Votre client saisit son adresse e-mail avant d’accéder à la page de paiement (lors d’une précédente étape de création de compte, par exemple).
  - Vous préférez utiliser votre propre champ de saisie de l’adresse e-mail     | Transmettez par voie programmatique l’adresse e-mail d’un client au composant Element Payment. Dans ce scénario, le client s’identifie directement auprès de Link dans le formulaire de paiement au lieu d’utiliser un composant d’interface utilisateur distinct.                                       |
| Recueillir l’adresse e-mail d’un client dans le Payment Element           | - Vos clients peuvent choisir de saisir leur adresse e-mail et de s’identifier ou de s’inscrire auprès de Link directement dans le composant Element Payment lors du paiement.
  - Aucune modification du code n’est nécessaire. | Si un client ne s’est pas inscrit auprès de Link et qu’il choisit un moyen de paiement pris en charge dans le composant Element Payment, il est invité à enregistrer ses informations à l’aide de Link. Pour ceux qui sont déjà inscrits, Link renseigne automatiquement leurs informations de paiement. |

Utilisez le paramètre [defaultValues](https://docs.stripe.com/js/elements_object/create_payment_element#payment_element_create-options-defaultValues) pour transmettre l’adresse e-mail d’un client au Payment Element.

```javascript
const paymentElement = elements.create('payment', {
  defaultValues: {
    billingDetails: {
      email: 'foo@bar.com',
    }
  },
  // Other options
});
```

Pour plus d’informations, lisez comment [créer une page de paiement personnalisée qui inclut Link](https://docs.stripe.com/payments/link/add-link-elements-integration.md).

## Accélérer le processus de paiement

Utilisez [defaultValues](https://docs.stripe.com/js/elements_object/create_payment_element#payment_element_create-options-defaultValues) pour préremplir les informations client et accélérer le paiement avec Link pour les utilisateurs. Transmettez les e-mails clients au composant Payment Element via [defaultValues.billingDetails](https://docs.stripe.com/js/elements_object/create_payment_element#payment_element_create-options-defaultValues-billingDetails).

```javascript
// Pass in defaultValues to prefill consumer information
const paymentElement = elements.create('payment', {
  defaultValues: {
    billingDetails: {
      name: 'John Doe',
      email: 'john.doe@example.com',
      address: {
        city: 'New York',
        country: 'US',
        line1: '123 Main St',
        postal_code: '10001',
        state: 'NY'
      }
    },
}});
```

## Préremplir automatiquement Link pour vos clients

Évitez à vos clients de saisir à nouveau leurs informations pour s’inscrire à Link ou s’y connecter lorsqu’ils les ont déjà fournies ailleurs sur votre page de paiement. Link inclut un outil de préremplissage qui détecte les informations client telles que l’e-mail ou le numéro de téléphone dans votre paiement, puis remplit automatiquement les champs correspondants de Link. Cette fonctionnalité encourage l’utilisation de Link et augmente la probabilité que le client finalise son paiement. Les valeurs préremplies ne sont jamais enregistrées sauf si le client finalise son inscription à Link.

Lorsqu’un client saisit des informations telles que son e-mail, son numéro de téléphone ou son nom sur la même page de paiement que le composant Element où Link est activé, l’outil de préremplissage de Link peut :

- Remplir le formulaire d’inscription à Link avec l’e-mail, le téléphone ou le nom du client. Le client doit poursuivre l’inscription à Link pour créer un compte.
- Remplir automatiquement la connexion à Link avec l’e-mail du client lorsqu’il possède déjà un compte Link, afin qu’il n’ait plus qu’à saisir le mot de passe à usage unique.

### Activer l’inscription accélérée

Si vous activez par défaut l’enregistrement des informations de paiement de vos clients dans Link, cela peut augmenter le taux d’inscription à Link. Les clients dont les informations de paiement sont enregistrées dans Link peuvent effectuer un paiement sans ressaisir leurs informations de paiement lorsqu’ils paient sur votre site.

Cette configuration développe automatiquement les champs d’inscription à Link et peut préremplir des informations telles que l’adresse e-mail et le numéro de téléphone afin de faciliter l’inscription des clients.

Cette fonctionnalité est activée par défaut et vous pouvez la configurer depuis votre page de paramètres dans **Paramètres** > **Moyens de paiement** > **Link**, ou dans les paramètres des comptes connectés. La disponibilité de cette fonctionnalité dépend du pays du client. Les lois relatives à la protection des données varient selon les juridictions. Link désactive ou limite cette fonctionnalité lorsque la réglementation locale l’exige. Les clients peuvent se désinscrire à tout moment.

### Activer l’outil de préremplissage

L’outil de préremplissage de Link ne nécessite aucune modification de votre intégration existante. Il est activé par défaut lorsque vous activez Link. Vous pouvez désactiver l’outil de préremplissage à tout moment dans les [Link paramètres](https://dashboard.stripe.com/settings/link#features) de votre Dashboard.

#### Fonctionnement

Lorsqu’un client charge une page contenant le composant Element avec Link activé et que le paramètre `defaultValue` n’a pas déjà fourni de données client Stripe, notre système analyse la page de paiement environnante afin de localiser les champs de saisie contenant des informations correspondant aux champs d’inscription ou de connexion à Link. Link recherche uniquement les informations nécessaires à la création ou à la réutilisation d’un compte Link.

Si Stripe détecte de tels champs de données, nous utilisons ces valeurs pour préremplir la connexion à Link avec l’e-mail ou pour préremplir les champs d’inscription avec les informations client nécessaires à la création d’un compte Link. Nous ne stockons pas les valeurs préremplies dans le navigateur à l’aide de cookies, de stockage local ou d’un autre service. Nous conservons ces valeurs uniquement temporairement en mémoire locale afin de les utiliser dans le contexte de la session.

Pour les utilisateurs existants de Link, nous utilisons les informations préremplies pour déclencher une connexion à Link, sans stocker aucune information provenant de la page.

Les clients qui n’ont pas encore créé de compte Link peuvent choisir d’utiliser les informations préremplies pour s’inscrire à Link. Nous ne stockons les informations préremplies que si le client effectue une action et donne son consentement pour créer un compte Link.

## Tester l’intégration

> Ne stockez pas de données d’utilisateur réelles sur des comptes *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) Link. En effet, ces données sont à considérer comme publiques étant donné que vos comptes test sont associés à votre clé publiable.

À l’heure actuelle, Link fonctionne uniquement pour les cartes de crédit, les cartes de débit et les achats effectués à partir d’un compte bancaire américain éligible. Link requiert un [enregistrement de domaine](https://docs.stripe.com/payments/payment-methods/pmd-registration.md).

Vous pouvez créer des comptes environnement de test pour Link à l’aide d’une adresse e-mail valide. Le tableau suivant répertorie les codes à usage unique acceptés par Stripe pour l’authentification des comptes environnement de test :

| Valeur                                                      | Résultat                                     |
| ----------------------------------------------------------- | -------------------------------------------- |
| Tout autre ensemble de 6 chiffres non listé ci-dessous | Opération réussie                            |
| 000001                                                      | Erreur, code non valide                      |
| 000002                                                      | Erreur, code expiré                          |
| 000003                                                      | Erreur, nombre maximal de tentatives dépassé |

### Sources de financement multiples

Dans la mesure où Stripe prend en charge des sources de financement supplémentaires, vous n’avez pas besoin de mettre à jour votre intégration. Stripe les prend en charge automatiquement avec les mêmes délais de virement de fonds et les mêmes garanties que pour les paiements par carte ou par compte bancaire.

## See also

- [Stripe Elements pour le web](https://docs.stripe.com/payments/elements.md)
- [Payment Element](https://docs.stripe.com/payments/payment-element.md)
- [Address Element](https://docs.stripe.com/elements/address-element.md)