Docs (#196)

Updated docs for LNURL pay, LNURL withdraw and Offline shop Co-authored-by: Tiago Vasconcelos <tvasconcelos@gmail.com>
2021-06-02 14:16:03 -03:00
parent ebf3dfd076
commit 7a25c8ce24
3 changed files with 101 additions and 8 deletions
@@ -1 +1,36 @@
 # Offline Shop
+
+## Create QR codes for each product and display them on your store for receiving payments Offline
+
+[![video tutorial offline shop](http://img.youtube.com/vi/_XAvM_LNsoo/0.jpg)](https://youtu.be/_XAvM_LNsoo 'video tutorial offline shop')
+
+LNBits Offline Shop allows for merchants to receive Bitcoin payments while offline and without any electronic device.
+
+Merchant will create items and associate a QR code ([a LNURLp](https://github.com/lnbits/lnbits/blob/master/lnbits/extensions/lnurlp/README.md)) with a price. He can then print the QR codes and display them on their shop. When a costumer chooses an item, scans the QR code, gets the description and price. After payment, the costumer gets a confirmation code that the merchant can validate to be sure the payment was successful.
+
+Costumers must use an LNURL pay capable wallet.
+
+[**Wallets supporting LNURL**](https://github.com/fiatjaf/awesome-lnurl#wallets)
+
+## Usage
+
+1. Entering the Offline shop extension you'll see an Items list, the Shop wallet and a Wordslist\
+   ![offline shop back office](https://i.imgur.com/Ei7cxj9.png)
+2. Begin by creating an item, click "ADD NEW ITEM"
+   - set the item name and a small description
+   - you can set an optional, preferably square image, that will show up on the costumer wallet - _depending on wallet_
+   - set the item price, if you choose a fiat currency the bitcoin conversion will happen at the time costumer scans to pay\
+     ![add new item](https://i.imgur.com/pkZqRgj.png)
+3. After creating some products, click on "PRINT QR CODES"\
+   ![print qr codes](https://i.imgur.com/2GAiSTe.png)
+4. You'll see a QR code for each product in your LNBits Offline Shop with a title and price ready for printing\
+   ![qr codes sheet](https://i.imgur.com/faEqOcd.png)
+5. Place the printed QR codes on your shop, or at the fair stall, or have them as a menu style laminated sheet
+6. Choose what type of confirmation do you want costumers to report to merchant after a successful payment\
+   ![wordlist](https://i.imgur.com/9aM6NUL.png)
+
+   - Wordlist is the default option: after a successful payment the costumer will receive a word from this list, **sequentially**. Starting in _albatross_ as costumers pay for the items they will get the next word in the list until _zebra_, then it starts at the top again. The list can be changed, for example if you think A-Z is a big list to track, you can use _apple_, _banana_, _coconut_\
+     ![totp authenticator](https://i.imgur.com/MrJXFxz.png)
+   - TOTP (time-based one time password) can be used instead. If you use Google Authenticator just scan the presented QR with the app and after a successful payment the user will get the password that you can check with GA\
+     ![disable confirmations](https://i.imgur.com/2OFs4yi.png)
+   - Nothing, disables the need for confirmation of payment, click the "DISABLE CONFIRMATION CODES"