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

Guide de paiement avec Alby

Ce guide vous explique comment effectuer un zap pour débloquer des publications avec Alby et le protocole Lightning Network.

Important

: Seuls les zaps sont autorisés pour débloquer les publications. Les paiements Lightning standard ne fonctionnent pas.

Qu'est-ce qu'Alby ?

Alby est une extension de navigateur qui permet de gérer des zaps 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 zapwall.fr
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

Effectuer un zap pour une publication

Processus étape par étape

1. Choisir une publication

1. Parcourez la liste des publications sur la page d'accueil
2. Lisez l'aperçu gratuit
3. Si vous souhaitez lire le contenu complet, cliquez sur "Débloquer"

2. Fenêtre de zap

Une fenêtre modale s'ouvre avec :

• Montant du zap : 800 sats (montant fixe)
• 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 zap

Vous avez 3 options pour effectuer le zap :

Important

: Seuls les zaps sont autorisés pour débloquer les publications. Les paiements Lightning standard ne fonctionnent pas.

Option 1 : Zap avec Alby (recommandé)

1. Cliquez sur "Pay with Alby"
2. Une fenêtre Alby s'ouvre automatiquement
3. Vérifiez les détails du zap :
   • Montant (800 sats)
   • Description
   • Destinataire
4. Cliquez sur "Confirm" ou "Pay" dans Alby
5. Le zap 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 zap 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. Effectuez le zap
4. Le contenu se débloque automatiquement après confirmation

4. Confirmation du zap

Après le zap :

1. Vérification automatique : L'application vérifie le zap 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 zap
• Si l'invoice expire, elle devient invalide

Que faire si l'invoice expire ?

1. Fermez la fenêtre de zap
2. Cliquez à nouveau sur "Débloquer"
3. Une nouvelle invoice sera générée automatiquement
4. Effectuez le zap avec la nouvelle invoice

Note

: N'effectuez jamais un zap avec une invoice expirée, le zap échouera.

Commissions et montants

Montant d'une publication

• Montant total : 800 sats
• À l'auteur : 700 sats
• Commission plateforme : 100 sats
• Frais de transaction : Payés par l'auteur

Montant du sponsoring

• Montant total : 0.046 BTC
• À l'auteur : 0.042 BTC
• Commission plateforme : 0.004 BTC
• Frais de transaction : Payés par l'auteur

Montant d'un remerciement d'avis

• Montant total : 70 sats
• Au reviewer : 49 sats
• Commission plateforme : 21 sats
• Frais de transaction : Payés par l'auteur

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 zap é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
• ✅ Que vous effectuez bien un zap (pas un paiement Lightning standard)

Solutions :

• Ajoutez des fonds à votre portefeuille Alby
• Générez une nouvelle invoice (fermez et rouvrez la fenêtre)
• Réessayez le zap
• Assurez-vous d'effectuer un zap via Nostr, pas un paiement Lightning standard

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

Vérifiez :

• ✅ Que le zap a bien été effectué (vérifiez dans Alby)
• ✅ Attendez quelques secondes (la vérification peut prendre du temps)
• ✅ Rafraîchissez la page
• ✅ Que le zap a bien été vérifié via les reçus de zap Nostr

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 la publication 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 zap

L'invoice a expiré

Solutions :

• Fermez la fenêtre de zap
• Cliquez à nouveau sur "Débloquer"
• Une nouvelle invoice sera générée
• Effectuez le zap avec la nouvelle invoice

Sécurité

Les zaps sont-ils sécurisés ?

Oui, les zaps 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)
• ✅ Seule méthode autorisée : Seuls les zaps fonctionnent pour débloquer les publications

Mes informations sont-elles partagées ?

• ✅ Non : Les zaps Lightning sont privés
• ✅ Seul le montant et le destinataire sont visibles sur la blockchain Lightning
• ✅ Votre identité Nostr est liée aux zaps via les zap receipts (NIP-57)

Puis-je obtenir un remboursement ?

Les zaps Lightning sont généralement irréversibles. Si vous avez un problème :

1. Vérifiez que le zap a bien été effectué
2. Contactez l'auteur de la publication
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 zap
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 publications
• Ajoutez des fonds régulièrement pour éviter les interruptions
• Surveillez votre solde dans l'extension Alby

Zaps multiples

• Vous pouvez effectuer des zaps pour plusieurs publications en succession
• Chaque zap est indépendant
• Le contenu de chaque publication 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