story-research-zapwall/docs/payment-guide.md

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 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
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