# Guide de paiement avec Alby

Ce guide vous explique comment payer pour débloquer des articles avec Alby et le protocole Lightning Network.

## Qu'est-ce qu'Alby ?

[Alby](https://getalby.com/) est une extension de navigateur qui permet de gérer des paiements Lightning Network directement depuis votre navigateur. Alby utilise le standard WebLN pour interagir avec les applications web.

## Installation d'Alby

### 1. Télécharger Alby

1. Visitez [getalby.com](https://getalby.com/)
2. Cliquez sur **"Get Alby"** ou **"Install Extension"**
3. Choisissez votre navigateur :
   - Chrome / Edge
   - Firefox
   - Brave
   - Safari (via l'App Store)

### 2. Installer l'extension

1. Suivez les instructions d'installation pour votre navigateur
2. L'extension Alby apparaîtra dans la barre d'outils de votre navigateur
3. Cliquez sur l'icône Alby pour commencer la configuration

### 3. Configurer Alby

#### Option A : Créer un nouveau compte Alby

1. Cliquez sur l'icône Alby dans votre navigateur
2. Cliquez sur **"Create Account"** ou **"Sign Up"**
3. Suivez les instructions pour créer un compte
4. Ajoutez des fonds à votre portefeuille Alby :
   - Par carte bancaire
   - Par virement bancaire
   - Par Lightning Network (depuis un autre portefeuille)

#### Option B : Connecter un portefeuille Lightning existant

1. Cliquez sur l'icône Alby
2. Choisissez **"Connect Wallet"** ou **"Link Existing Wallet"**
3. Suivez les instructions pour connecter votre portefeuille Lightning (LND, CLN, etc.)

### 4. Vérifier l'installation

1. Revenez sur Nostr Paywall
2. Si Alby est correctement installé, vous verrez un message de confirmation
3. Si Alby n'est pas installé, un message vous invitera à l'installer

## Payer pour un article

### Processus étape par étape

#### 1. Choisir un article

1. Parcourez la liste des articles sur la page d'accueil
2. Lisez l'aperçu gratuit
3. Si vous souhaitez lire le contenu complet, cliquez sur **"Unlock Article"** ou **"Pay {amount} sats"**

#### 2. Fenêtre de paiement

Une fenêtre modale s'ouvre avec :
- **Montant à payer** : Le prix en sats
- **QR Code Lightning** : Pour scanner avec un portefeuille mobile
- **Invoice Lightning** : La facture Lightning (BOLT11)
- **Timer d'expiration** : Temps restant avant expiration (24h)
- **Bouton "Pay with Alby"** : Pour payer directement avec Alby

#### 3. Méthodes de paiement

Vous avez **3 options** pour payer :

##### Option 1 : Payer avec Alby (recommandé)

1. Cliquez sur **"Pay with Alby"**
2. Une fenêtre Alby s'ouvre automatiquement
3. Vérifiez les détails du paiement :
   - Montant
   - Description
   - Destinataire
4. Cliquez sur **"Confirm"** ou **"Pay"** dans Alby
5. Le paiement est effectué instantanément
6. La fenêtre se ferme automatiquement
7. Le contenu complet s'affiche après quelques secondes

##### Option 2 : Scanner le QR Code

1. Ouvrez votre portefeuille Lightning mobile (BlueWallet, Breez, etc.)
2. Utilisez la fonction "Scanner" de votre portefeuille
3. Scannez le QR code affiché dans la fenêtre
4. Confirmez le paiement dans votre portefeuille mobile
5. Le contenu se débloque automatiquement après confirmation

##### Option 3 : Copier l'invoice

1. Cliquez sur **"Copy Invoice"** pour copier l'invoice Lightning
2. Collez l'invoice dans votre portefeuille Lightning (n'importe lequel)
3. Confirmez le paiement
4. Le contenu se débloque automatiquement après confirmation

### 4. Confirmation du paiement

Après le paiement :
1. **Vérification automatique** : L'application vérifie le paiement via les reçus de zap Nostr (NIP-57)
2. **Délai** : La vérification peut prendre quelques secondes (généralement 5-30 secondes)
3. **Affichage du contenu** : Une fois vérifié, le contenu complet s'affiche automatiquement
4. **Stockage local** : Le contenu est stocké localement dans votre navigateur (IndexedDB)

## Expiration des invoices

### Durée de validité

- Les invoices expirent après **24 heures**
- Un timer affiche le temps restant dans la fenêtre de paiement
- Si l'invoice expire, elle devient invalide

### Que faire si l'invoice expire ?

1. **Fermez la fenêtre de paiement**
2. **Cliquez à nouveau sur "Unlock Article"**
3. **Une nouvelle invoice sera générée** automatiquement
4. **Payez la nouvelle invoice**

> **Note** : Ne payez jamais une invoice expirée, le paiement échouera.

## Dépannage

### Alby ne s'ouvre pas

**Solutions** :
- Vérifiez que Alby est bien installé
- Rafraîchissez la page
- Vérifiez que l'extension Alby est activée dans votre navigateur
- Réessayez de cliquer sur "Pay with Alby"

### Le paiement échoue

**Vérifiez** :
- ✅ Que vous avez suffisamment de fonds dans Alby
- ✅ Que l'invoice n'a pas expiré
- ✅ Votre connexion internet
- ✅ Les logs d'erreur dans la console du navigateur

**Solutions** :
- Ajoutez des fonds à votre portefeuille Alby
- Générez une nouvelle invoice (fermez et rouvrez la fenêtre)
- Réessayez le paiement

### Le contenu ne se débloque pas après le paiement

**Vérifiez** :
- ✅ Que le paiement a bien été effectué (vérifiez dans Alby)
- ✅ Attendez quelques secondes (la vérification peut prendre du temps)
- ✅ Rafraîchissez la page

**Solutions** :
- Attendez 30-60 secondes pour la vérification
- Rafraîchissez la page
- Vérifiez vos notifications (badge en haut à droite)
- Contactez l'auteur de l'article si le problème persiste

### Je n'ai pas assez de fonds

**Solutions** :
- Ajoutez des fonds à votre portefeuille Alby :
  - Par carte bancaire
  - Par virement bancaire
  - Par Lightning Network (depuis un autre portefeuille)
- Attendez que les fonds soient disponibles
- Réessayez le paiement

### L'invoice a expiré

**Solutions** :
- Fermez la fenêtre de paiement
- Cliquez à nouveau sur "Unlock Article"
- Une nouvelle invoice sera générée
- Payez la nouvelle invoice

## Sécurité

### Les paiements sont-ils sécurisés ?

Oui, les paiements Lightning Network sont :
- ✅ **Décentralisés** : Pas de serveur central
- ✅ **Rapides** : Confirmations en quelques secondes
- ✅ **Peu coûteux** : Frais minimes
- ✅ **Vérifiables** : Vérifiés via les reçus de zap Nostr (NIP-57)

### Mes informations sont-elles partagées ?

- ✅ **Non** : Les paiements Lightning sont privés
- ✅ Seul le montant et le destinataire sont visibles sur la blockchain Lightning
- ✅ Votre identité Nostr n'est pas liée à vos paiements Lightning (sauf via les zap receipts)

### Puis-je obtenir un remboursement ?

Les paiements Lightning sont généralement **irréversibles**. Si vous avez un problème :
1. Vérifiez que le paiement a bien été effectué
2. Contactez l'auteur de l'article
3. Vérifiez que le contenu ne s'est pas débloqué (attendez quelques secondes)

## Alternatives à Alby

### Autres portefeuilles WebLN

Si vous préférez ne pas utiliser Alby, vous pouvez utiliser d'autres portefeuilles Lightning compatibles WebLN :
- **Breez** (si support WebLN)
- **Zeus** (si support WebLN)
- Autres portefeuilles compatibles

### Portefeuilles mobiles

Vous pouvez également utiliser un portefeuille Lightning mobile :
1. Scannez le QR code avec votre portefeuille mobile
2. Confirmez le paiement
3. Le contenu se débloque automatiquement

**Portefeuilles mobiles populaires** :
- BlueWallet
- Breez
- Zeus
- Wallet of Satoshi

## Conseils

### Gérer vos fonds

- Gardez suffisamment de fonds dans Alby pour plusieurs articles
- Ajoutez des fonds régulièrement pour éviter les interruptions
- Surveillez votre solde dans l'extension Alby

### Paiements multiples

- Vous pouvez payer pour plusieurs articles en succession
- Chaque paiement est indépendant
- Le contenu de chaque article est stocké séparément

### Contenu débloqué

- Le contenu débloqué est stocké localement dans votre navigateur
- Il reste accessible même après déconnexion
- Si vous videz le cache, le contenu peut être perdu (vous devrez peut-être payer à nouveau)

---

**Dernière mise à jour** : Décembre 2024