> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# PayPal

> Acceptez les paiements et les abonnements PayPal sur votre site web.

Vous pouvez mettre en place des paiements PayPal entièrement via le chat de Lumi. Nommez PayPal dans votre demande et décrivez ce que vous voulez vendre :

* « Permets aux gens de payer mon e-book avec PayPal, 15 \$ en paiement unique. »
* « Ajoute un abonnement membre à 9,99 \$/mois facturé via PayPal. »

Avec les identifiants de votre application PayPal, Lumi travaille directement dans votre compte PayPal Business et construit tout le parcours de paiement dans votre site web :

* **Paiements uniques** : un bouton PayPal qui emmène l'acheteur sur PayPal pour approuver le paiement, puis enregistre le paiement effectué dans votre base de données.
* **Abonnements** : Lumi crée le produit et le plan d'abonnement dans votre compte PayPal (en réutilisant ceux qui existent déjà avec le même nom et le même prix), ajoute un bouton d'abonnement et tient à jour le statut de chaque abonnement.
* **Webhook** : Lumi enregistre un webhook pour que votre site web soit averti quand des paiements sont effectués ou remboursés, ou quand des abonnements sont activés, résiliés, suspendus ou ne parviennent pas à se renouveler.
* **Page de tarifs et accès réservé** : le contenu payant n'est affiché qu'aux clients qui ont payé.

Vous pouvez aussi interroger Lumi sur votre compte PayPal à tout moment, par exemple « Montre mes transactions récentes », « Liste mes plans d'abonnement », « Rembourse cette commande » ou « Résilie cet abonnement ».

> [!NOTE]
>
> PayPal est disponible pour les projets web. Si vous ne nommez pas de prestataire de paiement, Lumi utilise [Stripe](https://docs.lumi.new/fr/features/stripe.md).

## Connecter vos identifiants PayPal

**1. Créez une application REST dans PayPal**

Dans le PayPal Developer Dashboard, allez dans **Apps & Credentials** et créez ou ouvrez une application REST. Utilisez l'onglet **Sandbox** pour les tests, ou l'onglet **Live** pour les vrais paiements. Copiez le **Client ID** et la **Secret key** de l'application.

**2. Saisissez les identifiants dans Lumi**

Remplissez la carte d'identifiants PayPal que Lumi affiche dans le chat, ou ouvrez l'onglet **Outils** de votre espace de travail et cliquez sur la carte **PayPal**. Saisissez l'**ID client PayPal** et le **secret client PayPal**, choisissez l'**Environnement** (**Sandbox (test)** ou **Production**), puis cliquez sur **Enregistrer** et **Vérifier**.

> [!WARNING]
>
> Ne collez jamais vos identifiants dans un message du chat. Ils sont enregistrés en toute sécurité dans les [Secrets](https://docs.lumi.new/fr/features/secrets.md) de votre projet. Les identifiants Sandbox ne fonctionnent qu'avec l'environnement Sandbox, et les identifiants Live qu'avec la Production. Une incohérence est la raison la plus fréquente pour laquelle PayPal refuse les identifiants.

### Contrôler ce que Lumi peut modifier

Sur la carte **PayPal** de l'onglet Outils, chaque action qui modifie votre compte PayPal a un réglage d'approbation : **Toujours autoriser**, **Demander à chaque fois** ou **Ne jamais autoriser**. Par défaut, la création de produits et de plans est autorisée, tandis que les **remboursements** et la **résiliation d'abonnements** demandent votre approbation à chaque fois. Les actions en lecture seule, comme lister les transactions, sont toujours autorisées.

## Tester et passer en production

**1. Testez dans le bac à sable**

Avec des identifiants Sandbox, aucun argent réel n'est déplacé. Sur la page PayPal, connectez-vous avec un compte acheteur sandbox (PayPal Developer Dashboard → **Testing Tools** → **Sandbox Accounts** → l'e-mail et le mot de passe d'un compte Personal). Après le paiement, vérifiez que l'enregistrement du paiement ou de l'abonnement apparaît dans [Cloud → Données](https://docs.lumi.new/fr/features/databases.md) et que votre page affiche l'achat.

**2. Passez en production**

Créez une application Live dans PayPal, puis sur la carte **PayPal**, saisissez son Client ID et son Secret et réglez l'Environnement sur **Production**. Demandez à Lumi de passer en production : les produits et plans du bac à sable ne sont pas reportés, Lumi les recrée donc dans votre compte de production et enregistre de nouveau le webhook.

**3. Dernier test et lancement**

Testez une dernière fois avec un article à bas prix, puis publiez votre site web et partagez-le.

Si quelque chose ne va pas à une étape, dites-le à Lumi. Il vérifie votre compte PayPal et les journaux de vos fonctions pour trouver et corriger le problème.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.